Partnerschafts-API für lokale Feeds

Im Rahmen des Partnerprogramms für lokale Feeds können Einzelhändler Anzeigen für lokales Inventar und lokale Produkteinträge nutzen, ohne eigene Hauptfeeds oder Feeds mit lokalem Inventar erstellen zu müssen. Einzelhändler können ihre Verkaufs- und Inventardaten an einen vertrauenswürdigen Datenanbieter weitergeben, der diese Daten an Google weitergeben kann. Eine Liste der unterstützten Datenpartner finden Sie im Hilfeartikel Das Partnerprogramm für lokale Feeds.

Sie können lokales Inventar hinzufügen, indem Sie einen Feed mit lokalem Inventar hochladen. Der Feed mit lokalem Inventar enthält eine Liste der Artikel, die im Geschäft verkauft werden können, mit Attributen zur Beschreibung der Artikel.

Wenn Sie Ihren Inventardatenanbieter dem Merchant Center hinzufügen möchten, füllen Sie dieses Formular aus.

Onboarding-Status eines Einzelhändlers abrufen

Mit der Methode GetLfpState können Sie den Status der Properties auf Händlerebene abrufen, die sich auf die Integration der Partnerschaft für lokale Feeds beziehen. Anhand der bereitgestellten Properties können Sie prüfen, ob die Integration wie vorgesehen funktioniert oder ob weitere Maßnahmen erforderlich sind.

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

Inventar einfügen

Verwenden Sie die folgende Anfrage, um Inventar einzufügen:

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}"
}

Sie sollten die folgende Antwort sehen:

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

Weitere Informationen finden Sie unter Methode: accounts.lfpInventories.insert.

Angebot einfügen

Verwenden Sie die folgende Anfrage, um einen Verkauf einzufügen:

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}"
}

Sie sollten die folgende Antwort sehen:

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

Weitere Informationen finden Sie unter Methode: accounts.lfpSales.insert.

Geschäft einfügen

Verwenden Sie die folgende Anfrage, um einen Shop einzufügen:

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}"
}

Sie sollten die folgende Antwort sehen:

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

Weitere Informationen finden Sie unter Methode: accounts.lfpStores.insert.

Benachrichtigung an einen Händler senden

Mit der Methode SendLfpNotification kannst du eine Benachrichtigung an einen Einzelhändler senden. Mit dieser Methode können Sie beispielsweise eine Einrichtungsbenachrichtigung an den Händler senden.

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

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

Ersetzen Sie Folgendes:

  • {accountId}: Die eindeutige Kennung Ihres Merchant Center-Kontos
  • {targetMerchantId}: Die eindeutige Kennung des Kontos, an das die Benachrichtigung gesendet werden soll
  • {emailAddress}: Die E-Mail-Adresse des Kontos, an das die Benachrichtigung gesendet werden soll
  • {Type}: In diesem Feld kann nur der Stringwert ONBOARDING_UI übergeben werden.