Migracja ustawień reklam lokalnego asortymentu produktów

Jeśli używasz ustawień reklam lokalnego asortymentu produktów w Content API for Shopping, w Merchant API wprowadzono kilka ważnych zmian.

Ustawienia LIA należą teraz do jednego z 3 głównych komponentów, z których każdy ma powiązany zasób.

Podstawowy komponent Zasób
Konfiguracja konta na potrzeby wyświetlania reklam w wielu kanałach OmnichannelSetting
Połączenie z partnerem programu partnerskiego danych o asortymencie lokalnym w celu uzyskania danych o asortymencie LfpProvider
Połączenie z kontem Profilu Firmy w Google na potrzeby danych o sklepach lokalnych. GbpAccount

Dodatkowo w przypadku ustawień reklam lokalnego asortymentu produktów na konto przypadał jeden zasób, który zawierał listę ustawień dla każdego podmiotu krajowego. W OmnichannelSettings możesz powiązać z kontem wiele zasobów. Każdy zasób reprezentuje ustawienia konkretnego podmiotu krajowego.

Oto jak zmieniły się żądania i zasoby.

Żądania

Nowa domena Nazwa metody Content API Nazwa metody interfejsu Merchant API
accounts.omnichannelSettings liasettings.custombatch Ta metoda zostanie wycofana. Interfejs Merchant API umożliwia wysyłanie wielu żądań jednocześnie.
liasettings.get accounts.omnichannelSettings.list
liasettings.list Metoda pobierania wszystkich ustawień reklam lokalnego asortymentu produktów dla wszystkich subkont nie jest już bezpośrednio dostępna. Zamiast tego wyślij zapytanie o wszystkie subkonta i użyj metody accounts.omnichannelSettings.list, aby uzyskać omnichannelSettings dla tych, które Cię interesują.
liasettings.update accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
liasettings.requestinventoryverification accounts.omnichannelSettings.requestInventoryVerification
liasettings.setinventoryverificationcontact Ta metoda zostanie wycofana. Zamiast tego użyj accounts.omnichannelSettings.create lub accounts.omnichannelSettings.update ze zaktualizowaną maską.
liasettings.setomnichannelexperience Ta metoda zostanie wycofana. Zamiast tego użyj accounts.omnichannelSettings.create lub accounts.omnichannelSettings.update ze zaktualizowaną maską.
accounts.omnichannelSettings.lfpProvider liasettings.listposdataproviders accounts.omnichannelSettings.lfpProviders.findLfpProviders
liasettings.setposdataprovider accounts.omnichannelSettings.lfpProviders.linkLfpProvider
accounts.gbpAccount liasettings.getaccessiblegmbaccounts accounts.gbpAccount.list
liasettings.requestgmbaccess accounts.gbpAccount.linkGbpAccount

Zasoby

Dodatkowo usługa działa inaczej w przypadku PickupType. Zobacz Odbiór.

OmnichannelSetting

Shopping Content API Merchant API
Pole Typ Pole Typ Opis
(nie dotyczy) (nie dotyczy) name string Nazwa zasobu tego ustawienia wielokanałowości. Format:
Format: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country string regionCode string Wymagane. Common Locale Data Repository (CLDR) – kod kraju (np. „US”)
hostedLocalStorefrontActive boolean lsfType enum (LsfType) Wymagane. Typ lokalnej witryny sklepowej dla tego elementu regionCode. Możliwe wartości:
  • GHLSF (lokalna witryna sklepowa na serwerze Google)
  • MHLSF_BASIC (lokalna witryna sklepowa sprzedawcy w ramach podstawowej implementacji, która odnosi się do stron produktów z danymi o dostępności w sklepie)
  • MHLSF_FULL (lokalna witryna sklepowa sprzedawcy w ramach pełnej implementacji, która odnosi się do stron produktów z danymi o dostępności w sklepie)
