Vous pouvez utiliser l'API Merchant pour partager vos inventaires, vos magasins et vos données 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 :
- Méthode permettant de récupérer l'état des propriétés au niveau de l'entreprise liées à l'intégration du partenariat pour les flux en magasin
- Méthode permettant d'envoyer une notification à un marchand
Pour en savoir plus sur ces méthodes, consultez l'API Local Feeds Partnership.
Requêtes
Utilisez le format d'URL de requête suivant pour l'API Local Feeds Partnership :
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
Pour en savoir plus, consultez Méthode : accounts.lfpInventories.insert.
Voici un exemple de comparaison entre Content API for Shopping et l'API de partenariat pour les flux locaux pour la requête d'insertion d'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 de partenariat pour les flux locaux pour la requête d'insertion d'une promotion :
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 de partenariat pour les flux locaux pour la requête d'insertion d'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 ce qui a changé pour les méthodes de l'API Store dans l'API du partenariat sur les flux locaux :
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 |
/pos {MERCHANT_ID}/{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 ce qui a changé pour les méthodes de l'API d'inventaire dans l'API du programme Partenariat avec les flux locaux :
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 ce qui a changé pour les méthodes de l'API Sales dans l'API Local Feeds Partnership :
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 ce qui a changé pour la ressource "store" dans l'API du programme de 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 champ pour différencier les magasins |
Non compatible | targetAccount: integer |
Compte Merchant Center pour lequel insérer les stocks |
targetCountry: string |
regionCode: string |
Remplacement du nom targetCountry par regionCode . |
websiteUrl: string |
websiteUri: string |
Remplacement du nom websiteUrl par websiteUri . |
kind: string |
Non compatible | kind n'est pas compatible avec l'API Partenariat pour les flux de produits en magasin. |
Voici ce qui a changé pour 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 champ pour différencier les différents inventaires |
Non compatible | targetAccount: integer |
Compte Merchant Center pour lequel insérer les inventaires. |
targetCountry: string |
regionCode: string |
Le compte de service (targetCountry ) a été renommé regionCode . Code CLDR du pays où le produit est vendu. |
itemId: string |
offerId: string |
Remplacement du nom itemId par offerId . |
quantity: string |
quantity: string |
quantity est désormais facultatif |
Non compatible | availability: string |
Veuillez spécifier le champ availability |
|
|
La définition du prix a changé. Pour en savoir plus, consultez Prix. |
timestamp: string |
collectionTime: string |
Remplacement du nom timestamp par collectionTime . |
kind: string |
Non compatible | kind n'est pas compatible avec l'API de partenariat pour les flux locaux. |
Voici ce qui a changé concernant 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 champ pour différencier les différents inventaires |
Non compatible | targetAccount:integer |
Compte Merchant Center pour lequel insérer les ventes |
targetCountry: string |
regionCode: string |
Code CLDR du pays où le produit est vendu. |
itemId: string |
offerId: string |
Remplacement du nom itemId par offerId . |
|
|
La définition du prix a changé. Pour en savoir plus, consultez Prix. |
timestamp: string |
saleTime: string |
Remplacement du nom timestamp par saleTime . |
kind: string |
Non compatible | kind n'est pas compatible avec l'API de partenariat pour les flux locaux. |