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 Inventarinformationen an einen vertrauenswürdigen Datenanbieter weitergeben, der diese Informationen an Google weiterleiten kann. 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 Anbieter von Inventardaten dem Merchant Center hinzufügen möchten, geben Sie Ihre Daten unter Feedback zum Anbieter von Kassendaten für die Präsentation lokaler Produkte bei Google an.

Weitere 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 mit der Integration der Partnerschaft für lokale Feeds zusammenhängen. Anhand der bereitgestellten Eigenschaften 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": "{TARGETMERCHANT_ID}"
}

Ersetzen Sie Folgendes:

  • {PARENT}: Das Format ist accounts/{ACCOUNT_ID}, wobei {ACCOUNT_ID} die eindeutige ID 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 Sale 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": "{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 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": "{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 accounts.lfpStores.insert.

Benachrichtigung an einen Einzelhändler senden

Mit der Methode SendLfpNotification können Sie eine Benachrichtigung an einen Einzelhändler senden. Sie können diese Methode beispielsweise verwenden, um dem Händler eine Benachrichtigung zur Einrichtung zu 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 ID 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}: In diesem Feld kann nur der Stringwert ONBOARDING_UI übergeben werden.