(nie dotyczy) (nie dotyczy) inStock object
(InStock)
Identyfikator URI (Universal Resource Identifier) strony produktu w magazynie i stan wyświetlania dla tego regionCode. Jeśli wybierzesz jeden z typów MHLSF, ustaw co najmniej jeden z obiektów inStock lub pickup w interfejsie API tworzenia, ale ustaw inStock tylko wtedy, gdy lsfType to GHLSF.
storePickupActive boolean pickup object
(Pickup)
Identyfikator URI strony produktu z opcją odbioru i stan wyświetlania dla tego elementu: regionCode. Jeśli wybierzesz jeden z typów MHLSF, ustaw co najmniej jeden z obiektów inStock lub Pickup w interfejsie API tworzenia, ale nie ustawiaj go, gdy GHLSF jest ustawiony jako lsfType.
posDataProvider object
(LiaPosDataProvider)
lfpLink object
(LfpLink)
Tylko dane wyjściowe. utworzone połączenie z dostawcą LFP,
onDisplayToOrder object
(LiaOnDisplayToOrderSettings)
odo object
(OnDisplayToOrder)
Identyfikator URI i stan zasad dotyczących opcji „dostępny na zamówienie” dla tego języka: regionCode
about object
(LiaAboutPageSettings)
about object
(About)
Identyfikator URI strony z informacjami i stan tego elementu: regionCode
inventory object
(LiaInventorySettings)
inventoryVerification object
(InventoryVerification)
Stan procesu weryfikacji asortymentu i informacje kontaktowe dla tego regionCode
omnichannelExperience object (LiaOmnichannelExperience) (nie dotyczy) (nie dotyczy) Użyj zasad lsfType i pickup (powyżej).

LsfType

Shopping Content API Merchant API
Pole Typ Pole Typ Opis
lsfType string lsfType enum (LsfType) Typ lokalnej witryny sklepowej. Możliwe wartości:
  • GHLSF (lokalna witryna sklepowa na serwerze Google)
  • MHLSF_BASIC (Lokalna witryna sklepowa sprzedawcy w ramach podstawowej implementacji)
  • MHLSF_FULL (Lokalna witryna sklepowa sprzedawcy w ramach pełnej implementacji)

InStock (na stanie)

Shopping Content API Merchant API
Pole Typ Pole Typ Opis
(nie dotyczy) (nie dotyczy) uri string Identyfikator URI strony docelowej produktu. Wymagane, jeśli wybrano jeden z typów MHLSF. Wymagane, jeśli obiekt jest ustawiony. W przypadku GHLSF musi być puste, ale w przypadku MHLSF nie może być puste. Usługa używa go tylko do sprawdzania wyświetlania produktów w magazynie. Domena tego identyfikatora URI powinna być zgodna ze stroną główną sprzedawcy.
(nie dotyczy) (nie dotyczy) state enum
(ReviewState.State)
Tylko dane wyjściowe. Stan wyświetlania produktów w magazynie. Dostępne wartości:
  • ACTIVE
  • FAILED
  • RUNNING
  • ACTION_REQUIRED

Aby sprawdzić wersję treści promujących produkty, zobacz LiaCountrySettings i LiaOmnichannelExperience.

Odbiór

Shopping Content API Merchant API
Pole Typ Pole Typ Opis
(nie dotyczy) (nie dotyczy) uri string Identyfikator URI strony produktu z opcją odbioru. Wymagane, jeśli obiekt jest ustawiony. Interfejs API używa go tylko do sprawdzania, czy odbiór jest dostępny. Domena tego identyfikatora URI powinna być zgodna ze stroną główną sprzedawcy.
LiaInventorySettings.status string state enum (ReviewState.State) Tylko dane wyjściowe. Stan wyświetlania odbioru. Dostępne wartości:
  • ACTIVE
  • FAILED
  • RUNNING

Aby sprawdzić wersję treści promujących produkty, zobacz LiaCountrySettings i LiaOmnichannelExperience.

