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

price: {

object (Price)

}

price: {

object (Price)

}

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

price: {

object (Price)

}

price: {

object (Price)

}

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.