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 de confiance, qui peut les partager avec Google. Pour obtenir la liste des partenaires pour les données acceptés, 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 coordonnées dans le formulaire Commentaires du fournisseur de données de point de vente pour afficher les produits 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 lfpMerchantStates.get pour récupérer l'état des propriétés au niveau du marchand liées à l'intégration du partenariat pour 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": "{TARGET_MERCHANT_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.
  • {TARGET_MERCHANT_ID} : ID de compte de l'établissement pour lequel vous souhaitez envoyer l'inventaire.

La réponse suivante devrait s'afficher :

{
 "name": "accounts/{ACCOUNT_ID}/lfpInventories/{TARGET_MERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGET_MERCHANT_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 promotion

Pour insérer une promotion, 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": "{TARGET_MERCHANT_ID}"
}

Remplacez les éléments suivants :

  • {TARGET_MERCHANT_ID} : ID de compte de l'établissement pour lequel envoyer la vente.

La réponse suivante devrait s'afficher :

{
 "name": "accounts/{ACCOUNT_ID}/lfpSales/{UUID}",
 "targetAccount": "{TARGET_MERCHANT_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": "{TARGET_MERCHANT_ID}"
}

Remplacez les éléments suivants :

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

La réponse suivante devrait s'afficher :

{
 "name": "accounts/{ACCOUNT_ID}/lfpStores/{TARGET_MERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "{TARGET_MERCHANT_ID}",
 "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.