Vous pouvez utiliser l'API Merchant pour partager vos inventaires, vos magasins et vos données de ventes avec Google afin d'améliorer leur visibilité et leur 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'établissement liées à l'intégration du partenariat pour les flux locaux
- Méthode permettant d'envoyer une notification à un marchand
Pour en savoir plus sur ces méthodes, consultez 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 de produits en magasin pour la requête d'insertion d'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 de partenariat pour les flux de produits en magasin 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 les modifications apportées aux méthodes de l'API Store 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=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 les modifications apportées aux méthodes de l'API Inventory dans l'API du programme de partenariat pour 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 les modifications apportées aux 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 Local Feeds Partnership. Les champs non inclus ici ne sont pas modifiés.
| Content API for Shopping | API Merchant | Description |
| Non autorisé | name: string |
Ajout d'un champ pour différencier les magasins |
| Non autorisé | targetAccount: integer |
Compte Merchant Center pour lequel insérer des inventaires |
targetCountry: string |
regionCode: string |
Remplacement du nom targetCountry par regionCode. |
websiteUrl: string |
websiteUri: string |
Remplacement du nom websiteUrl par websiteUri. |
kind: string |
Non autorisé | kind n'est pas compatible avec l'API de partenariat pour les flux de produits en magasin |
Voici ce qui a changé pour l'insertion d'un inventaire. Les champs non inclus ici ne sont pas modifiés.
| Content API for Shopping | API Merchant | Description |
| Non autorisé | name: string |
Ajout d'un champ pour différencier les inventaires |
| Non autorisé | targetAccount: integer |
Compte Merchant Center pour lequel insérer des inventaires. |
targetCountry: string |
regionCode: string |
Le compte de service (targetCountry) a été renommé regionCode. Code de territoire CLDR du pays dans lequel le produit est vendu. |
itemId: string |
offerId: string |
Remplacement du nom itemId par offerId. |
quantity: string |
quantity: string |
quantity a été mis à jour pour être facultatif |
| Non autorisé | 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 autorisé | kind n'est pas compatible avec l'API de partenariat pour les flux de produits en magasin. |
Voici ce qui a changé pour l'insertion d'une vente. Les champs non inclus ici ne sont pas modifiés.
| Content API for Shopping | API Merchant | Description |
| Non autorisé | name: string |
Ajout d'un champ pour différencier les inventaires |
| Non autorisé | targetAccount:integer |
Compte Merchant Center pour lequel insérer des ventes. |
targetCountry: string |
regionCode: string |
Code de territoire CLDR du pays dans lequel 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 autorisé | kind n'est pas compatible avec l'API de partenariat pour les flux de produits en magasin. |