Anzeigedauer für Artikel im Shop begrenzen
Sie können den Anzeigezeitraum für einen Artikel im Shop festlegen und dadurch:
- den Katalog je nach Zeitraum relevanter gestalten, z. B. während der Weihnachtsfeiertage
einen Artikel im Voraus erstellen, ohne ihn im Katalog anzuzeigen
- Bundles
- Spielschlüssel
- für Bundles den API-Aufruf
Create bundle oderUpdate bundle für Spielschlüssel den API-Aufruf
Create game ,Update game by SKU oderUpdate game by ID
periods[0].date_from
mitsamt dem Startdatum und der Startuhrzeit des Artikelanzeigezeitraums im FormatYYYY-MM-DDThh:mm:ss±TMZ
, wobeiTMZ
die Zeitzonenangabe im Formathh:mm
ist.periods[0].date_until
mitsamt dem Enddatum und der Enduhrzeit des Artikelanzeigezeitraums im FormatYYYY-MM-DDThh:mm:ss±TMZ
, wobeiTMZ
die Zeitzonenangabe – bezogen auf GMT – im Formathh:mm
ist. Wenn Sie keine Ende für den Anzeigezeitraum des Artikels festlegen möchten, übermitteln Sienull
.
Sie können mehrere Zeiträume für die Anzeige eines Artikels im Shop festlegen. Übermitteln Sie dazu in den API-Aufrufen ein Objekt-Array mit dem jeweiligen Start- und Enddatum der Zeiträume.
Beispiel:
"periods": [
{
"date_from": "2022-06-10T14:00:00+03:00",
"date_until": "2022-06-30T14:00:00+03:00"
},
{
"date_from": "2022-07-10T14:00:00+03:00",
"date_until": "2022-07-30T14:00:00+03:00"
},
{
"date_from": "2022-08-10T14:00:00+03:00",
"date_until": "2022-08-30T14:00:00+03:00"
}
]
Die Antwort der Katalog-abrufen-Methoden enthält jene Artikel, die zum Zeitpunkt der Anfrage im Shop angezeigt werden. Wenn Sie Informationen über Artikel erhalten möchten, deren Anzeigezeitraum noch nicht begonnen hat oder bereits abgelaufen ist, weisen Sie bei der Katalogabfrage dem Parameter show_inactive_time_limited_items den Wert 1
zu.
Zeitlimits für die Artikelanzeige werden innerhalb eines Bundles nicht berücksichtigt.
BEISPIEL
1. Sie erstellen einen virtuellen Gegenstand namens
2. Sie erstellen ein Bundle names
3. Ein Nutzer öffnet am 20. Oktober den Ingame-Shop. Sie können folgende Methoden nutzen:
- List der virtuellen Gegenstände abrufen – Zum Abrufen des Katalogs virtueller Gegenstände.
- List der Bundles abrufen – Zum Abrufen des Bundle-Katalogs.
show_inactive_time_limited_items
nicht übermitteln.4. Beim Abrufen des Artikelkatalogs geschieht Folgendes:
- In der Antwort der Methode Liste virtueller Gegenstände abrufen ist der
Booster nicht enthalten, da als Anzeigezeitraum der 29. Oktober bis 15. November festgelegt ist. Wenn Sie in der Methode Liste der virtuellen Gegenstände abrufen den Parametershow_inactive_time_limited_items:1
übermitteln, ist derBooster in der Antwort enthalten und im Array Zeiträume ist der Zeitraum angegeben, in dem der virtuelle Gegenstand erhältlich ist. - In der Antwort der Methode Liste der Bundles abrufen ist der
Booster als Teil desLegendary Start Pack -Bundles enthalten, und der Nutzer kann den Gegenstand unabhängig vom Wert des Parametersshow_inactive_time_limited_items
erhalten.
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.