API Local Feeds Partnership

Ce programme permet aux marchands de diffuser des annonces produits en magasin et des fiches produit locales gratuites 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 acceptés, consultez À propos du programme de partenariat pour les flux en magasin.

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

Pour que votre fournisseur de données d'inventaire soit ajouté à Merchant Center, fournissez vos informations sur la page Commentaires sur les fournisseurs de données de points de vente pour présenter des produits locaux 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 lfpMerchantStates.get pour récupérer l'état des propriétés au niveau du marchand liées à l'intégration du partenariat avec les 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/v1/accounts/{ACCOUNT_ID}/lfpMerchantStates/{TARGET_MERCHANT_ID}

Insérer un inventaire

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

POST https://merchantapi.googleapis.com/lfp/v1/{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}"
}

Remplacez les éléments suivants :

  • {PARENT} : le format est accounts/{ACCOUNT_ID}, où {ACCOUNT_ID} est l'identifiant unique du compte Merchant Center.
  • {OFFER_ID} : identifiant unique du produit.
  • {STORE_CODE} : identifiant du magasin du marchand.
  • {TARGETMERCHANT_ID} : ID du compte de l'établissement pour lequel vous souhaitez envoyer l'inventaire.

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/v1/{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}"
}

Remplacez les éléments suivants :

  • {TARGETMERCHANT_ID} : ID du compte de l'établissement pour lequel la vente doit être envoyée.

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/v1/{PARENT}/lfpStores:insert

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

Remplacez les éléments suivants :

  • {STORE_CODE} : identifiant unique du magasin.
  • {TARGETMERCHANT_ID} : ID du compte de l'établissement pour lequel envoyer le magasin.

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 page 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/v1/accounts/{ACCOUNT_ID}/lfpNotifications:send

{
  "target_account": {TARGETMERCHANT_ID},
  "email_address": {EMAIL_ADDRESS},
  "type": {TYPE}
}

Remplacez les éléments suivants :

  • {ACCOUNT_ID} : identifiant unique de votre compte Merchant Center.
  • {TARGETMERCHANT_ID} : identifiant unique du compte auquel vous souhaitez envoyer la notification.
  • {EMAIL_ADDRESS} : 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.