Za pomocą interfejsu Merchant API możesz udostępniać Google dane o asortymencie, sklepach i sprzedaży, aby zwiększyć widoczność i ułatwić zarządzanie.
Nowe funkcje
Oprócz funkcji interfejsu Content API interfejs Merchant API oferuje te nowe funkcje:
- Metoda pobierania stanu właściwości na poziomie firmy związanych z integracją programu partnerskiego danych o asortymencie lokalnym.
- metodę wysyłania powiadomień do sprzedawcy,
Szczegółowe informacje o tych metodach znajdziesz w artykule API programu partnerskiego danych o asortymencie lokalnym.
Żądania
W przypadku interfejsu API partnera plików danych o produktach dostępnych lokalnie użyj tego formatu adresu URL żądania:
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
Więcej informacji znajdziesz w artykule Metoda: accounts.lfpInventories.insert.
Oto przykładowe porównanie interfejsu Content API for Shopping z interfejsem API partnera dotyczącym lokalnych plików danych w przypadku żądania wstawienia asortymentu:
| Content API. | Merchant API | |
| URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
|
| Identyfikatory |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}
|
{PARENT} |
Oto przykładowe porównanie interfejsu Content API for Shopping z interfejsem API partnera dotyczącym lokalnych plików danych w przypadku żądania wstawienia wyprzedaży:
| Content API. | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
| Identyfikatory | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Oto przykładowe porównanie Content API for Shopping z interfejsem API lokalnych plików danych w przypadku żądania wstawienia sklepu:
| Content API. | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpStores:insert |
| Identyfikatory | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Metody
Oto zmiany w metodach interfejsu API sklepu w interfejsie API programu partnerskiego danych o asortymencie lokalnym:
| Metoda | Adres URL w Content API for Shopping | URL w Merchant API | Identyfikatory w Content API for Shopping | Identyfikatory w Merchant API | Opis |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores:insert |
/pos {MERCHANT_ID}/{TARGETMERCHANT_ID} |
{PARENT} | parent ma format accounts/{IFP_PARTNER_ACCOUNT_ID} |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
DELETE https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name ma format accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE} |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
GET https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name ma format accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE} |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
GET https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} ma format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Oto zmiany w metodach interfejsu API asortymentu w interfejsie API programu partnerskiego danych o asortymencie lokalnym:
| Metoda | Adres URL w Content API for Shopping | URL w Merchant API | Identyfikatory w Content API for Shopping | Identyfikatory w Merchant API | Opis |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent ma format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Co się zmieniło w metodach interfejsu Sales API w ramach współpracy dotyczącej plików danych o produktach dostępnych lokalnie:
| Metoda | Adres URL w Content API for Shopping | URL w Merchant API | Identyfikatory w Content API for Shopping | Identyfikatory w Merchant API | Opis |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} ma format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Zasoby
Oto co się zmieniło w zasobie sklepu w interfejsie API programu partnerskiego danych o asortymencie lokalnym. Pola, które nie są tu uwzględnione, pozostaną bez zmian.
| Content API for Shopping | Merchant API | Opis |
| Nieobsługiwane | name: string |
Dodano nowe pole, aby odróżniać różne sklepy |
| Nieobsługiwane | targetAccount: integer |
Konto Merchant Center, na którym mają być wstawiane pliki danych o asortymencie |
targetCountry: string |
regionCode: string |
Nazwa targetCountry została zmieniona na regionCode |
websiteUrl: string |
websiteUri: string |
Nazwa websiteUrl została zmieniona na websiteUri |
kind: string |
Nieobsługiwane | kind nie jest obsługiwany w interfejsie API programu partnerskiego danych o asortymencie lokalnym. |
Oto co się zmieniło w przypadku wstawiania zasobów reklamowych. Pola, których tu nie wymieniono, pozostaną bez zmian.
| Content API for Shopping | Merchant API | Opis |
| Nieobsługiwane | name: string |
Dodano nowe pole, aby odróżniać różne zasoby reklamowe |
| Nieobsługiwane | targetAccount: integer |
Konto Merchant Center, na którym mają być wstawiane pliki danych o asortymencie. |
targetCountry: string |
regionCode: string |
Nazwę konta usługi targetCountry zmieniono na regionCode. Kod regionu CLDR kraju, w którym produkt jest sprzedawany. |
itemId: string |
offerId: string |
Nazwa itemId została zmieniona na offerId |
quantity: string |
quantity: string |
Pole quantity zostało zmienione na opcjonalne |
| Nieobsługiwane | availability: string |
Pole availability jest wymagane |
|
|
Zmieniła się definicja ceny. Więcej informacji znajdziesz w sekcji Cena. |
timestamp: string |
collectionTime: string |
Nazwa timestamp została zmieniona na collectionTime |
kind: string |
Nieobsługiwane | kind nie jest obsługiwany w interfejsie API programu partnerskiego danych o asortymencie lokalnym. |
Oto co się zmieniło w przypadku wstawiania sprzedaży. Pola, których tu nie wymieniono, pozostaną bez zmian.
| Content API for Shopping | Merchant API | Opis |
| Nieobsługiwane | name: string |
Dodano nowe pole, aby odróżniać różne zasoby reklamowe |
| Nieobsługiwane | targetAccount:integer |
Konto Merchant Center, na którym mają być wstawiane dane o sprzedaży. |
targetCountry: string |
regionCode: string |
Kod regionu CLDR kraju, w którym produkt jest sprzedawany. |
itemId: string |
offerId: string |
Nazwa itemId została zmieniona na offerId |
|
|
Zmieniła się definicja ceny. Więcej informacji znajdziesz w sekcji Cena. |
timestamp: string |
saleTime: string |
Nazwa timestamp została zmieniona na saleTime |
kind: string |
Nieobsługiwane | kind nie jest obsługiwany w interfejsie API programu partnerskiego danych o asortymencie lokalnym. |