*此内容使用人工智能（Beta）翻译，可能包含错误。若要查看英文页面，请点按 此处。

AssetQuota

代表资产相关操作的配额。

例如，用户可能每月能上传 100 个音频文件，已上传 15 个。在这个例子中：

  • quotaType is RATE_LIMIT_UPLOAD
  • assetType is AUDIO
  • usage is 15
  • capacity is 100
  • 表示新时段开始时间和使用重置为 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>

属于配额的资产类型。

可能的值：

| 值 | 描述 | | --- | --- | | ASSET_TYPE_UNSPECIFIED | 默认资产类型。 图像处理 | Chinese: 图像处理 | English: 文本地图 | Python: 文本地图 |. 可能的值：

usagenumber

当前使用配额的情况。.

capacitynumber

配额的容量。.

periodEnum<string>

配额的有效期。

可能的值：

| 值 | 描述 | | --- | --- | | PERIOD_UNSPECIFIED | 无效的默认期间。指定另一个值。| | 月 | 月 | | 天 | 天 |. 可能的值：

usageResetTimestring

使用时间将重置到此配额。. 此字符串格式为 FieldMask。

基本网址
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
限制
  • API 密钥: 60 requests per minute across all API keys for a user or group
  • OAuth2: 60 requests per minute per app user

Note: Rate limits can be lower during high-traffic periods. Certain endpoints have additional rate limits. Learn more about rate limits.

请求路径参数
user_idstring
必填

用户ID。.

查询参数
maxPageSizenumber

要返回的最大资产配额数量。服务可能返回小于此值。如果未指定，最多返回 10 个资产配额。最大值为 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"

}