Migracja programu partnerskiego danych o asortymencie lokalnym

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

price: {

object (Price)

}

price: {

object (Price)

}

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

price: {

object (Price)

}

price: {

object (Price)

}

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.