Interfejs API współpracy z plikami danych o asortymencie lokalnym

Program partnerski danych o asortymencie lokalnym umożliwia sprzedawcom wyświetlanie reklam lokalnego asortymentu produktów oraz bezpłatnych lokalnych informacji o produktach bez konieczności tworzenia podstawowych plików danych oraz plików danych o asortymencie produktów dostępnych lokalnie. Sprzedawcy mogą przekazywać informacje o sprzedaży i asortymencie zaufanemu dostawcy danych, który może udostępniać te informacje Google. Listę obsługiwanych partnerów danych znajdziesz w artykule Informacje o programie partnerskim danych o asortymencie lokalnym.

Możesz dodać asortyment produktów dostępnych lokalnie, przesyłając plik danych o asortymencie produktów dostępnych lokalnie.

Aby dodać dostawcę danych o asortymencie do Merchant Center, podaj swoje dane w sekcji Opinie dostawcy danych z punktów sprzedaży, aby wyświetlać lokalne produkty w Google.

Więcej informacji o migracji z Content API for Shopping znajdziesz w artykule Migracja programu partnerskiego dotyczącego lokalnych plików danych.

Pobieranie stanu wprowadzania sprzedawcy

Możesz użyć metody lfpMerchantStates.get, aby pobrać stan właściwości na poziomie sprzedawcy związanych z integracją partnerstwa w zakresie plików danych lokalnych. Na podstawie podanych właściwości możesz sprawdzić, czy integracja działa zgodnie z oczekiwaniami, i określić, czy są wymagane dodatkowe działania.

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

Wstawianie asortymentu

Aby wstawić zasoby reklamowe, użyj tego żądania:

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

Zastąp następujące elementy:

  • {PARENT}: format to accounts/{ACCOUNT_ID}, gdzie {ACCOUNT_ID} to unikalny identyfikator konta Merchant Center.
  • {OFFER_ID}: unikalny identyfikator produktu.
  • {STORE_CODE}: identyfikator sklepu sprzedawcy.
  • {TARGETMERCHANT_ID}: identyfikator konta firmy, dla której chcesz przesłać asortyment.

Powinna pojawić się taka odpowiedź:

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

Więcej informacji znajdziesz w artykule Metoda: accounts.lfpInventories.insert.

Wstawianie promocji

Aby wstawić sprzedaż, użyj tego żądania:

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

Zastąp następujące elementy:

  • {TARGETMERCHANT_ID}: identyfikator konta firmy, dla której ma zostać przesłana sprzedaż.

Powinna pojawić się taka odpowiedź:

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

Więcej informacji znajdziesz w artykule Metoda: accounts.lfpSales.insert.

Wstawianie sklepu

Aby wstawić sklep, użyj tego żądania:

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

Zastąp następujące elementy:

  • {STORE_CODE}: unikalny identyfikator sklepu.
  • {TARGETMERCHANT_ID}: Identyfikator konta firmy, dla której ma zostać przesłany sklep.

Powinna pojawić się taka odpowiedź:

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

Więcej informacji znajdziesz w sekcji accounts.lfpStores.insert.

Wysyłanie powiadomienia do sprzedawcy

Możesz użyć metody SendLfpNotification, aby wysłać powiadomienie do sprzedawcy. Możesz na przykład użyć tej metody, aby wysłać sprzedawcy powiadomienie o wprowadzeniu do programu.

POST https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpNotifications:send

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

Zastąp następujące elementy:

  • {ACCOUNT_ID}: unikalny identyfikator konta Merchant Center.
  • {TARGETMERCHANT_ID}: unikalny identyfikator konta, na które chcesz wysłać powiadomienie.
  • {EMAIL_ADDRESS}: adres e-mail konta, na które chcesz wysłać powiadomienie.
  • {TYPE}: w tym polu możesz przekazać tylko wartość ciągu tekstowego ONBOARDING_UI.