*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

AssetQuota

Representa uma cota para uma ação relacionada a um recurso.

Por exemplo, um usuário pode ser capaz de carregar 100 arquivos de áudio por mês e já ter carregado 15. Neste exemplo:

  • quotaType is RATE_LIMIT_UPLOAD
  • assetType is AUDIO
  • usage is 15
  • capacity is 100
  • period é MONTH``usageResetTime indica quando um novo período começa e o uso é redefinido para 0.Esse valor não necessariamente se correlaciona com o primeiro dia de um mês de calendário ou meia-noite em um determinado dia.Para mais informações sobre o processo de upload, veja o guia de uso.

Atributos

pathstring

O caminho de recursos da cota de recursos.

Formato: users/{user_id}/asset-quotas/{asset_quota_id}.

quotaTypeEnum<string>

Tipo de quota.

Valores possíveis:

| Valor | Descrição | | --- | --- | | QUOTA_TYPE_UNSPECIFIED | O tipo de quota padrão.| | RATE_LIMIT_UPLOAD | Limite de taxa sobre quantas vezes um usuário pode carregar um recurso.| | RATE_LIMIT_CREATOR_STORE_DISTRIBUTE | Limite de taxa sobre com que frequência pode-se distribuir um recurso na Loja do Criador. |. Valores possíveis:

assetTypeEnum<string>

O tipo de recurso para o qual a quota é.

Valores possíveis:

| Valor | Descrição | | --- | --- | | ASSET_TYPE_UNSPECIFIED | O tipo de recurso padrão.api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api:api. Valores possíveis:

usagenumber

O uso atual da quota.

capacitynumber

A capacidade da cota.

periodEnum<string>

O período de tempo para o qual a quota é.

Valores possíveis:

| Valor | Descrição | | --- | --- | | PERIOD_UNSPECIFIED | O período padrão, que é inválido.Especifique outro valor.| | MÊS | Mês | | DIA | Dia |. Valores possíveis:

usageResetTimestring

O tempo de uso será redefinido para essa cota. Esta cadeia de caracteres é formatada como um Timestamp.

URL base

https://apis.roblox.com
O recurso 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

Listar quotas de recursos
Beta

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

Retorna uma lista de quotas de recursos.

Escopos
asset:read
SolicitaçãoParâmetros de endereço
user_idstring
Obrigatório

O ID do usuário.

Parâmetros da consulta
maxPageSizenumber

O número máximo de quotas de recursos a retornar.O serviço pode retornar menos que esse valor.Se não especificado, no máximo 10 quotas de recursos são retornadas.O valor máximo é 100 e valores mais altos são definidos como 100.

pageTokenstring

Um token de página, recebido de uma chamada anterior, para recuperar uma página posterior.

Ao paginar, todos os outros parâmetros fornecidos à chamada posterior devem corresponder à chamada que forneceu o token da página.

filterstring

Este campo pode ser definido para filtrar os recursos retornados.

Suporta o seguinte subconjunto do CEL:

  • Apenas os campos quotaType e assetType são suportados.
  • Apenas o operador == e && são suportados.

Por exemplo: quotaType == RateLimitUpload && assetType == Audio.

Resposta

Uma lista de AssetQuotas na coleção pai.

assetQuotasarray<AssetQuota>

As quotas de recursos do usuário especificado.

nextPageTokenstring

Um token que você pode enviar como um parâmetro pageToken para recuperar a próxima página. Se este campo for omitido, não há páginas subsequentes.

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

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