*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

AssetQuota

代表與資產相關的行動的配額。

例如，使用者可能每個月可上傳 100 個音頻文件，已上傳 15 個。在這個例子中：

quotaType is RATE_LIMIT_UPLOAD
assetType is AUDIO
usage is 15
capacity is 100
period 是 MONTH``usageResetTime 指示新期間開始和使用重置到 0。這個值不一定與日曆月的第一天或特定日期午夜相關。有關上傳過程的更多資訊，請參閱使用指南。

特性

pathstring

資產配額的資源路徑。

格式：users/{user_id}/asset-quotas/{asset_quota_id}.

quotaTypeEnum<string>

配額類型。

可能的值：

| 值 | 說明 | | --- | --- | | QUOTA_TYPE_UNSPECIFIED | 預設配額類型。| | RATE_LIMIT_UPLOAD | 上傳資產的頻率限制。| | RATE_LIMIT_CREATOR_STORE_DISTRIBUTE | 創作者商店上分發資產的頻率限制。 |. 可能的值：

assetTypeEnum<string>

配額的資產類型。

可能的值：

| 值 | 說明 | | --- | --- | | 資產類型未指定 | 預設資產類型。檔案存檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔案檔 |. 可能的值：

usagenumber

目前使用配額的情況。.

capacitynumber

額度的容量。.

periodEnum<string>

配額的時間期限。

可能的值：

| 值 | 說明 | | --- | --- | | 期限_未指定 | 無效的預設期間。指定另一個值。| | 月 | 月 | | 天 | 天 |. 可能的值：

usageResetTimestring

使用時間將重置到此額度的時間。. 此字串的格式為 Timestamp。

基本網址

https://apis.roblox.com

AssetQuota資源

{
  "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

列出資產額度
Beta

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

返回一個資產配額列表。

範圍

asset:read

請求路徑參數

user_idstring

需要

使用者ID。.

查詢參數

maxPageSizenumber

要返回的最大資產額度。服務可能會返回少於此值。如果未指定，最多只返回 10 個資產額度。最大值為 100，高於 100 的值設為 100。.

pageTokenstring

從以前的呼叫中收到的頁面代幣，用於取回後續頁面。

當頁面分頁時，所有其他參數提供給後續呼叫的頁面代幣必須與提供頁面代幣的呼叫匹配。.

filterstring

此欄位可設為過濾返回的資源。

支持以下子集的 CEL：

只有 quotaType 和 assetType 欄位被支持。
只支持 == 和 && 運作器。

例如：quotaType == RateLimitUpload && assetType == Audio.

回應

父集合中的資產額度列表。

assetQuotasarray<AssetQuota>

指定使用者的資產額度。.

nextPageTokenstring

您可以將其作為pageToken參數發送到回收下一頁的代幣。如果此欄位被忽略，就沒有後續頁面。.

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}'

回應

{
  "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"
}

AssetQuota

特性

AssetQuota

列出資產額度Beta

列出資產額度
Beta