Package google.shopping.merchant.inventories.v1beta

Index

LocalInventoryService

Service de gestion de l'inventaire en magasin pour les produits

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

Supprime l'élément LocalInventory spécifié du produit concerné dans votre compte marchand. La suppression de l'LocalInventory du produit concerné peut prendre jusqu'à une heure. Une fois que vous avez reçu une réponse indiquant que l'opération a réussi, attendez ce délai avant d'effectuer une nouvelle tentative de suppression.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la présentation d'OAuth 2.0.
InsertLocalInventory

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

Insère une ressource LocalInventory à un produit de votre compte marchand.

Remplace la ressource LocalInventory complète si une entrée avec le même storeCode existe déjà pour le produit.

L'affichage de la ressource LocalInventory nouvelle ou mise à jour dans les produits peut prendre jusqu'à 30 minutes.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la présentation d'OAuth 2.0.
ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

Répertorie les ressources LocalInventory pour le produit donné dans votre compte marchand. La réponse peut contenir moins d'éléments que celui spécifié par pageSize. Si pageToken a été renvoyé dans une requête précédente, il peut être utilisé pour obtenir des résultats supplémentaires.

LocalInventory ressources sont listées par produit sur un compte donné.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

RegionalInventoryService

Service de gestion de l'inventaire régional des produits Il existe également une ressource regions et une API distinctes pour gérer les définitions des régions.

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

Supprime la ressource RegionalInventory spécifiée pour le produit concerné dans votre compte marchand. La suppression de l'RegionalInventory du produit concerné peut prendre jusqu'à une heure. Une fois que vous avez reçu une réponse indiquant que l'opération a réussi, attendez ce délai avant d'effectuer une nouvelle tentative de suppression.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la présentation d'OAuth 2.0.
InsertRegionalInventory

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

Insère un RegionalInventory pour un produit donné dans votre compte marchand.

Remplace la ressource RegionalInventory complète si une entrée avec le même region existe déjà pour le produit.

L'affichage de la ressource RegionalInventory nouvelle ou mise à jour dans les produits peut prendre jusqu'à 30 minutes.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la présentation d'OAuth 2.0.
ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

Répertorie les ressources RegionalInventory pour le produit donné dans votre compte marchand. La réponse peut contenir moins d'éléments que celui spécifié par pageSize. Si pageToken a été renvoyé dans une requête précédente, il peut être utilisé pour obtenir des résultats supplémentaires.

RegionalInventory ressources sont listées par produit sur un compte donné.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

DeleteLocalInventoryRequest

Message de requête pour la méthode DeleteLocalInventory.

Champs
name

string

Obligatoire. Nom de l'inventaire en magasin du produit à supprimer. Format : accounts/{account}/products/{product}/localInventories/{store_code}

DeleteRegionalInventoryRequest

Message de requête pour la méthode DeleteRegionalInventory.

Champs
name

string

Obligatoire. Nom de la ressource RegionalInventory à supprimer. Format: accounts/{account}/products/{product}/regionalInventories/{region}

InsertLocalInventoryRequest

Message de requête pour la méthode InsertLocalInventory.

Champs
parent

string

Obligatoire. Compte et produit où cet inventaire sera inséré. Format : accounts/{account}/products/{product}
local_inventory

LocalInventory

Obligatoire. Informations sur l'inventaire en magasin du produit. Si le produit dispose déjà d'une ressource LocalInventory pour le même storeCode, le remplacement complet de la ressource LocalInventory est effectué.

InsertRegionalInventoryRequest

Message de requête pour la méthode InsertRegionalInventory.

Champs
parent

string

Obligatoire. Compte et produit où cet inventaire sera inséré. Format : accounts/{account}/products/{product}
regional_inventory

RegionalInventory

Obligatoire. Informations sur l'inventaire régional à ajouter au produit. Si le produit dispose déjà d'une ressource RegionalInventory pour le même region, le remplacement complet de la ressource RegionalInventory est effectué.

ListLocalInventoriesRequest

Message de requête pour la méthode ListLocalInventories.

Champs
parent

string

Obligatoire. Valeur name du produit parent pour laquelle répertorier les inventaires en magasin. Format: accounts/{account}/products/{product}
page_size

int32

Nombre maximal de ressources LocalInventory que le produit donné peut renvoyer. Le service renvoie une valeur inférieure à cette valeur si le nombre d'inventaires du produit donné est inférieur à pageSize. La valeur par défaut est 25 000. La valeur maximale est 25 000. Si une valeur supérieure au maximum est spécifiée, pageSize utilise par défaut la valeur maximale.
page_token

string

Jeton de page reçu d'un appel ListLocalInventories précédent. Indiquez le jeton de page pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListLocalInventories doivent correspondre à l'appel ayant fourni le jeton de page. Jeton renvoyé en tant que nextPageToken dans la réponse à la requête précédente.

ListLocalInventoriesResponse

Message de réponse pour la méthode ListLocalInventories.

