Vous pouvez utiliser l'API Merchant pour partager vos données d'inventaire, de magasins et de ventes avec Google afin d'améliorer votre visibilité et votre gestion.
Nouvelles fonctionnalités
En plus des fonctionnalités de Content API, l'API Merchant propose les nouvelles fonctionnalités suivantes :
- Une méthode permettant de récupérer l'état des propriétés au niveau de l'établissement liées à l'intégration du partenariat pour les flux en magasin
- Une méthode permettant d'envoyer une notification à un revendeur
Pour en savoir plus sur ces méthodes, consultez la section API du partenariat pour les flux en magasin.
Requêtes
Utilisez le format d'URL de requête suivant pour l'API du partenariat pour les flux en magasin :
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
Pour en savoir plus, consultez la section Méthode : accounts.lfpInventories.insert.
Voici un exemple de comparaison entre Content API for Shopping et l'API du partenariat pour les flux en magasin pour la requête permettant d'insérer un inventaire :
| Content API | API Merchant | |
| URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
|
| Identifiants |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}
|
{PARENT} |
Voici un exemple de comparaison entre Content API for Shopping et l'API du partenariat pour les flux en magasin pour la requête permettant d'insérer une vente :
| Content API | API Merchant | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
| Identifiants | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Voici un exemple de comparaison entre Content API for Shopping et l'API du partenariat pour les flux en magasin pour la requête permettant d'insérer un magasin :
| Content API | API Merchant | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpStores:insert |
| Identifiants | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Méthodes
Voici les modifications apportées aux méthodes de l'API Store dans l'API du partenariat pour les flux en magasin :
| Méthode | URL dans Content API for Shopping | URL dans l'API Merchant | Identifiants dans Content API for Shopping | Identifiants dans l'API Merchant | Description |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent est au format accounts/{IFP_PARTNER_ACCOUNT_ID} |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
DELETE https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name est au format accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE} |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
GET https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name est au format accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE} |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
GET https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} est au format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Voici les modifications apportées aux méthodes de l'API Inventory dans l'API du partenariat pour les flux en magasin :
| Méthode | URL dans Content API for Shopping | URL dans l'API Merchant | Identifiants dans Content API for Shopping | Identifiants dans l'API Merchant | Description |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent est au format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Voici les modifications apportées aux méthodes de l'API Sales dans l'API du partenariat pour les flux en magasin :
| Méthode | URL dans Content API for Shopping | URL dans l'API Merchant | Identifiants dans Content API for Shopping | Identifiants dans l'API Merchant | Description |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} est au format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Ressources
Voici les modifications apportées à la ressource Store dans l'API du partenariat pour les flux en magasin. Les champs non inclus ici restent inchangés.
| Content API for Shopping | API Merchant | Description |
| Non compatible | name: string |
Ajout d'un nouveau champ pour différencier les magasins |
| Non compatible | targetAccount: integer |
Compte Merchant Center dans lequel insérer les inventaires |
targetCountry: string |
regionCode: string |
targetCountry a été renommé regionCode |
websiteUrl: string |
websiteUri: string |
websiteUrl a été renommé websiteUri |
kind: string |
Non compatible | kind n'est pas compatible avec l'API du partenariat pour les flux en magasin |
Voici les modifications apportées à l'insertion d'un inventaire. Les champs non inclus ici restent inchangés.
| Content API for Shopping | API Merchant | Description |
| Non compatible | name: string |
Ajout d'un nouveau champ pour différencier les inventaires |
| Non compatible | targetAccount: integer |
Compte Merchant Center dans lequel insérer les inventaires. |
targetCountry: string |
regionCode: string |
targetCountry a été renommé regionCode. Code CLDR du pays dans lequel le produit est vendu. |
itemId: string |
offerId: string |
itemId a été renommé offerId |
quantity: string |
quantity: string |
quantity est désormais facultatif |
| Non compatible | availability: string |
availability est obligatoire |
|
|
La définition du prix a changé. Pour en savoir plus, consultez la section Prix. |
timestamp: string |
collectionTime: string |
timestamp a été renommé collectionTime |
kind: string |
Non compatible | kind n'est pas compatible avec l'API du partenariat pour les flux en magasin. |
Voici les modifications apportées à l'insertion d'une vente. Les champs non inclus ici restent inchangés.
| Content API for Shopping | API Merchant | Description |
| Non compatible | name: string |
Ajout d'un nouveau champ pour différencier les inventaires |
| Non compatible | targetAccount:integer |
Compte Merchant Center dans lequel insérer les ventes |
targetCountry: string |
regionCode: string |
Code CLDR du pays dans lequel le produit est vendu. |
itemId: string |
offerId: string |
itemId a été renommé offerId |
|
|
La définition du prix a changé. Pour en savoir plus, consultez la section Prix. |
timestamp: string |
saleTime: string |
timestamp a été renommé saleTime |
kind: string |
Non compatible | kind n'est pas compatible avec l'API du partenariat pour les flux en magasin. |