Package google.shopping.merchant.inventories.v1beta

Index

LocalInventoryService

Service permettant de gérer l'inventaire en magasin de produits

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

Supprime l'LocalInventory spécifié du produit donné dans votre compte marchand. La suppression de l'LocalInventory du produit spécifique peut prendre jusqu'à une heure. Une fois que vous avez reçu une réponse de suppression, attendez cette période avant de réessayer de supprimer.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.
InsertLocalInventory

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

Insère une ressource LocalInventory dans 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 OAuth 2.0 Overview.
ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

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

Les ressources LocalInventory sont listées par produit pour 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 OAuth 2.0 Overview.

RegionalInventoryService

Service permettant de gérer l'inventaire régional des produits. Une ressource et une API regions distinctes sont également disponibles pour gérer les définitions de régions.

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

Supprime la ressource RegionalInventory spécifiée du produit donné dans votre compte marchand. La suppression de l'RegionalInventory du produit spécifique peut prendre jusqu'à une heure. Une fois que vous avez reçu une réponse de suppression, attendez cette période avant de réessayer de supprimer.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.
InsertRegionalInventory

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

Insère un RegionalInventory à 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 OAuth 2.0 Overview.
ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

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

Les ressources RegionalInventory sont listées par produit pour 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 OAuth 2.0 Overview.

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 dans lesquels 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, la ressource LocalInventory est entièrement remplacée.

InsertRegionalInventoryRequest

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

Champs
parent

string

Obligatoire. Compte et produit dans lesquels 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, la ressource RegionalInventory est entièrement remplacée.

ListLocalInventoriesRequest

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

Champs
parent

string

Obligatoire. name du produit parent pour lequel lister les inventaires en magasin. Format : accounts/{account}/products/{product}
page_size

int32

Nombre maximal de ressources LocalInventory à renvoyer pour le produit donné. Le service renvoie un nombre inférieur à 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 à la valeur maximale est spécifiée, la valeur maximale est utilisée par défaut pour pageSize.
page_token

string

Jeton de page reçu d'un appel ListLocalInventories précédent. Fournissez 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é sous la forme 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

Ressources LocalInventory du produit donné du 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 lister les ressources RegionalInventory. Format: accounts/{account}/products/{product}
page_size

int32

Nombre maximal de ressources RegionalInventory à renvoyer pour le produit donné. Le service renvoie un nombre inférieur à 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, la valeur maximale est utilisée par défaut pour pageSize.
page_token

string

Jeton de page reçu d'un appel ListRegionalInventories précédent. Fournissez 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é sous la forme 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

Ressources RegionalInventory du produit donné du 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 propriétaire du produit. Ce champ est ignoré s'il est défini par le client.
store_code

string

Obligatoire. Immuable. Code de magasin (identifiant du magasin dans 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

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 n'importe quel attribut des spécifications des données sous forme générique.
availability

string

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

int64

Quantité du produit disponible dans ce magasin. Doit être supérieur ou égal à zéro.
pickup_method

string

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

string

Période relative à partir de la date de commande pour que la commande de ce produit, passée dans ce magasin, soit prête à être retirée. Doit être envoyé avec pickupMethod. Pour connaître les valeurs d'attribut acceptées, consultez les spécifications des données d'inventaire de produits en magasin.
instore_product_location

string

Emplacement du produit dans le magasin. La longueur maximale est de 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 un 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égionaux.

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 propriétaire du produit. Ce champ est 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 la page 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

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 n'importe quel attribut des spécifications des données sous forme générique.
availability

string

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