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.

Damit Ihr Inventardatenanbieter dem Merchant Center hinzugefügt wird, müssen Sie unter Feedback für Datenanbieter von Kassensystemen zur Präsentation lokal verfügbarer Produkte auf Google Ihre Details angeben.

Informationen zur Migration von der Content API for Shopping finden Sie unter Partnerschaft für lokale Feeds migrieren.

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

Ersetzen Sie Folgendes:

  • {PARENT}: Das Format lautet accounts/{ACCOUNT_ID}, wobei {ACCOUNT_ID} die eindeutige Kennung des Merchant Center-Kontos ist.
  • {OFFER_ID}: Die eindeutige Kennung des Produkts.
  • {STORE_CODE}: Die Kennung des Geschäfts des Händlers.
  • {TARGETMERCHANT_ID}: Die Konto-ID des Unternehmens, für das Sie das Inventar einreichen möchten.

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

Ersetzen Sie Folgendes:

  • {TARGETMERCHANT_ID}: Die Konto-ID des Unternehmens, für das der Verkauf eingereicht werden soll.

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

Ersetzen Sie Folgendes:

  • {STORE_CODE}: Eine eindeutige Kennung des Geschäfts.
  • {TARGETMERCHANT_ID}: Die Konto-ID des Unternehmens, für das der Store eingereicht werden soll.

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

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

Ersetzen Sie Folgendes:

  • {ACCOUNT_ID}: Die eindeutige Kennung Ihres Merchant Center-Kontos.
  • {TARGETMERCHANT_ID}: Die eindeutige Kennung des Kontos, an das die Benachrichtigung gesendet werden soll.
  • {EMAIL_ADDRESS}: 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.