Partnerschafts-API für lokale Feeds

Mit dem Partnerprogramm 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 einem vertrauenswürdigen Datenanbieter zur Verfügung stellen, der diese Informationen an Google weitergeben kann. Eine Liste der unterstützten Datenpartner finden Sie im Hilfeartikel Partnerprogramm für lokale Feeds.

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

Wenn Sie Ihren Inventardatenanbieter dem Merchant Center hinzufügen möchten, geben Sie Ihre Daten unter Feedback zum Datenanbieter für Point-of-Sale-Daten ein, um lokale Produkte auf Google zu präsentieren.

Informationen zur Migration von der Content API for Shopping finden Sie im Hilfeartikel Migration des Partnerprogramms für lokale Feeds.

Onboarding-Status eines Einzelhändlers abrufen

Mit der Methode lfpMerchantStates.get können Sie den Status der Eigenschaften auf Händlerebene abrufen, die mit der Integration des Partnerprogramms 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 ID des Produkts.
  • {STORE_CODE}: Die ID des Geschäfts des Händlers.
  • {TARGETMERCHANT_ID}: Die Konto-ID des Unternehmens, für das Sie das Inventar einreichen möchten.

Die Antwort sieht in etwa so aus:

{
 "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 ein Angebot 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 Sie das Angebot einreichen möchten.

Die Antwort sieht in etwa so aus:

{
 "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 ID des Geschäfts.
  • {TARGETMERCHANT_ID}: Die Konto-ID des Unternehmens, für das Sie das Geschäft einreichen möchten.

Die Antwort sieht in etwa so aus:

{
 "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 Einzelhändler eine Onboarding-Benachrichtigung 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 ID 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 können Sie nur den Stringwert ONBOARDING_UI übergeben.