Aby zwiększyć widoczność i ułatwić zarządzanie, możesz udostępnić Google dane o asortymentach, sklepach i sprzedaży za pomocą interfejsu Merchant API.
Nowe funkcje
Oprócz funkcji Content API interfejs Merchant API oferuje te nowe funkcje:
- Metoda umożliwiająca odzyskiwanie stanu właściwości na poziomie sprzedawcy związanych z integracją z programem partnerskim danych o asortymencie lokalnym
- Sposób wysyłania powiadomienia do sprzedawcy
Szczegółowe informacje o tych metodach znajdziesz w interfejsie API programu partnerskiego danych o asortymencie lokalnym.
Żądania
W przypadku interfejsu API partnerskiego dotyczącego lokalnych plików danych używaj tego formatu adresu URL żądania:
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
Więcej informacji znajdziesz w metodzie accounts.lfpInventories.insert.
Oto przykładowe porównanie interfejsu Content API for Shopping z interfejsem partnerskim interfejsu API dotyczących plików danych lokalnych w przypadku żądania wstawiania asortymentu:
| Content API. | Interfejs API sprzedawcy | |
| URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
|
| Identyfikatory |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}
|
{PARENT} |
Oto przykładowe porównanie interfejsu Content API for Shopping z interfejsem partnerskim lokalnych plików danych w przypadku żądania wstawiania sprzedaży:
| Content API. | Interfejs API sprzedawcy | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert |
| Identyfikatory | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Oto przykładowe porównanie Content API for Shopping z interfejsem partnerskim lokalnych plików danych w przypadku żądania wstawiania sklepu:
| Content API. | Interfejs API sprzedawcy | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert |
| Identyfikatory | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Metody
Oto zmiany w metodach interfejsu API sklepu w interfejsie API partnera danych o asortymencie lokalnym:
| Metoda | Adres URL w Content API for Shopping | Adres URL w interfejsie 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/v1beta/{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/v1beta/{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/v1beta/{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/v1beta/{parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} ma format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Co się zmieniło w przypadku metod interfejsu Inventory API w interfejsie API partnerskiego programu danych o asortymencie lokalnym:
| Metoda | Adres URL w Content API for Shopping | Adres URL w interfejsie 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/v1beta/{PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent ma format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Oto, co się zmieniło w przypadku metod interfejsu API sprzedaży w interfejsie API partnera lokalnych plików danych:
| Metoda | Adres URL w Content API for Shopping | Adres URL w interfejsie 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/v1beta/{PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} ma format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Zasoby
Oto, co się zmieniło w zasobach sklepu w usłudze API dla partnerów danych o asortymencie lokalnym. Pola, których tu nie ma, pozostają bez zmian.
| Content API for Shopping | Interfejs API sprzedawcy | Opis |
| Nieobsługiwane | name: string |
Dodano nowe pole, aby odróżnić różne sklepy |
| Nieobsługiwane | targetAccount: integer |
Konto sprzedawcy, na którym chcesz wstawić asortyment |
targetCountry: string |
regionCode: string |
Zmieniono nazwę z targetCountry na regionCode |
websiteUrl: string |
websiteUri: string |
Zmieniono nazwę z websiteUrl na websiteUri |
kind: string |
Nieobsługiwane | Interfejs kind nie jest obsługiwany w interfejsie API partnerskim danych o asortymencie lokalnym |
Oto, co się zmieniło w przypadku wstawiania zasobów reklamowych. Pola, których tu nie ma, pozostają bez zmian.
| Content API for Shopping | Interfejs API sprzedawcy | Opis |
| Nieobsługiwane | name: string |
Dodaliśmy nowe pole, aby odróżnić różne zasoby reklamowe |
| Nieobsługiwane | targetAccount: integer |
Konto sprzedawcy, na którym chcesz wstawić zasoby reklamowe. |
targetCountry: string |
regionCode: string |
Nazwę konta usługi targetCountry zmieniono na regionCode. Kod CLDR kraju, w którym sprzedawany jest produkt. |
itemId: string |
offerId: string |
Zmieniono nazwę z itemId na offerId |
quantity: string |
quantity: string |
Wartość „quantity” została zaktualizowana i jest teraz opcjonalna |
| Nieobsługiwane | availability: string |
Pole availability jest wymagane |
|
|
Zmieniła się definicja ceny. Więcej informacji znajdziesz w sekcji Cena. |
timestamp: string |
collectionTime: string |
Zmieniono nazwę z timestamp na collectionTime |
kind: string |
Nieobsługiwane | Interfejs kind nie jest obsługiwany w interfejsie API partnerskiego programu danych o asortymencie lokalnym. |
Oto, co się zmieniło w przypadku wstawiania sprzedaży. Pola, których tu nie ma, pozostają bez zmian.
| Content API for Shopping | Interfejs API sprzedawcy | Opis |
| Nieobsługiwane | name: string |
Dodaliśmy nowe pole, aby odróżnić różne zasoby reklamowe |
| Nieobsługiwane | targetAccount:integer |
Konto sprzedawcy, dla którego chcesz wstawić dane o sprzedaży |
targetCountry: string |
regionCode: string |
Kod CLDR kraju, w którym sprzedawany jest produkt. |
itemId: string |
offerId: string |
Zmieniono nazwę z itemId na offerId |
|
|
Zmieniła się definicja ceny. Więcej informacji znajdziesz w sekcji Cena. |
timestamp: string |
saleTime: string |
Zmieniono nazwę z timestamp na saleTime |
kind: string |
Nieobsługiwane | Interfejs kind nie jest obsługiwany w interfejsie API partnerskiego programu danych o asortymencie lokalnym. |