Package google.shopping.merchant.lfp.v1beta

Index

LfpInventoryService

Service permettant à un partenaire LFP 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 la présentation d'OAuth 2.0.

LfpSaleService

Service permettant à un partenaire LFP d'envoyer des données de vente 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 la présentation d'OAuth 2.0.

LfpStoreService

Service permettant à un partenaire LFP d'indiquer 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 la présentation d'OAuth 2.0.

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 la présentation d'OAuth 2.0.

InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

Insère un magasin pour le marchand cible. Si un 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 la présentation d'OAuth 2.0.

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 la présentation d'OAuth 2.0.

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 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 LFP. Format : accounts/{lfp_partner}

lfp_sale

LfpSale

Obligatoire. Promotion à insérer.

InsertLfpStoreRequest

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

Champs
parent

string

Obligatoire. Format du compte fournisseur LFP: accounts/{account}

lfp_store

LfpStore

Obligatoire. Magasin à insérer.

LfpInventory

Inventaire en magasin pour le 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 envoyer l'inventaire.

store_code

string

Obligatoire. Identifiant du magasin du marchand. Il peut s'agir du code de magasin inséré via InsertLfpStore ou de celui figurant dans la fiche d'établissement.

offer_id

string

Obligatoire. Immuable. Identifiant unique du produit. Si des inventaires et des ventes sont envoyés pour un marchand, cet identifiant doit être identique 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 où le produit est vendu.

content_language

string

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

price

Price

Facultatif. Prix actuel du produit.

availability

string

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

collection_time

Timestamp

Facultatif. Heure à laquelle l'inventaire est collecté. Si ce champ n'est pas spécifié, il correspond à l'heure d'envoi de l'inventaire.

gtin

string

Facultatif. Code article international du produit.

quantity

int64

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

pickup_method

string

Facultatif. Méthode de retrait en magasin acceptée pour cette offre. Ce champ doit être envoyé avec 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

Facultatif. Date prévue à laquelle une commande pourra être retirée en magasin par rapport à la date de la commande. 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.

feed_label

string

Facultatif. Libellé du flux du produit. Si cette valeur n'est pas définie, 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 proposer la vente.

store_code

string

Obligatoire. Identifiant du magasin du marchand. Soit une valeur storeCode insérée via l'API, soit le code du magasin dans la fiche d'établissement.

offer_id

string

Obligatoire. Identifiant unique du produit. Si des inventaires et des ventes sont envoyés pour un marchand, cet identifiant doit être identique 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 où le produit est vendu.

content_language

string

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

gtin

string

Obligatoire. Code article international du produit vendu.

price

Price

Obligatoire. Prix unitaire du produit.

quantity

int64

Obligatoire. Variation relative de la quantité disponible. Négatif pour les articles retournés.

sale_time

Timestamp

Obligatoire. Code temporel de la promotion.

uid

string

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

feed_label

string

Facultatif. Libellé du flux du produit. Si cette valeur n'est pas définie, la valeur par défaut est regionCode.

LfpStore

Boutique du marchand. Il sera utilisé pour établir une correspondance avec un magasin dans la fiche d'établissement Google du marchand cible. Si aucun magasin correspondant n'est trouvé, les inventaires ou les ventes indiqué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 souhaitez soumettre la boutique.

store_code

string

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

store_address

string

Obligatoire. Adresse postale du magasin. Exemple: 1600 Amphitheatre Pkwy, 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 mise en correspondance avec une fiche d'établissement Google. Si aucune correspondance n'est trouvée, consultez matchingStateHint pour en savoir plus.

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é. Il n'est défini que si 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": l'établissement LfpStore fourni n'a pu être associé à aucun magasin de la fiche d'établissement Google associé. Le compte Merchant Center est correctement associé, et des magasins sont disponibles dans la fiche d'établissement Google. Cependant, l'adresse de l'établissement LfpStore ne correspond pas à celle des magasins de la fiche. Modifiez l'adresse LfpStore ou celle du magasin de la fiche d'établissement Google afin qu'elle corresponde correctement.
  • "store-match-unverified": l'LfpStore fourni n'a pu être associé à aucun des magasins de la fiche d'établissement Google associés, car le magasin de la fiche d'établissement Google correspondante n'a pas été validé. Suivez la procédure de validation des fiches d'établissement Google pour les faire correspondre.

StoreMatchingState

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

Enums
STORE_MATCHING_STATE_UNSPECIFIED État de mise en correspondance des magasins non spécifié.
STORE_MATCHING_STATE_MATCHED Le LfpStore a bien été associé à une fiche d'établissement Google.
STORE_MATCHING_STATE_FAILED L'LfpStore ne correspond à aucune boutique de 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 répertorier les magasins.

page_size

int32

Facultatif. Nombre maximal de ressources LfpStore à renvoyer pour le compte donné. Le service renvoie une valeur inférieure à cette valeur si le nombre de magasins pour le compte donné est inférieur à pageSize. La valeur par défaut est 250. La valeur maximale est 1 000. Si une valeur supérieure au maximum est spécifiée, pageSize utilise la valeur maximale par défaut.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListLfpStoresRequest 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 à ListLfpStoresRequest doivent correspondre à l'appel qui a fourni le jeton de page. Jeton renvoyé en tant que 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.