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:
|
| (nie dotyczy) | (nie dotyczy) | inStock |
object |
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 |
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 |
lfpLink |
object |
Tylko dane wyjściowe. utworzone połączenie z dostawcą LFP, |
onDisplayToOrder |
object |
odo |
object |
Identyfikator URI i stan zasad dotyczących opcji „dostępny na zamówienie” dla tego języka: regionCode
|
about |
object |
about |
object |
Identyfikator URI strony z informacjami i stan tego elementu: regionCode |
inventory |
object |
inventoryVerification |
object |
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:
|
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 |
Tylko dane wyjściowe. Stan wyświetlania produktów w magazynie. Dostępne wartości:
|
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:
|
Aby sprawdzić wersję treści promujących produkty, zobacz LiaCountrySettings i LiaOmnichannelExperience.
LfpLink
| 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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
email |
string |
gbpAccountName |
string |
Nazwa profilu firmy:
|
listingCount |
string |
listingCount |
int64 |
Liczba ofert powiązanych z tym kontem |
Aby sprawdzić wersję treści promujących produkty, zobacz GmbAccountsGmbAccount.