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 Bundle erstellen oder Bundle aktualisieren
für Spielschlüssel den API-Aufruf Spiel erstellen, Spiel anhand der SKU aktualisieren oder Spiel anhand der ID aktualisieren
periods[0].date_from
mitsamt dem Startdatum und der Startuhrzeit des Artikelanzeigezeitraums im FormatYYYY-MM-DDThh:mm:ss±TMZ
, wobeiTMZ
die Zeitzonenangabe – bezogen auf GMT – 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
- Sie erstellen einen virtuellen Gegenstand namens
Booster und legen als Anzeigezeitraum den 29. Oktober bis 15. November fest. - Sie erstellen ein Bundle names
Legendary Start Pack , in dem derBooster enthalten ist. Für das Bundle ist kein Zeitlimit festgelegt, es wird also dauerhaft im Online-Shop angezeigt. - 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. - 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.
- In der Antwort der Methode Liste virtueller Gegenstände abrufen ist der
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.