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 dotyczącym 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 API do zarządzania lokalnym plikiem danych dla żądania wstawienia asortymentu:
Content API. | Interfejs API sprzedawcy | |
URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpInventories:insert
|
Identyfikatory |
{merchantId}/pos/ {targetMerchantId}
|
{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/ {merchantId}/pos/ {targetMerchantId}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpSales:insert |
Identyfikatory | {merchantId}/pos/ {targetMerchantId} |
{parent} |
Oto przykładowe porównanie interfejsu Content API for Shopping z interfejsem partnerskim partnerów dotyczących plików danych lokalnych w przypadku żądania wstawiania sklepu:
Content API. | Interfejs API sprzedawcy | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpStores:insert |
Identyfikatory | {merchantId}/pos/ {targetMerchantId} |
{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 Merchant API | Identyfikatory w Content API for Shopping | Identyfikatory w Merchant API | Opis |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent=accounts/*}/lfpStores:insert |
/pos {merchantId}/{targetMerchantId} |
{parent} | parent ma format accounts/{lfpPartnerAccountId} |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
DELETE https://merchantapi.googleapis.com/lfp/v1beta/ {name=accounts/*/lfpStores/*} |
{merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
{name} | name ma format accounts/ {lfpPartnerAccountId}/lfpStores/ {targetMerchantId}~{storeCode} |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
GET https://merchantapi.googleapis.com/lfp/v1beta/ {name=accounts/*/lfpStores/*} |
{merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
{name} | name ma format accounts/ {lfpPartnerAccountId}/lfpStores/ {targetMerchantId}~{storeCode} |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
GET https://merchantapi.googleapis.com/lfp/v1beta/ {parent=accounts/*}/lfpStores |
/{merchantId}/pos/ {targetMerchantId} |
{parent} | {parent} ma format accounts/ {lfpPartnerAccountId} |
Oto zmiany w metodach korzystania z interfejsu Inventory API w interfejsie API partnerskim plików danych o asortymencie lokalnym:
Metoda | Adres URL w Content API for Shopping | Adres URL w Merchant API | Identyfikatory w Content API for Shopping | Identyfikatory w Merchant API | Opis |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpInventories:insert |
{merchantId}/pos/ {targetMerchantId} |
{parent} | parent ma format accounts/ {lfpPartnerAccountId} |
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 Merchant API | Identyfikatory w Content API for Shopping | Identyfikatory w Merchant API | Opis |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpSales:insert |
{merchantId}/pos/ {targetMerchantId} |
{parent} | {parent} ma format accounts/ {lfpPartnerAccountId} |
Zasoby
Poniżej znajdziesz zmiany dotyczące zasobu sklepu w interfejsie API partnerskim plików danych o produktach dostępnych lokalnie. 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 sklepy |
Nieobsługiwane | targetAccount: integer |
Konto sprzedawcy, dla którego 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 sposobie 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 |
Komponent quantity został zaktualizowany i został opcjonalny |
Nieobsługiwane | availability: string |
Pole availability jest wymagane |
|
|
Zmieniła się definicja ceny. Więcej informacji znajdziesz w sekcji Cena. |
timestamp: string |
collectionTime: string |
Zmiana nazwy użytkownika 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 |
|
|
Definicja ceny uległa zmianie. Więcej informacji znajdziesz w sekcji Cena. |
timestamp: string |
saleTime: string |
Zmiana nazwy użytkownika z timestamp na saleTime |
kind: string |
Nieobsługiwane | Pole kind nie jest obsługiwane w interfejsie API do zarządzania plikami danych o asortymencie lokalnym. |