Migracja programu partnerskiego danych o asortymencie lokalnym

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 artykule Metoda: accounts.lfpInventories.insert.

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 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 Content API for Shopping z interfejsem partnerskim danych o produktach w lokalnych plikach danych w żądaniu 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 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 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 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
price: { object (Price) }	price: { object (Price) }	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
price: { object (Price) }	price: { object (Price) }	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.