Grenzwerte – Wirtschaft (V2)
Wichtig
Economy v2 ist jetzt allgemein verfügbar. Unterstützung und Feedback erhalten Sie im PlayFab-Forum.
In diesem Leitfaden werden die Einschränkungen beschrieben, die beim Erstellen, Aktualisieren und Lesen aus Ihrem Katalog von Elementen sowie beim Hinzufügen, Aktualisieren und Entfernen aus Spielerbeständen erzwungen werden. Es enthält jetzt die am meisten aktualisierten Grenzwerte gemäß Economy (V2).
- Limit (Player) bezieht sich auf, wenn die Zielentität ein Spieler ist.
- Limit (Title) bezieht sich auf, wenn die Zielentität ein Titel ist.
Notiz
Alle APIs werden getrennt voneinander gezählt.
Katalogdrosselung
Lesen
| API | Limit (Spieler) | Limit (Titel) |
|---|---|---|
| GetItem | 1,67 rps (100 in 60 Sekunden) | 1000 rps (10000 in 10 Sekunden) |
| GetItems | 1,67 rps (100 in 60 Sekunden) | 1000 rps (10000 in 10 Sekunden) |
| SearchItems | 1,67 rps (100 in 60 Sekunden) | 1000 rps (10000 in 10 Sekunden) |
| GetItemReviews | 1,67 rps (100 in 60 Sekunden) | 1000 rps (10000 in 10 Sekunden) |
| GetItemReviewsSummary | 1,67 rps (100 in 60 Sekunden) | 1000 rps (10000 in 10 Sekunden) |
| GetEntityItemReview | 1,67 rps (100 in 60 Sekunden) | 1000 rps (10000 in 10 Sekunden) |
| GetItemModerationState | - | 1000 rps (10000 in 10 Sekunden) |
Schreiben/Verwalten
| API | Limit (Spieler) | Limit (Titel) |
|---|---|---|
| CreateDraftItem | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| CreateUploadUrls | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| DeleteEntityItemReviews | - | 100 rps (1000 in 10 Sekunden) |
| DeleteItem | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| GetDraftItem | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| GetDraftItems | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| GetEntityDraftItems | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| GetItemPublishStatus | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| PublishDraftItem | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| ReportItem | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| ReportItemReview | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| ReviewItem | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| SetItemModerationState | - | 100 rps (1000 in 10 Sekunden) |
| SubmitItemReviewVote | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
| TakedownItemReviews | - | 100 rps (1000 in 10 Sekunden) |
| UpdateDraftItem | 0,33 rps (10 in 30 Sekunden) | 100 rps (1000 in 10 Sekunden) |
Bestandsdrosselung
Notiz
- Die Bestandsdrosselung wird basierend auf der Zielentität für jede API einzeln berechnet.
- Wenn beispielsweise ein Spieler oder ein Titel (Spieledienst, Coudscript usw.) eine Bestands-API aufruft, um den Bestand der Player-Entität zu aktualisieren, wird die Limit-Drosselung (Player) angewendet.
- Gruppenentitätsbestände werden ebenfalls unterstützt, und Gruppenentitäten teilen sich die gleiche Drosselungsrate wie Player-Entitäten. Siehe auch Gruppen, Gilden und Clans.
Lesen
| API | Limit (Spieler) | Limit (Titel) |
|---|---|---|
| GetInventoryItems | 1,67 rps (100 in 60 Sekunden) | - |
| GetInventoryCollectionIds | 1,67 rps (100 in 60 Sekunden) | - |
Transaktionsverlauf lesen
| API | Limit (Spieler) | Limit (Titel) |
|---|---|---|
| GetTransactionHistory | 0,1 RPs (30 in 300 Sekunden) | - |
Schreiben
| API | Limit (Spieler) | Limit (Titel) |
|---|---|---|
| AddInventoryItems | 0,66 rps (60 in 90 Sekunden) | - |
| SubtractInventoryItems | 0,66 rps (60 in 90 Sekunden) | - |
| UpdateInventoryItems | 0,66 rps (60 in 90 Sekunden) | - |
| PurchaseInventoryItems | 0,66 rps (60 in 90 Sekunden) | - |
| TransferInventoryItems | 0,66 rps (60 in 90 Sekunden) | - |
| DeleteInventoryItems | 0,66 rps (60 in 90 Sekunden) | - |
| ExecuteInventoryOperations | 0,66 rps (60 in 90 Sekunden) | - |
| DeleteInventoryCollection | 0,16 rps (15 in 90 Sekunden) | - |
Einlösen
| API | Limit (Spieler) | Limit (Titel) |
|---|---|---|
| RedeemAppleAppStoreInventoryItems | 0,66 rps (60 in 90 Sekunden) | - |
| RedeemGooglePlayInventoryItems | 0,66 rps (60 in 90 Sekunden) | - |
| RedeemMicrosoftStoreInventorItems | 0,66 rps (60 in 90 Sekunden) | - |
| RedeemNintendoEShopInventoryItems | 0,66 rps (60 in 90 Sekunden) | - |
| RedeemPlayStationStoreInventoryItems | 0,66 rps (60 in 90 Sekunden) | - |
| RedeemSteamInventoryItems | 0,66 rps (60 in 90 Sekunden) | - |
API-Grenzwerte
Größe des binären Inhalts
Die maximal zulässige Dateigröße beträgt 500 MB.
Binärinhaltsmenge
Einem Element können bis zu 100 Bilder und 100 Dateien hinzugefügt werden.
- Für Dateien gelten keine Einschränkungen.
- Bilder können nur mit den Dateitypen .png, .jpg, .gifoder .bmp hochgeladen werden.
CreateUploadsUrls
Inhaltsblobs/URLs werden nach 24 Stunden automatisch erfasst, wenn sie nicht an einen Entwurf oder ein veröffentlichtes Element angefügt sind.
Maximale Seitengröße des Katalogs
Im Folgenden wird die maximale Anzahl von Elementen aufgeführt, die für die verschiedenen APIs zurückgegeben werden. Sie können Fortsetzungstoken verwenden, um Ergebnisse zu paginieren, die mehr als den Grenzwert zurückgeben.
-
SearchItems- 50 Elemente pro Seite -
GetItems- 50 Elemente pro Seite -
GetItemReviews- 50 Elemente pro Seite -
GetItemContainers- 50 Elemente pro Seite -
GetEntityDraftItems- 50 Elemente pro Seite
Standardseitengröße des Katalogs
-
SearchItems- 10 Elemente pro Seite -
GetItems- 10 Elemente pro Seite -
GetItemReviews- 10 Elemente pro Seite -
GetItemContainers- 10 Elemente pro Seite -
GetDraftItems- 10 Elemente pro Seite -
GetEntityDraftItems- 10 Elemente pro Seite
Maximale Seitengröße des Bestands
Im Folgenden wird die maximale Anzahl von Elementen angegeben, die für die verschiedenen APIs zurückgegeben werden. Sie können Fortsetzungstoken verwenden, um Ergebnisse zu paginieren, die den Grenzwert überschreiten.
| API | Grenzwert mit Antwortkomprimierung | Grenzwert ohne Antwortkomprimierung |
|---|---|---|
| GetInventoryItems | 250 Elemente | 50 Elemente |
| GetInventoryCollectionIds | 250 Elemente | 50 Elemente |
| GetTransactionHistory | 250 Elemente | 50 Elemente |
Standardseitengröße des Inventars
-
GetInventoryItems- 10 Elemente pro Seite -
GetInventoryCollectionIds- 10 Elemente pro Seite -
GetTransactionHistory- 10 Elemente pro Seite
Suchfilterkomplexität
Es werden Überprüfungen erzwungen, um die Verwendung von übermäßig komplizierten Filter Abfragen zu verhindern, die in SearchItems Aufrufen verwendet werden. Weitere Informationen finden Sie hier.
Katalogelement
Titel
Kacheln haben einen Grenzwert von 512 Zeichen pro Ländercode.
Beschreibungen
Beschreibungen haben einen Grenzwert von 10.000 Zeichen pro Ländercode.
Schlüsselwörter
Schlüsselwörter haben ein Limit von 50 Zeichen pro Schlüsselwort (keyword) und bis zu 32 Schlüsselwörter können pro Ländercode hinzugefügt werden.
Anzeigeeigenschaften
Das Feld Anzeigeeigenschaften hat einen Grenzwert von 10.000 Byte.
Tags
Tags haben einen Grenzwert von 32 Zeichen pro Tag. Titel können maximal 1.024 Tags enthalten, und einem Element können bis zu 32 Tags hinzugefügt werden.
Inhaltstypen
Inhaltstypen haben einen Grenzwert von 32 Zeichen pro Inhaltstyp. Titel können maximal 128 Inhaltstypen aufweisen.
PreiseOptionen
Die Liste der Preisoptionen hat eine Längenbegrenzung von 15 Preisoptionen.
Beträge
Die Liste der Beträge hat eine Längenbegrenzung von 15 Beträgen.
UnitDurationInSeconds
Die Dauer der Einheit ist auf 100 Jahre begrenzt (3.155.695.200 Sekunden).
AlternateIds
Jede alternative ID hat eine Maximale Länge von 100 Zeichen.
Die Listenlänge alternativer IDs ist auf 15 alternative IDs beschränkt.
DisplayVersion
Das Feld für die Anzeigeversion hat eine Maximale Länge von 50 Zeichen.
ClientVersion
Für die Clientversion gilt ein Grenzwert von 3 Segmenten, wobei jedes Segment einen Höchstwert von 65535 zulässt.
Beispiel: "1.65535.234".
ItemReferences
Das Feld ItemReferences hat einen Grenzwert von 250 Elementen.
Katalogkonfiguration
AdminEntities
Die Liste für Administratorentitäten weist einen Grenzwert von 64 Entitäten auf.
ReviewerEntities
Die Liste für Administratorentitäten weist einen Grenzwert von 128 Entitäten auf.
Deep Links
Die maximale Anzahl von Deep Links beträgt 10 Links.
DisplayPropertyIndexInfo
Es gibt eine Beschränkung von 5 Werten pro Anzeigeeigenschaftentyp.
Inhaltstypen
Die Liste der Inhaltstypen ist auf 128 Typen beschränkt, die jeweils maximal 40 Zeichen lang sind.
Plattformen
Die Liste der Plattformen ist auf 128 Plattformen beschränkt, die jeweils maximal 40 Zeichen lang sind.
Tags
Die Liste der Tags ist auf 1.024 Tags beschränkt, die jeweils maximal 32 Zeichen lang sind.
Spielerbestand
Batchvorgänge
Die maximale Anzahl der auszuführenden Inventurvorgänge beträgt 50 Vorgänge.
Die maximale Anzahl der zu ändernden Elemente beträgt 300 Elemente.
(Sie können z. B. ein vollständiges Bündel und bis zu 50 weitere Elemente hinzufügen)
Inventarsammlungen
Die maximale Sammlungsgröße beträgt 10.000 Elemente.
Die Längenbeschränkung für die Sammlungsliste ist unbegrenzt.
Der Zeichengrenzwert für den Namen einer Auflistung beträgt 75 Zeichen.
Transaktionsverlauf
Der maximale Datumsbereich für den Transaktionsverlauf ist unbegrenzt.
Der Standarddatumsbereich beträgt sechs Monate.
Lagerbestandselement
Anzeigeeigenschaften
Das Feld "Anzeigeeigenschaften" hat einen Grenzwert von 1.000 Byte.