# Lire la liste des jeux (administrateur)

Récupère la liste des jeux au sein d'un projet à des fins d'administration.
Le jeu consiste en des clés de jeu qui peuvent être achetées par un utilisateur.

NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin.

Endpoint: GET /v2/project/{project_id}/admin/items/game
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID du projet. Vous trouverez ce paramètre dans le Compte éditeur, à côté du nom du projet, ainsi que dans l'URL affichée dans la barre d'adresse du navigateur lorsque vous utilisez ce projet. L'URL présente le format suivant : https://publisher.xsolla.com//projects/.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Nombre maximal d'éléments sur une page.
    Example: 50

  - `offset` (integer)
    Numéro de l'élément à partir duquel la liste est générée (le décompte commence à 0).

  - `promo_code` (string)
    Code unique sensible à la casse. Comprend des lettres et des chiffres.
    Example: "WINTER2021"

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Utilisé pour indiquer qu'il y a plus de pages.

  - `total_items_count` (integer)
    Nombre total d'objets dans le système.

  - `items` (array)

  - `items.item_id` (integer)
    Internal ID unique de l'objet, fourni lors de la création de l'objet.
    Example: 1

  - `items.sku` (string)
    ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.
    Example: "game_1"

  - `items.type` (string)
    Type d'objet. Dans ce cas, il s'agit toujours de unit.
    Example: "unit"

  - `items.name` (object,null)
    Conteneur objet contenant les localisations du nom de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `items.description` (object,null)
    Conteneur objet contenant les localisations de la description de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `items.long_description` (object,null)
    Conteneur objet contenant les localisations de la description complète de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `items.image_url` (string)
    URL de l'image
    Example: "https://image.example.com"

  - `items.media_list` (array)
    Ressources supplémentaires du jeu, telles que des captures d'écran, des vidéos de gameplay, etc.
    Example: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}]

  - `items.media_list.type` (string)
    Type de média : image/video.
    Enum: "image", "video"

  - `items.media_list.url` (string)
    Fichier de ressources.
    Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"

  - `items.is_enabled` (boolean)
    Si ce paramètre est désactivé, l'objet ne peut pas être acheté et n'est pas accessible par le biais de l'inventaire.

  - `items.is_show_in_store` (boolean)
    L'objet est disponible à l'achat.

  - `items.order` (integer)
    Ordre de priorité des jeux dans la liste.
    Example: 1

  - `items.groups` (array)
    Groupes auxquels l'objet appartient.
    Example: [{"external_id":"horror","name":{"en":"Horror"}}]

  - `items.groups.external_id` (string)
    Example: "horror"

  - `items.groups.name` (object)
    Example: {"en":"Horror"}

  - `items.attributes` (array)
    Liste des attributs.
    Example: [{"external_id":"attribute_external_id","name":{"en":"Attribute name","de":"Attributname"},"values":[{"external_id":"value_1","name":{"en":"value 1","de":"wert 1"}},{"external_id":"value_2","name":{"en":"value 2","de":"wert 2"}}]}]

  - `items.attributes.external_id` (string, required)
    ID unique de l'attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des tirets et des traits bas.
    Example: "attribute_external_id"

  - `items.attributes.name` (object)
    Objet contenant des versions localisées du nom de l'attribut. Les clés sont spécifiées selon la norme ISO 3166-1.
    Example: {"en":"Attribute name","de":"Attributname"}

  - `items.attributes.values` (array, required)
    Example: [{"external_id":"value_1","name":{"en":"value 1","de":"wert 1"}},{"external_id":"value_2","name":{"en":"value 2","de":"wert 2"}}]

  - `items.attributes.values.external_id` (string, required)
    ID unique de la valeur d'un attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules, des tirets et des tirets bas.
    Example: "value_external_id"

  - `items.attributes.values.value` (object, required)
    Objet contenant des versions localisées du nom de la valeur. Les clés sont spécifiées selon la norme ISO 3166-1.

  - `items.is_free` (boolean)
    Détermine la gratuité de l'objet.

  - `items.unit_items` (array)
    Clés de jeu pour différents DRM.

  - `items.unit_items.item_id` (integer)
    Internal ID unique de l'objet, fourni lors de la création de l'objet.
    Example: 1

  - `items.unit_items.sku` (string)
    ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.
    Example: "game_1"

  - `items.unit_items.type` (string)
    Type d'objet. Dans ce cas, il s'agit toujours de game_key.
    Example: "game_key"

  - `items.unit_items.is_free` (boolean)
    Détermine la gratuité de l'objet.

  - `items.unit_items.prices` (array)
    Prix en devises réelles.
    Example: [{"amount":1299.99,"currency":"RUB","is_default":true,"is_enabled":true}]

  - `items.unit_items.prices.amount` (number)
    Example: 1299.99

  - `items.unit_items.prices.currency` (string)
    Devise du prix de l'objet. Code à trois lettres selon [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "RUB"

  - `items.unit_items.prices.is_default` (boolean)
    Le prix par défaut est utilisé pour constituer le catalogue si aucun prix n'est spécifié dans la devise de l'utilisateur.

  - `items.unit_items.prices.is_enabled` (boolean)

  - `items.unit_items.prices.country_iso` (string,null)
    Pays où ce prix est disponible. Code à deux lettres selon la norme [ISO 3166-1 alpha 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Example: "US"

  - `items.unit_items.virtual_prices` (array,null)
    Example: [{"sku":"com.xsolla.gold_1","name":{"en":"Gold"},"type":"virtual_currency","description":null,"image_url":"https://i.pinimg.com/originals/91/ae/56/91ae5683045f6dbef16b1482bade938f.png","amount":1000,"is_default":true}]

  - `items.unit_items.virtual_prices.sku` (string)
    ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.
    Example: "gold"

  - `items.unit_items.virtual_prices.name` (object)
    Objet contenant des versions localisées du nom de la monnaie virtuelle. Les clés sont spécifiées selon la norme ISO 3166-1.
    Example: {"en":"Gold"}

  - `items.unit_items.virtual_prices.type` (string)
    Type d'objet. Dans ce cas, il s'agit toujours de virtual_currency.
    Example: "virtual_currency"

  - `items.unit_items.virtual_prices.description` (object,null)
    Objet contenant des versions localisées de la description du jeu. Les clés sont spécifiées selon la norme ISO 3166-1.
    Example: {"en":"Game 1 Example"}

  - `items.unit_items.virtual_prices.image_url` (string)
    URL de l'image
    Example: "https://image.example.com"

  - `items.unit_items.virtual_prices.amount` (number)

  - `items.unit_items.virtual_prices.is_default` (boolean)

  - `items.unit_items.order` (integer)
    Ordre de priorité des jeux dans la liste.
    Example: 1

  - `items.unit_items.is_enabled` (boolean)
    Si ce paramètre est désactivé, l'objet ne peut pas être acheté et n'est pas accessible par le biais de l'inventaire.

  - `items.unit_items.is_show_in_store` (boolean)
    L'objet est disponible à l'achat.

  - `items.unit_items.drm_name` (string)
    Nom du DRM de la clé de jeu.
    Example: "Steam"

  - `items.unit_items.drm_sku` (string)
    ID unique du DRM.
    Example: "steam"

  - `items.unit_items.drm_image` (string,null)
    Icône du DRM de la clé de jeu.
    Example: "https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png"

  - `items.unit_items.drm_id` (integer)
    Internal ID unique du DRM.
    Example: 1

  - `items.unit_items.keys` (object)

  - `items.unit_items.keys.available` (integer)
    Nombre de clés disponibles à l'achat.

  - `items.unit_items.keys.total` (integer)
    Nombre total de clés téléchargées.

  - `items.unit_items.keys.used` (integer)
    Nombre de clés vendues.

  - `items.unit_items.is_sales_exist` (boolean)
    Si true, la clé de jeu a été achetée par les utilisateurs.

  - `items.unit_items.pre_order` (object)
    Paramètres de pré-commande.

  - `items.unit_items.pre_order.release_date` (string,null)
    Date de publication de la clé de jeu au format ISO 8601.

  - `items.unit_items.pre_order.is_enabled` (boolean)
    Si ce paramètre est désactivé, l'objet n'est pas une pré-commande.

  - `items.unit_items.pre_order.description` (string,null)
    Informations supplémentaires pour la pré-commande, qui sera envoyée par e-mail.

  - `items.unit_items.regions` (array)

  - `items.unit_items.regions.id` (integer)
    Example: 1

  - `items.unit_items.limits` (object,null)
    Limites d'objets.

  - `items.unit_items.limits.per_user` (object,null)
    Limites d'objets pour un utilisateur spécifique.

  - `items.unit_items.limits.per_user.total` (integer)
    Nombre maximal d'objets qu'un utilisateur unique peut acheter.

  - `items.unit_items.limits.per_user.limit_exceeded_visibility` (string)
    Détermine la visibilité de l'objet dans le catalogue une fois la limite d'achat atteinte, jusqu'à la prochaine réinitialisation de la limite.

S'applique aux objets pour lesquels des réinitialisations de limite récurrentes sont configurées dans le tableau recurrent_schedule.

Si aucune réinitialisation de limite n'est configurée, l'objet n'apparaît plus dans le catalogue une fois la limite d'achat atteinte, quelle que soit la valeur de limit_exceeded_visibility.

Valeurs possibles :
- show — L'objet est renvoyé dans les appels API de récupération du catalogue après avoir atteint la limite d'achat. Dans les appels côté client, une fois la limite atteinte, l'objet est renvoyé avec l'indicateur can_be_bought: false. La prochaine date de réinitialisation est renvoyée dans reset_next_date.
- hide — L'objet n'est pas renvoyé dans les appels API de récupération du catalogue après avoir atteint la limite d'achat, jusqu'à la réinitialisation de la limite.
    Enum: "show", "hide"

  - `items.unit_items.limits.per_item` (object,null)
    Limites globales d'objets.

  - `items.unit_items.limits.per_item.total` (integer)
    Nombre maximal d'objets que tous les utilisateurs peuvent acheter.

  - `items.unit_items.limits.per_item.available` (integer)
    Nombre d'objets restants que tous les utilisateurs peuvent acheter.

  - `items.unit_items.limits.per_item.reserved` (integer)

  - `items.unit_items.limits.per_item.sold` (integer)

  - `items.unit_items.limits.recurrent_schedule` (object,null)
    Délai d'actualisation des limites.

  - `items.unit_items.limits.recurrent_schedule.per_user` (any)
    Délai d'actualisation des limites pour un utilisateur.

  - `items.unit_items.periods` (array)
    Période de vente d'objets.

  - `items.unit_items.periods.date_from` (string,null)
    Date de mise en vente de l'objet spécifié.
    Example: "2020-08-11T10:00:00+03:00"

  - `items.unit_items.periods.date_until` (string,null)
    Date de retrait de la vente de l'objet spécifié. Peut prendre la valeur null.
    Example: "2020-08-11T20:00:00+03:00"

  - `items.unit_items.name` (object,null)
    Conteneur objet contenant les localisations du nom de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `items.unit_items.attributes` (array)
    Liste des attributs.
    Example: [{"external_id":"attribute_external_id","name":{"en":"Attribute name","de":"Attributname"},"values":[{"external_id":"value_1","name":{"en":"value 1","de":"wert 1"}},{"external_id":"value_2","name":{"en":"value 2","de":"wert 2"}}]}]

  - `items.unit_items.attributes.external_id` (string, required)
    ID unique de l'attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des tirets et des traits bas.
    Example: "attribute_external_id"

  - `items.unit_items.attributes.name` (object)
    Objet contenant des versions localisées du nom de l'attribut. Les clés sont spécifiées selon la norme ISO 3166-1.
    Example: {"en":"Attribute name","de":"Attributname"}

  - `items.unit_items.attributes.values` (array, required)
    Example: [{"external_id":"value_1","name":{"en":"value 1","de":"wert 1"}},{"external_id":"value_2","name":{"en":"value 2","de":"wert 2"}}]

  - `items.unit_items.attributes.values.external_id` (string, required)
    ID unique de la valeur d'un attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules, des tirets et des tirets bas.
    Example: "value_external_id"

  - `items.unit_items.attributes.values.value` (object, required)
    Objet contenant des versions localisées du nom de la valeur. Les clés sont spécifiées selon la norme ISO 3166-1.

  - `items.unit_items.long_description` (object,null)
    Conteneur objet contenant les localisations de la description complète de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `items.unit_items.groups` (array)
    Groupes auxquels l'objet appartient.
    Example: [{"external_id":"horror","name":{"en":"Horror"}}]

  - `items.unit_items.groups.external_id` (string)
    Example: "horror"

  - `items.unit_items.groups.name` (object)
    Example: {"en":"Horror"}

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"