Vous pouvez utiliser Merchant API 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, Merchant API 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 d'insertion d'un inventaire :
| Content API | Merchant API | |
| 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 d'insertion d'une vente :
| Content API | Merchant API | |
| 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 d'insertion d'un magasin :
| Content API | Merchant API | |
| 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 Merchant API | Identifiants dans Content API for Shopping | Identifiants dans Merchant API | 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 Merchant API | Identifiants dans Content API for Shopping | Identifiants dans Merchant API | 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 Merchant API | Identifiants dans Content API for Shopping | Identifiants dans Merchant API | 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 | Merchant API | Description |
| Non autorisé | name: string |
Ajout d'un nouveau champ pour différencier les magasins |
| Non autorisé | 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 autorisé | kind n'est pas autorisé dans 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 | Merchant API | Description |
| Non autorisé | name: string |
Ajout d'un nouveau champ pour différencier les inventaires |
| Non autorisé | 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 autorisé | 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 autorisé | kind n'est pas autorisé dans 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 | Merchant API | Description |
| Non autorisé | name: string |
Ajout d'un nouveau champ pour différencier les inventaires |
| Non autorisé | 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 autorisé | kind n'est pas autorisé dans l'API du partenariat pour les flux en magasin |