Champs
local_inventories[]

LocalInventory

Les ressources LocalInventory du produit donné pour le compte spécifié.
next_page_token

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListRegionalInventoriesRequest

Message de requête pour la méthode ListRegionalInventories.

Champs
parent

string

Obligatoire. name du produit parent pour lequel répertorier les ressources RegionalInventory. Format: accounts/{account}/products/{product}
page_size

int32

Nombre maximal de ressources RegionalInventory que le produit donné peut renvoyer. Le service renvoie une valeur inférieure à cette valeur si le nombre d'inventaires du produit donné est inférieur à pageSize. La valeur par défaut est 25 000. La valeur maximale est 100 000. Si une valeur supérieure à la valeur maximale est spécifiée, pageSize est défini par défaut sur la valeur maximale.
page_token

string

Jeton de page reçu d'un appel ListRegionalInventories précédent. Indiquez le jeton de page pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListRegionalInventories doivent correspondre à l'appel ayant fourni le jeton de page. Jeton renvoyé en tant que nextPageToken dans la réponse à la requête précédente.

ListRegionalInventoriesResponse

Message de réponse pour la méthode ListRegionalInventories.

Champs
regional_inventories[]

RegionalInventory

Les ressources RegionalInventory du produit donné pour le compte spécifié.
next_page_token

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

LocalInventory

Informations sur l'inventaire en magasin du produit. Représente les informations en magasin pour un produit spécifique dans le magasin spécifié par storeCode. Pour obtenir la liste de toutes les valeurs d'attribut acceptées, consultez les spécifications des données d'inventaire de produits en magasin.

Champs
name

string

Uniquement en sortie. Nom de la ressource LocalInventory. Format: accounts/{account}/products/{product}/localInventories/{store_code}
account

int64

Uniquement en sortie. Compte auquel appartient le produit. Ce champ sera ignoré s'il est défini par le client.
store_code

string

Obligatoire. Immuable. Code de magasin (ID de magasin provenant de votre fiche d'établissement) du magasin physique dans lequel le produit est vendu. Pour en savoir plus, consultez les spécifications des données d'inventaire de produits en magasin.
price

Price

Prix du produit dans ce magasin.
sale_price

Price

Prix soldé du produit dans ce magasin. Obligatoire si salePriceEffectiveDate est défini.
sale_price_effective_date

Interval

La TimePeriod de la promotion dans ce magasin.
custom_attributes[]

CustomAttribute

Liste d'attributs personnalisés (fournis par le marchand). Vous pouvez également utiliser CustomAttribute pour envoyer tout attribut des spécifications des données sous sa forme générique.
availability

string

Disponibilité du produit dans ce magasin. Pour connaître les valeurs acceptées pour les attributs, consultez les spécifications des données d'inventaire de produits en magasin.
quantity

int64

Quantité du produit disponible dans ce magasin. La valeur doit être supérieure ou égale à zéro.
pickup_method

string

Méthode de retrait en magasin acceptée pour ce produit. Ce champ doit être renseigné avec l'attribut pickupSla, sauf si la valeur est "not supported". Pour connaître les valeurs acceptées pour les attributs, consultez les spécifications des données d'inventaire de produits en magasin.
pickup_sla

string

Délai relatif à partir de la date de commande d'un produit dans ce magasin avant qu'il soit prêt à être retiré. Doit être envoyé avec pickupMethod. Pour connaître les valeurs acceptées pour les attributs, consultez les spécifications des données d'inventaire de produits en magasin.
instore_product_location

string

Emplacement du produit dans le magasin. Ne doit pas dépasser 20 octets.

RegionalInventory

Informations sur l'inventaire régional du produit. Représente des informations spécifiques telles que le prix et la disponibilité d'un produit donné dans une region spécifique. Pour obtenir la liste de toutes les valeurs d'attribut acceptées, consultez les spécifications des données d'inventaire de produits régionales.

Champs
name

string

Uniquement en sortie. Nom de la ressource RegionalInventory. Format: {regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}
account

int64

Uniquement en sortie. Compte auquel appartient le produit. Ce champ sera ignoré s'il est défini par le client.
region

string

Obligatoire. Immuable. ID de la région pour cette ressource RegionalInventory. Pour en savoir plus, consultez Disponibilité et tarification selon la région.
price

Price

Prix du produit dans cette région.
sale_price

Price

Prix soldé du produit dans cette région. Obligatoire si salePriceEffectiveDate est défini.
sale_price_effective_date

Interval

La valeur TimePeriod du prix soldé dans cette région.
custom_attributes[]

CustomAttribute

Liste d'attributs personnalisés (fournis par le marchand). Vous pouvez également utiliser CustomAttribute pour envoyer tout attribut des spécifications des données sous sa forme générique.
availability

string

Disponibilité du produit dans cette région. Pour connaître les valeurs acceptées pour les attributs, consultez les spécifications des données d'inventaire de produits régional.