*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

AssetQuota

Bir varlıkla ilgili eylem için bir kontenjanı temsil eder.

Örneğin, bir kullanıcı ayda 100 ses dosyası yükleyebilir ve zaten 15 tane yükledi. Bu örnekte:

  • quotaType is RATE_LIMIT_UPLOAD
  • assetType is AUDIO
  • usage is 15
  • capacity is 100
  • period yeni bir dönem başladığında ve kullanım sıfırlandığında MONTH``usageResetTime gösterir, yeni bir dönem başladığında ve kullanım sıfırlandığında.Bu değer mutlaka bir takvim ayının ilk günüyle veya belirli bir günün gece yarısıyla eşleşmez .Yükleme süreci hakkında daha fazla bilgi için kullanım kılavuzu 'a bakın.

Nitelikler

pathstring

Varlık kotasının kaynak yolu.

Biçim: users/{user_id}/asset-quotas/{asset_quota_id}.

quotaTypeEnum<string>

Kota türü.

Olası değerler:

| Değer | Açıklama | | --- | --- | | QUOTA_TYPE_UNSPECIFIED | Varsayılan kota türü.| | RATE_LIMIT_UPLOAD | Bir varlığı ne sıklıkla yükleyebileceğiniz konusunda oran sınırı.| | RATE_LIMIT_CREATOR_STORE_DISTRIBUTE | Yaratıcı Mağazasında bir varlığı ne sıklıkla dağıtabileceğiniz konusunda oran sınırı. |. Olası değerler:

assetTypeEnum<string>

Kota için olan varlık türü.

Olası değerler:

| Değer | Açıklama | | --- | --- | | ASSET_TYPE_UNSPECIFIED | Varsayılan varlık türü. IMAGE | Gözamanınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınınının. Olası değerler:

usagenumber

Kota'nın mevcut kullanımı.

capacitynumber

Kota kapasitesi.

periodEnum<string>

Kota için olan süre dönemi.

Olası değerler:

| Değer | Açıklama | | --- | --- | | PERIOD_UNSPECIFIED | Geçersiz olan varsayılan dönem.Başka bir değer belirtin.| | AY | Aylık | | GÜN | Gün |. Olası değerler:

usageResetTimestring

Kullanımın bu kota için sıfırlanacağı süre. Bu dizi Timestamp olarak biçimlendirilmiş.

Taban URL

https://apis.roblox.com
AssetQuota Kaynağı

{
"path": "users/123/asset-quotas/some-asset-quota",
"quotaType": "QUOTA_TYPE_UNSPECIFIED",
"assetType": "ASSET_TYPE_UNSPECIFIED",
"usage": "integer",
"capacity": "integer",
"period": "PERIOD_UNSPECIFIED",
"usageResetTime": "2023-07-05T12:34:56Z"
}

AssetQuota

Varlık Oranlarını Listele
Beta

GET /cloud/v2/users/{user_id}/asset-quotas

Bir varlık kotası listesi döndürür.

Kapsamlar
asset:read
TalepYol Parametreleri
user_idstring
Gerekli

Kullanıcı kimliği.

Sorgu Parametreleri
maxPageSizenumber

Geri döndürülecek maksimum varlık kotası sayısı.Hizmet bu değerden daha azını iade edebilir.Belirtilmediğinde, en fazla 10 varlık kotası döndürülür.Maksimum değer 100'dür ve daha yüksek değerler 100 olarak ayarlanır.

pageTokenstring

Bir önceki çağrıdan alınan bir sayfa jetonu, sonraki bir sayfa almak için.

Sayfa numaralandırırken, sonraki çağrıya verilen tüm diğer parametler, sayfa jetonu sağlayan çağrıya eşleşmelidir.

filterstring

Bu alan, döndürülen kaynakları filtrelemek için ayarlanabilir.

CEL'in aşağıdaki alt kümesini destekler:

  • Sadece quotaType ve assetType alanları desteklenir.
  • Sadece == ve && operatörleri desteklenir.

Örneğin: quotaType == RateLimitUpload && assetType == Audio.

Yanıt

Ebeveyn koleksiyonundaki AssetQuotas listesi.

assetQuotasarray<AssetQuota>

Belirtilen Kullanıcıdan Gelen Varlık Oranları.

nextPageTokenstring

Bir sonraki sayfayı almak için bir pageToken çözümleyici olarak gönderebileceğiniz bir jeton. Bu alan atlanırsa, sonraki sayfalar yoktur.

GET /cloud/v2/users/{user_id}/asset-quotas

curl -L -X GET 'https://apis.roblox.com/cloud/v2/users/{user_id}/asset-quotas?maxPageSize=10&pageToken={string}&filter={string}' \
-H 'x-api-key: {your-api-key}'
Yanıt

{
"assetQuotas": [
{
"path": "users/123/asset-quotas/some-asset-quota",
"quotaType": "QUOTA_TYPE_UNSPECIFIED",
"assetType": "ASSET_TYPE_UNSPECIFIED",
"usage": "integer",
"capacity": "integer",
"period": "PERIOD_UNSPECIFIED",
"usageResetTime": "2023-07-05T12:34:56Z"
}
],
"nextPageToken": "string"
}