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 de données compatibles, consultez À propos du programme de partenariat pour les flux locaux .

Vous pouvez ajouter un 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 dans Commentaires sur le fournisseur de données de point de vente pour afficher des produits locaux sur Google.

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

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": "{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} : l'identifiant unique du produit.
  • {STORE_CODE} : l'identifiant du magasin du marchand.
  • {TARGETMERCHANT_ID} : l'ID de compte de l' entreprise pour laquelle vous souhaitez envoyer l'inventaire.

Vous devriez voir la réponse suivante :

{
 "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} : l'ID de compte de l' entreprise pour laquelle vous souhaitez envoyer la vente.

Vous devriez voir la réponse suivante :

{
 "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} : un identifiant unique du magasin.
  • {TARGETMERCHANT_ID} : l'ID de compte de l' entreprise pour laquelle vous souhaitez envoyer le magasin.

Vous devriez voir la réponse suivante :

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