Package google.shopping.merchant.lfp.v1beta

Index

LfpInventoryService

Service permettant à un partenaire Local Services d'envoyer des inventaires en magasin pour un marchand.

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

Insère une ressource LfpInventory pour le compte marchand cible donné. Si la ressource existe déjà, elle sera remplacée. L'inventaire expire automatiquement au bout de 30 jours.

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.

LfpSaleService

Service permettant à un partenaire LFP d'envoyer des données de ventes pour un marchand.

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

Insère un LfpSale pour le marchand 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.

LfpStoreService

Service permettant à un partenaire LFP d'envoyer des magasins locaux pour un marchand.

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

Supprime un magasin pour un marchand cible.

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.
GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

Récupère des informations sur un magasin.

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.
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

Insère un magasin pour le marchand cible. Si le magasin associé au même code de magasin existe déjà, il sera remplacé.

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.
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

Répertorie les magasins du marchand cible, spécifiés par le filtre dans ListLfpStoresRequest.

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.

DeleteLfpStoreRequest

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

Champs
name

string

Obligatoire. Nom du magasin à supprimer pour le compte marchand cible. Format : accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

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

Champs
name

string

Obligatoire. Nom du magasin à récupérer. Format : accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

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

Champs
parent

string

Obligatoire. Compte du fournisseur de LFP. Format : accounts/{account}
lfp_inventory

LfpInventory

Obligatoire. Inventaire à insérer.

InsertLfpSaleRequest

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

Champs
parent

string

Obligatoire. Compte du fournisseur de LFP. Format : accounts/{lfp_partner}
lfp_sale

LfpSale

Obligatoire. La promotion à insérer.

InsertLfpStoreRequest

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

Champs
parent

string

Obligatoire. Format du compte du fournisseur de flux en magasin: accounts/{account}
lfp_store

LfpStore

Obligatoire. Magasin à insérer.

LfpInventory

Inventaire en magasin du marchand.

Champs
name

string

Uniquement en sortie. Identifiant. Nom de la ressource LfpInventory. Format : accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}
target_account

int64

Obligatoire. ID Merchant Center du marchand pour lequel vous envoyez l'inventaire.
store_code

string

Obligatoire. Identifiant du magasin du marchand. Le code de magasin inséré via InsertLfpStore ou le code de magasin indiqué dans la fiche d'établissement.
offer_id

string

Obligatoire. Immuable. Identifiant unique du produit. Si vous envoyez des inventaires et des ventes pour un marchand, cet ID doit correspondre pour le même produit.

Remarque: Si un produit est vendu à la fois neuf et d'occasion, un identifiant unique doit être attribué à chaque type de produit.
region_code

string

Obligatoire. Code CLDR du pays dans lequel le produit est vendu.
content_language

string

Obligatoire. Code de langue ISO 639-1 à deux lettres pour l'article
price

Price

Facultatif. Prix actuel du produit.
availability

string

Obligatoire. 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.
collection_time

Timestamp

Facultatif. Heure à laquelle l'inventaire est collecté. Si cette valeur n'est pas définie, elle sera définie sur l'heure à laquelle l'inventaire est envoyé.
gtin

string

Facultatif. Code article international (GTIN) du produit.
quantity

int64

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

string

Facultatif. Méthode de retrait disponible pour cette offre. Sauf si la valeur est "non compatible", 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

Facultatif. Date à laquelle la commande pourra être retirée en magasin en fonction du moment où elle a été passé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.
feed_label

string

Facultatif. Libellé du flux du produit. Si ce paramètre n'est pas défini, la valeur par défaut est regionCode.

LfpSale

Vente pour le marchand.

Champs
name

string

Uniquement en sortie. Identifiant. Nom de la ressource LfpSale. Format : accounts/{account}/lfpSales/{sale}
target_account

int64

Obligatoire. ID Merchant Center du marchand pour lequel vous envoyez la vente.
store_code

string

Obligatoire. Identifiant du magasin du marchand. Un storeCode inséré via l'API ou le code du magasin dans la fiche d'établissement.
offer_id

string

Obligatoire. Identifiant unique du produit. Si vous envoyez des inventaires et des ventes pour un marchand, cet ID doit correspondre pour le même produit.

Remarque: Si un produit est vendu à la fois neuf et d'occasion, un identifiant unique doit être attribué à chaque type de produit.
region_code

string

Obligatoire. Code CLDR du pays dans lequel le produit est vendu.
content_language

string

Obligatoire. Code de langue ISO 639-1 à deux lettres pour l'article
gtin