Shopping Content API Merchant API
Pole Typ Pole Typ Opis
posDataProviderId string lfpProvider string Wymagane. Nazwa zasobu dostawcy LFP
posExternalAccountId string externalAccountId string Wymagane. Identyfikator konta, pod którym ten sprzedawca jest znany dostawcy LFP.
(nie dotyczy) (nie dotyczy) state enum (ReviewState.State) Tylko dane wyjściowe. Stan połączenia LfpLink. Dostępne wartości:
  • ACTIVE
  • RUNNING

Aby sprawdzić wersję treści promujących produkty, zobacz LiaPosDataProvider.

OnDisplayToOrder

Shopping Content API Merchant API
Pole Typ Pole Typ Opis
shippingCostPolicyUrl string uri string Wymagane. Identyfikator URI zasad dotyczących produktów „w sklepie, dostępnych na zamówienie”.
status string state enum (ReviewState.State) Tylko dane wyjściowe. Stan identyfikatora URI. Możliwe wartości:
  • ACTIVE
  • FAILED
  • RUNNING

Aby sprawdzić wersję treści promujących produkty, zobacz LiaOnDisplayToOrderSettings.

Informacje

Shopping Content API Merchant API
Pole Typ Pole Typ Opis
url string uri string Wymagane. Identyfikator URI strony z informacjami
status string state enum (ReviewState.State) Tylko dane wyjściowe. Stan identyfikatora URI. Możliwe wartości:
  • ACTIVE
  • FAILED
  • RUNNING

Aby sprawdzić wersję treści promujących produkty, zobacz LiaAboutPageSettings.

InventoryVerification

Shopping Content API Merchant API
Pole Typ Pole Typ Opis
status string state enum (InventoryVerification.State) Tylko dane wyjściowe. Stan procesu weryfikacji asortymentu. Możliwe wartości:
  • ACTION_REQUIRED
  • INACTIVE
  • RUNNING
  • SUCCEEDED
  • SUSPENDED
inventoryVerificationContactName string contact string Wymagane. Nazwa osoby kontaktowej w procesie weryfikacji asortymentu
inventoryVerificationContactEmail string contactEmail string Wymagane. Adres e-mail osoby kontaktowej ds. procesu weryfikacji asortymentu
inventoryVerificationContactStatus string contactState enum (ReviewState.State) Tylko dane wyjściowe. Stan weryfikacji kontaktu. Możliwe wartości:
  • ACTIVE
  • RUNNING

Aby sprawdzić wersję treści promujących produkty, zobacz LiaCountrySettings i LiaInventorySettings.

LfpProvider

Shopping Content API Merchant API
Pole Typ Pole Typ Opis
fullName string name string Nazwa zasobu dostawcy LFP.
Format: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(nie dotyczy) (nie dotyczy) regionCode string Wymagane. Kod kraju CLDR
providerId string (nie dotyczy) (nie dotyczy) To pole zostanie usunięte.
displayName string displayName string Wyświetlana nazwa dostawcy LFP

Aby sprawdzić wersję treści promujących produkty, zobacz PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API Merchant API
Field Type Pole Typ Opis
name string name string Nazwa zasobu konta w Profilu Firmy w Google
Format: accounts/{account}/gbpAccount/{gbp_account}
(nie dotyczy) (nie dotyczy) gbpAccountId string Identyfikator profilu firmy
type string type enum (GbpAccount.Type) Typ profilu firmy. Dostępne wartości:
  • USER (konto osobiste)
  • BUSINESS_ACCOUNT (konto firmowe)
email string gbpAccountName string Nazwa profilu firmy:
  • W przypadku kont osobistych jest to identyfikator e-mail właściciela.
  • W przypadku kont firmowych jest to nazwa konta firmowego.
listingCount string listingCount int64 Liczba ofert powiązanych z tym kontem

Aby sprawdzić wersję treści promujących produkty, zobacz GmbAccountsGmbAccount.