Limiter la 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.
- lots
- game keys
- L’appel API Créer un lot ou Mettre à jour un lot pour les lots.
L’appel API Créer un jeu, Mettre à jour un jeu par UGS ou Mettre à jour un jeu par ID pour les clés de jeu.
periods[0].date_from
avec la date et l’heure de début de la période d’affichage du bien au formatYYYY-MM-DDThh:mm:ss±TMZ
, oùTMZ
est l’indicateur de fuseau horaire au formathh: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 formathh:mm
GMT. Pour ne pas indiquer la fin de la période d’affichage du bien, passeznull
.
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.
Les délais d’affichage des objets ne sont pas pris en compte dans un lot.
EXEMPLE
- Vous créez un
Booster virtuel et définissez sa période d’affichage du 29 octobre au 15 novembre. - Vous créez un lot
Legendary Start Pack qui comprend leBooster . Le lot n’a pas de limite de temps, il est donc toujours visible dans le magasin. - Le 20 octobre, un utilisateur ouvre votre magasin en jeu. Vous utilisez les méthodes suivantes :
- Lire une liste d’objets virtuels pour afficher le catalogue des objets virtuels.
- Lire une liste de lots pour afficher le catalogue des lots.
show_inactive_time_limited_items
dans ces méthodes. - Vous récupérez le catalogue des objets :
- Le
Booster n’est pas inclus dans la réponse à Lire une liste d’objets virtuels, car sa période d’affichage va du 29 octobre au 15 novembre. Si vous passez le paramètreshow_inactive_time_limited_items:1
dans Lire une liste d’objets virtuels, leBooster est inclus dans la réponse, et le tableau periods indique la période pendant laquelle il est en vente. Booster est inclus dans la réponse à Lire une liste de lots en tant que partie du lotLegendary Start Pack , et l’utilisateur peut l’obtenir quel que soit la valeur du paramètreshow_inactive_time_limited_items
.
- Le
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.