string

Obligatoire. Code article international (GTIN) du produit vendu.
price

Price

Obligatoire. Prix unitaire du produit.
quantity

int64

Obligatoire. Variation relative de la quantité disponible. Ce nombre est négatif pour les articles retournés.
sale_time

Timestamp

Obligatoire. Code temporel de la vente.
uid

string

Uniquement en sortie. Identifiant unique global généré par le système pour le LfpSale.
feed_label

string

Facultatif. Libellé du flux du produit. Si ce paramètre n'est pas défini, la valeur par défaut est regionCode.

LfpStore

Magasin du marchand. Il sera utilisé pour faire correspondre un magasin à la fiche d'établissement Google du marchand cible. Si aucun magasin correspondant n'est trouvé, les inventaires ou les ventes envoyés avec le code de magasin ne seront pas utilisés.

Champs
name

string

Uniquement en sortie. Identifiant. Nom de la ressource LfpStore. Format : accounts/{account}/lfpStores/{target_merchant}~{store_code}
target_account

int64

Obligatoire. ID Merchant Center du marchand pour lequel vous envoyez le magasin.
store_code

string

Obligatoire. Immuable. Identifiant de magasin unique pour le marchand cible.
store_address

string

Obligatoire. Adresse postale du magasin. Exemple: 1600 Amphitheatre Parkway, Mountain View, CA 94043, États-Unis.
gcid_category[]

string

Facultatif. ID de catégorie Google My Business
matching_state

StoreMatchingState

Facultatif. Uniquement en sortie. État de la correspondance avec une fiche d'établissement Google. Pour en savoir plus, consultez matchingStateHint si aucune correspondance n'est trouvée.
store_name

string

Facultatif. Nom du marchand ou du magasin.
phone_number

string

Facultatif. Numéro de téléphone du magasin au format E.164 Exemple : +15556767888
website_uri

string

Facultatif. URL du site Web du magasin ou du marchand
place_id

string

Facultatif. ID de lieu Google correspondant à l'emplacement du magasin.
matching_state_hint

string

Facultatif. Uniquement en sortie. Indice précisant pourquoi la mise en correspondance a échoué. Cette valeur n'est définie que lorsque matchingState=STORE_MATCHING_STATE_FAILED.

Les valeurs possibles sont :

  • "linked-store-not-found": aucun magasin de fiche d'établissement Google ne peut être mis en correspondance.
  • "store-match-not-found": le LfpStore que vous avez indiqué n'a pu être mis en correspondance avec aucun des magasins de la fiche d'établissement Google associés. Le compte Merchant Center est correctement associé, et des magasins sont disponibles sur la fiche d'établissement Google. Cependant, l'adresse de l'établissement LfpStore ne correspond à celle d'aucun des magasins de la fiche. Modifiez l'adresse LfpStore ou celle de la fiche d'établissement Google pour qu'elle corresponde.
  • "store-match-unverified": le LfpStore que vous avez fourni n'a pu être mis en correspondance avec aucun des magasins de la fiche d'établissement Google associés, car le magasin de la fiche d'établissement Google correspondant n'a pas été validé. Suivez la procédure de validation de la fiche d'établissement Google pour qu'elle soit correctement associée.

StoreMatchingState

État de la correspondance de LfpStore avec une fiche d'établissement Google.

Enums
STORE_MATCHING_STATE_UNSPECIFIED État de la correspondance des magasins non spécifié.
STORE_MATCHING_STATE_MATCHED Le LfpStore a bien été mis en correspondance avec un magasin de la fiche d'établissement Google.
STORE_MATCHING_STATE_FAILED Le LfpStore n'a pas été mis en correspondance avec un magasin de la fiche d'établissement Google.

ListLfpStoresRequest

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

Champs
parent

string

Obligatoire. Le partenaire LFP Format : accounts/{account}
target_account

int64

Obligatoire. ID Merchant Center du marchand pour lequel vous souhaitez lister des magasins.
page_size

int32

Facultatif. Nombre maximal de ressources LfpStore à renvoyer pour le compte donné. Le service renvoie un nombre inférieur à cette valeur si le nombre de magasins du compte donné est inférieur à pageSize. La valeur par défaut est 250. La valeur maximale est 1 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

Facultatif. Jeton de page reçu d'un appel ListLfpStoresRequest 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 à ListLfpStoresRequest 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.

ListLfpStoresResponse

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

Champs
lfp_stores[]

LfpStore

Magasins du marchand 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.