API Local Feeds Partnership

Ce programme permet aux marchands de diffuser des annonces produits en magasin et des fiches produit locales sans avoir à créer leurs propres flux principal et d'inventaire de produits en magasin. Les marchands peuvent fournir leurs informations sur les ventes et l'inventaire à un fournisseur de données fiable qui peut les partager avec Google. Pour obtenir la liste des partenaires de données compatibles, consultez À propos du programme de partenariat pour les flux en magasin.

Vous pouvez ajouter un inventaire de produits en magasin en important un flux d'inventaire de produits en magasin.

Pour ajouter votre fournisseur de données d'inventaire à Merchant Center, indiquez vos informations dans Commentaires sur le fournisseur de données de point de vente pour présenter des produits vendus en magasin sur Google.

Pour en savoir plus sur la migration depuis Content API for Shopping, consultez Migrer le partenariat pour les flux en magasin.

Récupérer l'état d'intégration d'un marchand

Vous pouvez utiliser la méthode GetLfpState pour récupérer l'état des propriétés au niveau du marchand liées à l'intégration du partenariat de flux locaux. En fonction des propriétés fournies, vous pouvez vérifier si l'intégration fonctionne comme prévu ou si une action supplémentaire est requise.

GET https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpState/{TARGET_MERCHANT_ID}

Insérer un inventaire

Pour insérer un inventaire, utilisez la requête suivante:

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert

{
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "{OFFER_ID}",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "regionCode": "US",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

La réponse suivante devrait s'afficher:

{
 "name": "accounts/{merchantId}/lfpInventories/{TARGETMERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "{OFFER_ID}",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "feedLabel": "US"
}

Pour en savoir plus, consultez Méthode : accounts.lfpInventories.insert.

Insérer une vente

Pour insérer une vente, utilisez la requête suivante:

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert

{
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "offerId",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": 2,
 "regionCode": "US",
 "saleTime": "2024-01-08T08:00:00Z",
 "storeCode": "123",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

La réponse suivante devrait s'afficher:

{
 "name": "accounts/1000005718521947/lfpSales/{UUID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "offerId",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": "2",
 "saleTime": "2024-01-08T08:00:00Z",
 "uid": "{UUID}",
 "feedLabel": "US"
}

Pour en savoir plus, consultez Méthode : accounts.lfpSales.insert.

Insérer un magasin

Pour insérer un magasin, utilisez la requête suivante:

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

La réponse suivante devrait s'afficher:

{
 "name": "accounts/{MERCHANT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "1000005718454644",
 "storeCode": "{STORE_CODE}",
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "matchingState": "STORE_MATCHING_STATE_MATCHED"
}

Pour en savoir plus, consultez la section Méthode : accounts.lfpStores.insert.

Envoyer une notification à un marchand

Vous pouvez utiliser la méthode SendLfpNotification pour envoyer une notification à un marchand. Par exemple, vous pouvez utiliser cette méthode pour envoyer une notification d'intégration au marchand.

POST https://merchantapi.googleapis.com/lfp/v1beta/accounts/{accountId}/lfpNotifications:send

{
  "target_account": {targetMerchantId},
  "email_address": {emailAddress},
  "type": {Type}
}

Remplacez les éléments suivants :

• {accountId}: identifiant unique de votre compte Merchant Center
• {targetMerchantId}: identifiant unique du compte auquel vous souhaitez envoyer la notification
• {emailAddress}: adresse e-mail du compte auquel vous souhaitez envoyer la notification
• {Type}: vous ne pouvez transmettre que la valeur de chaîne ONBOARDING_UI dans ce champ.