*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

AssetQuota

Représente une quote-part pour une action liée à une ressource.

Par exemple, un utilisateur pourrait être en mesure de télécharger 100 fichiers audio par mois et en avoir déjà téléchargé 15. Dans cet exemple :

  • quotaType is RATE_LIMIT_UPLOAD
  • assetType is AUDIO
  • usage is 15
  • capacity is 100
  • period est MONTH``usageResetTime indique quand une nouvelle période commence et l'utilisation se réinitialise à 0.Cette valeur ne correspond pas nécessairement au premier jour d'un mois calendaire ou à minuit un jour donné.Pour plus d'informations sur le processus de téléchargement, voir le guide d'utilisation.

Attributs

pathstring

Le chemin de ressource du quota de ressources.

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

quotaTypeEnum<string>

Type de quote-part.

Valeurs possibles :

| Valeur | Description | | --- | --- | | QUOTA_TYPE_UNSPECIFIED | Le type de quota par défaut.| | RATE_LIMIT_UPLOAD | Limite de vitesse sur la fréquence à laquelle on peut télécharger une ressource.| | RATE_LIMIT_CREATOR_STORE_DISTRIBUTE | Limite de vitesse sur la fréquence à laquelle on peut distribuer une ressource sur la boutique des créateurs. |. Valeurs possibles :

assetTypeEnum<string>

Le type de ressource auquel le quota est destiné.

Valeurs possibles :

| Valeur | Description | | --- | --- | | ASSET_TYPE_UNSPECIFIED | Le type de ressource par défaut. image/image/image/image/image/image/image/image/image/image/image/image/image/image/image/image/image/image/image/image/image/image/image/image |. Valeurs possibles :

usagenumber

L'utilisation actuelle du quota.

capacitynumber

La capacité du quota.

periodEnum<string>

La période de temps pour laquelle le quota est valable.

Valeurs possibles :

| Valeur | Description | | --- | --- | | PERIOD_UNSPECIFIED | La période par défaut, qui est invalide.Spécifiez une autre valeur.| | MOIS | Mois | | JOUR | Jour |. Valeurs possibles :

usageResetTimestring

Le temps d'utilisation sera réinitialisé pour ce quota. Ce string est formatée en tant que Timestamp.

URL de base
https://apis.roblox.com
La ressource 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

Liste des quotas de ressources
Bêta

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

Renvoie une liste de quotas de ressources.

Périmètres d'application
asset:read
Limitations
  • Clés API: 60 requêtes par minute pour toutes les clés API pour un utilisateur ou un groupe
  • OAuth 2.0: 60 requêtes par minute par utilisateur de l'application

Remarque : les limites de débit peuvent être plus basses pendant les périodes de fort trafic. Certains points d'extrémité ont des limites de débit supplémentaires. En savoir plus sur les limites de taux.

RequêteParamètres du chemin
user_idstring
Requis

L'ID utilisateur.

Paramètres de requête
maxPageSizenumber

Le nombre maximum de quotas de ressources à retourner.Le service peut retourner moins que cette valeur.Si non spécifié, au maximum 10 quotas de ressources sont renvoyés.La valeur maximale est de 100 et les valeurs plus élevées sont réglées sur 100.

pageTokenstring

Un jeton de page, reçu d'un appel précédent, pour récupérer une page suivante.

Lors de la pagination, tous les autres paramètres fournis à l'appel suivant doivent correspondre à l'appel qui a fourni le jeton de page.

filterstring

Ce champ peut être défini afin de filtrer les ressources renvoyées.

Il prend en charge la sous-ensemble suivant de CEL :

  • Seuls les champs quotaType et assetType sont pris en charge.
  • Seul l'opérateur == et && est pris en charge.

Par exemple : quotaType == RateLimitUpload && assetType == Audio.

Réponse

Une liste de quotas de ressources dans la collection parent.

assetQuotasarray<AssetQuota>

Les quotas de ressources de l'utilisateur spécifié.

nextPageTokenstring

Un jeton que vous pouvez envoyer en tant que pageToken paramètre pour récupérer la page suivante. Si ce champ est omis, il n'y a pas de pages suivantes.

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}'
Réponse
{

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

}