Local Feeds Partnership API

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 Inventarinformationen einem vertrauenswürdigen Datenanbieter zur Verfügung stellen, der diese Informationen dann an Google weitergibt. Eine Liste der unterstützten Datenpartner finden Sie unter Das Partnerprogramm für lokale Feeds.

Sie können lokales Inventar hinzufügen, indem Sie einen Feed mit lokalem Inventar hochladen.

Wenn Sie Ihren Inventar-Datenanbieter dem Merchant Center hinzufügen möchten, geben Sie Ihre Daten unter Feedback von Kassensystem-Datenanbietern, um lokale Produkte auf Google zu präsentieren an.

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

Onboarding-Status eines Einzelhändlers abrufen

Mit der Methode lfpMerchantStates.get können Sie den Status der Attribute auf Händlerebene abrufen, die sich auf die Integration der Local Feeds Partnership beziehen. Anhand der angegebenen Attribute können Sie prüfen, ob die Integration wie vorgesehen funktioniert oder ob zusätzliche Maßnahmen erforderlich sind.

GET https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpMerchantStates/{TARGET_MERCHANT_ID}

Inventar einfügen

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

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

Ersetzen Sie Folgendes:

  • {PARENT}: Das Format ist 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.
  • {TARGET_MERCHANT_ID}: Die Konto-ID des Unternehmens, für das Sie das Inventar einreichen möchten.

Sie sollten die folgende Antwort sehen:

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

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

Ersetzen Sie Folgendes:

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

Sie sollten die folgende Antwort sehen:

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

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

Geschäft einfügen

Verwenden Sie die folgende Anfrage, um ein Geschäft einzufügen:

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

Ersetzen Sie Folgendes:

  • {STORE_CODE}: Eine eindeutige Kennung des Speichers.
  • {TARGET_MERCHANT_ID}: Die Konto-ID des Unternehmens, für das das Geschäft eingereicht werden soll.

Sie sollten die folgende Antwort sehen:

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

Weitere Informationen finden Sie unter accounts.lfpStores.insert.

Benachrichtigung an einen Einzelhändler senden

Mit der Methode SendLfpNotification können Sie eine Benachrichtigung an einen Einzelhändler senden. Mit dieser Methode können Sie beispielsweise eine Onboarding-Benachrichtigung an den Einzelhändler senden.

POST https://merchantapi.googleapis.com/lfp/v1/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 Sie die Benachrichtigung senden möchten.
  • {EMAIL_ADDRESS}: Die E-Mail-Adresse des Kontos, an das Sie die Benachrichtigung senden möchten.
  • {TYPE}: Sie können in diesem Feld nur den Stringwert ONBOARDING_UI übergeben.