Comment configurer une limite de durée d’affichage des objets dans le magasin

Définissez la période d’affichage d’un objet dans le magasin pour :

• maintenir la pertinence du catalogue à un moment donné, par exemple pendant les soldes des fêtes ;
• créer un objet à l’avance sans l’afficher dans le catalogue ;
• motiver l’utilisateur à acheter des objets en affichant un chronomètre à côté de ceux-ci.

• objets virtuels
• monnaie virtuelle et packages de monnaie virtuelle
• lots

• les appels API Create virtual item ou Update virtual item pour les objets virtuels.
• les appels API Create virtual currency ou Update virtual currency pour la monnaie virtuelle.
• les appels API Create virtual currency package ou Update virtual currency package pour les packages de monnaie virtuelle.

• les appels API Create bundle ou Update bundle pour les lots.

• periods[0].date_from avec la date et l’heure de début de la période d’affichage du bien au format YYYY-MM-DDThh:mm:ss±TMZ, où TMZ est l’indicateur de fuseau horaire au format hh:mm GMT ;

• periods[0].date_until avec la date et l’heure de fin de la période d’affichage du bien au formatYYYY-MM-DDThh:mm:ss±TMZ, où TMZ est l’indicateur de fuseau horaire au format hh:mm GMT. Pour ne pas indiquer la fin de la période d’affichage du bien, passez null.

Vous pouvez définir plusieurs périodes pour l’affichage d’un bien dans le magasin. Pour ce faire, passez un tableau avec les dates de début et de fin de toutes les périodes dans les appels API.

Exemple :

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

Les méthodes GET du catalogue renvoient les objets qui sont affichés dans le magasin au moment de la requête. Pour obtenir des informations sur les objets dont la période d’affichage n’a pas encore commencé ou a déjà expiré, passez le paramètre show_inactive_time_limited_items avec une valeur de 1 lors de la requête de catalogue.