Skip to main content

Limites - Economy (V2)

Economy v2 est désormais en disponibilité générale. Pour obtenir de l’aide et donner votre avis, rendez-vous sur le forum PlayFab.
L’objectif de ce guide est de détailler les limites appliquées lors de la création, de la mise à jour et de la lecture de votre catalogue d’objets, ainsi que lors de l’ajout, de la mise à jour et de la suppression d’objets dans les inventaires des joueurs. Il inclut désormais les limites les plus récentes d’Economy (V2).
  • Limite (joueur) s’applique lorsque l’entité ciblée est un joueur.
  • Limite (titre) s’applique lorsque l’entité ciblée est un titre.
Toutes les API sont comptabilisées séparément les unes des autres.

Limitation du catalogue

Lecture

Écriture/Gestion

Limitation de l’inventaire

  • La limitation de l’inventaire est calculée en fonction de l’entité cible, individuellement pour chaque API. - Par exemple, si un joueur ou un titre (service de jeu, CloudScript, etc.) appelle une API Inventory pour mettre à jour l’inventaire de l’entité joueur, la limitation Limite (joueur) est appliquée. - Les inventaires d’entités de groupe sont également pris en charge, et les entités de groupe partagent le même taux de limitation que les entités joueur. Consultez également Groupes.

Lecture

Lecture de l’historique des transactions

Écriture

Échange

Limites des API

Taille du contenu binaire

La taille de fichier maximale autorisée est de 500 Mo.

Quantité de contenu binaire

Jusqu’à 100 images et 100 fichiers peuvent être ajoutés à un objet.
  • Les fichiers ne font l’objet d’aucune restriction.
  • Les images ne peuvent être chargées qu’aux formats de fichier .png, .jpg, .gif ou .bmp.

CreateUploadsUrls

Les blobs/URL de contenu sont supprimés par le nettoyage de la mémoire après 24 heures s’ils ne sont pas attachés à un objet brouillon ou publié.

Taille de page maximale du catalogue

Voici le nombre maximal d’objets renvoyés par les différentes API. Vous pouvez utiliser des jetons de continuation pour parcourir les résultats qui dépassent la limite.
  • SearchItems - 50 objets par page
  • GetItems - 50 objets par page
  • GetItemReviews - 50 objets par page
  • GetItemContainers - 50 objets par page
  • GetEntityDraftItems - 50 objets par page

Taille de page par défaut du catalogue

  • SearchItems - 10 objets par page
  • GetItems - 10 objets par page
  • GetItemReviews - 10 objets par page
  • GetItemContainers - 10 objets par page
  • GetDraftItems - 10 objets par page
  • GetEntityDraftItems - 10 objets par page

Taille de page maximale de l’inventaire

Voici le nombre maximal d’objets renvoyés par les différentes API. Vous pouvez utiliser des jetons de continuation pour parcourir les résultats qui dépassent la limite.

Taille de page par défaut de l’inventaire

  • GetInventoryItems - 10 objets par page
  • GetInventoryCollectionIds - 10 objets par page
  • GetTransactionHistory - 10 objets par page

Complexité des filtres de recherche

Des vérifications sont appliquées pour empêcher l’utilisation de requêtes Filter trop complexes dans les appels SearchItems. Vous trouverez plus d’informations ici.

Objet de catalogue

Limite par entité créatrice de catalogue

Jusqu’à 20 Go de données de catalogue sont autorisés par entité créatrice de catalogue. Cette limite est le plus souvent atteinte pour les objets de catalogue créés par l’entité de titre.

Titres

Les titres sont limités à 512 caractères par code de pays.

Descriptions

Les descriptions sont limitées à 10000 caractères par code de pays.

Mots clés

Les mots clés sont limités à 50 caractères par mot clé, et jusqu’à 32 mots clés peuvent être ajoutés par code de pays.

Propriétés d’affichage

Le champ Display Properties est limité à 10000 octets.

Balises

Les balises sont limitées à 32 caractères par balise. Les titres peuvent avoir au maximum 1024 balises et jusqu’à 32 balises peuvent être ajoutées à un objet

Types de contenu

Les types de contenu sont limités à 32 caractères par type de contenu. Les titres peuvent avoir au maximum 128 types de contenu.

PricesOptions

La liste des options de prix est limitée à 15 options de prix.

Amounts

La liste des quantités est limitée à 15 quantités.

UnitDurationInSeconds

La durée unitaire est limitée à 100 ans (3 155 695 200 secondes).

AlternateIds

Chaque ID alternatif a une longueur de valeur limitée à 100 caractères. La liste des ID alternatifs est limitée à 15 ID alternatifs.

DisplayVersion

Le champ de version d’affichage a une longueur de valeur limitée à 50 caractères.

ClientVersion

La version du client est limitée à 3 segments, chaque segment acceptant une valeur maximale de 65535.
Par exemple : “1.65535.234”.

ItemReferences

Le champ ItemReferences est limité à 250 objets.

Configuration du catalogue

AdminEntities

La liste des entités administratrices est limitée à 64 entités.

ReviewerEntities

La liste des entités administratrices est limitée à 128 entités.

Liens profonds

Le nombre maximal de liens profonds est de 10 liens.

DisplayPropertyIndexInfo

La limite est de 5 valeurs par type de propriété d’affichage.

Types de contenu

La liste des types de contenu est limitée à 128 types, chacun d’une longueur maximale de 40 caractères.

Plateformes

La liste des plateformes est limitée à 128 plateformes, chacune d’une longueur maximale de 40 caractères.

Balises

La liste des balises est limitée à 1024 balises, chacune d’une longueur maximale de 32 caractères.

Inventaire du joueur

Opérations par lots

Le nombre maximal d’opérations d’inventaire à exécuter est de 50 opérations. Le nombre maximal d’objets à modifier est de 300 objets.
(par exemple, vous pouvez ajouter un lot complet et jusqu’à 50 autres objets)

Collections d’inventaire

La taille maximale d’une collection est de 10000 objets. La liste des collections est limitée à 1000 collections par entité. Le nom d’une collection est limité à 75 caractères.

Historique des transactions

La plage de dates maximale de l’historique des transactions est de 4 ans. La plage de dates par défaut est de six mois.

Objet d’inventaire

Propriétés d’affichage

Le champ Display Properties est limité à 1000 octets.
Last modified on October 6, 2026