Shopping Content API'nin yerel envanter reklamları ayarlarını kullandıysanız Merchant API'de birkaç önemli değişiklik yapıldı.
YBS ayarları artık üç temel bileşenden birine aittir ve her birinin ilişkili bir kaynağı vardır.
| Temel bileşen | Kaynak |
|---|---|
| Çok kanallı reklam sunma için hesap yapılandırması | OmnichannelSetting |
| Envanter verileri için Yerel Feed'ler İş Ortaklığı (LFP) iş ortağına bağlantı | LfpProvider |
| Yerel mağaza verileri için Google İşletme Profili (GBP) hesabına bağlantı | GbpAccount |
Ayrıca, YLİ ayarlarında hesap başına tek bir kaynak vardı ve bu kaynak, her ulusal tüzel kişi için bir ayar listesi içeriyordu. OmnichannelSettings ile bir hesapla birden fazla kaynak ilişkilendirebilirsiniz. Her kaynak, belirli bir ulusal kuruluşun ayarlarını temsil eder.
İstekler ve kaynaklarda yapılan değişiklikler aşağıda açıklanmıştır.
İstekler
| Yeni alan | Content API yöntem adı | Merchant API yöntem adı |
|---|---|---|
accounts.omnichannelSettings |
liasettings.custombatch |
Bu yöntem kullanımdan kaldırılacak. Merchant API, aynı anda birden fazla istek gönderme özelliğini destekler. |
liasettings.get |
accounts.omnichannelSettings.list |
|
liasettings.list |
Tüm alt hesapların yerel envanter reklamları ayarlarını almanın bir yöntemi artık doğrudan kullanılamıyor. Bunun yerine, tüm alt hesapları sorgulayın ve ilgilendiğiniz hesapların çok kanallı ayarlarını almak için accounts.omnichannelSettings.list kullanın.
|
|
liasettings.update |
accounts.omnichannelSettings.create, accounts.omnichannelSettings.update |
|
liasettings.requestinventoryverification |
accounts.omnichannelSettings.requestInventoryVerification |
|
liasettings.setinventoryverificationcontact |
Bu yöntem kullanımdan kaldırılacak. Bunun yerine, güncellenmiş bir maskeyle accounts.omnichannelSettings.create veya accounts.omnichannelSettings.update kullanın.
|
|
liasettings.setomnichannelexperience |
Bu yöntem kullanımdan kaldırılacak. Bunun yerine, güncellenmiş bir maskeyle accounts.omnichannelSettings.create veya accounts.omnichannelSettings.update kullanın.
|
|
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 |
Kaynaklar
Ayrıca, hizmet PickupType için farklı şekilde çalışır. Teslim alma bölümüne bakın.
OmnichannelSetting
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| Alan | Tür | Alan | Tür | Açıklama |
| (yok) | (yok) | name |
string |
Bu çok kanallı ayarın kaynak adı. Biçim:
Biçim: accounts/{account}/omnichannelSettings/{omnichannel_setting}
|
country |
string |
regionCode |
string |
Zorunlu. Common Locale Data Repository (CLDR) ülke kodu (örneğin, "US") |
hostedLocalStorefrontActive |
boolean |
lsfType |
enum (LsfType) |
Zorunlu.
Bu regionCode için
yerel vitrin (LSF) türü.
Olası değerler şunları içerir:
|
| (yok) | (yok) | inStock |
object |
Bu regionCode için stoktaki ürün sayfası URI'si (Tek Tip Kaynak Tanımlayıcısı) ve yayınlanma durumu. MHLSF türlerinden birini seçtiyseniz oluşturma API'sinde inStock veya pickup nesnelerinden en az birini ayarlayın. Ancak lsfType, GHLSF ise yalnızca inStock'yı ayarlayın.
|
storePickupActive |
boolean |
pickup |
object |
Bu regionCode için teslim alma ürün sayfası URI'si ve yayınlanma durumu. inStock veya Pickup türlerinden birini seçtiyseniz oluşturma API'sinde bu nesnelerden en az birini ayarlayın. Ancak GHLSF, lsfType olarak ayarlandığında bu nesneleri ayarlamayın.MHLSF
|
posDataProvider |
object |
lfpLink |
object |
Yalnızca çıkış. LFP sağlayıcısıyla kurulan bağlantı |
onDisplayToOrder |
object |
odo |
object |
Bu ürün için "siparişle temin edilen teşhir ürünü" (ODO) politika URI'si ve durumu
regionCode
|
about |
object |
about |
object |
Bu regionCode için Hakkında sayfası URI'si ve durumu |
inventory |
object |
inventoryVerification |
object |
Envanter doğrulama sürecinin durumu ve bu regionCode için iletişim bilgileri |
omnichannelExperience |
object (LiaOmnichannelExperience) |
(yok) | (yok) | lsfType ve pickup (yukarıda) özelliklerini kullanın. |
LsfType
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| Alan | Tür | Alan | Tür | Açıklama |
lsfType |
string |
lsfType |
enum (LsfType) |
Yerel vitrin (LSF) türü. Olası değerler:
|
InStock
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| Alan | Tür | Alan | Tür | Açıklama |
| (yok) | (yok) | uri |
string |
Ürün açılış sayfası URI'si. MHLSF
türlerinden birini seçtiyseniz zorunludur. Nesne ayarlanmışsa zorunludur. GHLSF için boş, MHLSF için boş olmayan bir değer olmalıdır. Hizmet, bu bilgiyi yalnızca stokta olan ürünlerin yayınlanmasını incelemek için kullanır. Bu URI alanı, satıcının ana sayfasıyla eşleşmelidir.
|
| (yok) | (yok) | state |
enum |
Yalnızca çıkış. Stokta olan ürünlerin yayınlanma durumu. Kullanılabilir değerler şunlardır:
|
Alışveriş içeriği sürümünü incelemek için LiaCountrySettings ve LiaOmnichannelExperience sayfalarına bakın.
Teslim alma
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| Alan | Tür | Alan | Tür | Açıklama |
| (yok) | (yok) | uri |
string |
Teslim alma ürün sayfası URI'si. Nesne ayarlanmışsa zorunludur. API, yalnızca teslim alma hizmetini incelemek için kullanır. Bu URI alan adı, satıcının ana sayfasıyla eşleşmelidir. |
LiaInventorySettings.status |
string |
state |
enum (ReviewState.State) |
Yalnızca çıkış. Teslim alma hizmetinin durumu. Kullanılabilir değerler:
|
Alışveriş içeriği sürümünü incelemek için LiaCountrySettings ve LiaOmnichannelExperience sayfalarına bakın.
LfpLink
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| Alan | Tür | Alan | Tür | Açıklama |
posDataProviderId |
string |
lfpProvider |
string |
Zorunlu. LFP sağlayıcısının kaynak adı |
posExternalAccountId |
string |
externalAccountId |
string |
Zorunlu. Bu satıcının LFP sağlayıcısı tarafından bilindiği hesap kimliği |
| (yok) | (yok) | state |
enum (ReviewState.State) |
Yalnızca çıkış. LfpLink'in durumu. Kullanılabilir değerler:
|
Alışveriş İçeriği sürümünü incelemek için LiaPosDataProvider'a bakın.
OnDisplayToOrder
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| Alan | Tür | Alan | Tür | Açıklama |
shippingCostPolicyUrl |
string |
uri |
string |
Zorunlu. "Siparişle temin edilen teşhir ürünü" (ODO) politika URI'si. |
status |
string |
state |
enum (ReviewState.State) |
Yalnızca çıkış. URI'nin durumu. Olası değerler:
|
Alışveriş içeriği sürümünü incelemek için LiaOnDisplayToOrderSettings başlıklı makaleyi inceleyin.
Hakkında
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| Alan | Tür | Alan | Tür | Açıklama |
url |
string |
uri |
string |
Zorunlu. Hakkında sayfası URI'si |
status |
string |
state |
enum (ReviewState.State) |
Yalnızca çıkış. URI'nin durumu. Olası değerler:
|
Alışveriş İçeriği sürümünü incelemek için LiaAboutPageSettings başlıklı makaleyi inceleyin.
InventoryVerification
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| Alan | Tür | Alan | Tür | Açıklama |
status |
string |
state |
enum (InventoryVerification.State) |
Yalnızca çıkış. Envanter doğrulama sürecinin durumu. Olası değerler:
|
inventoryVerificationContactName |
string |
contact |
string |
Zorunlu. Envanter doğrulama süreciyle ilgili iletişim kişisinin adı |
inventoryVerificationContactEmail |
string |
contactEmail |
string |
Zorunlu. Envanter doğrulama süreciyle ilgili iletişim kişisinin e-posta adresi |
inventoryVerificationContactStatus |
string |
contactState |
enum (ReviewState.State) |
Yalnızca çıkış. Kişi doğrulamasının durumu. Olası değerler:
|
Alışveriş içeriği sürümünü incelemek için LiaCountrySettings ve LiaInventorySettings sayfalarına bakın.
LfpProvider
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| Alan | Tür | Alan | Tür | Açıklama |
fullName |
string |
name |
string |
LFP sağlayıcısının kaynak adı.
Biçim: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
|
| (yok) | (yok) | regionCode |
string |
Zorunlu. CLDR ülke kodu |
providerId |
string |
(yok) | (yok) | Bu alan kaldırılıyor. |
displayName |
string |
displayName |
string |
LFP sağlayıcının görünen adı |
Alışveriş içeriği sürümünü incelemek için PosDataProvidersPosDataProvider başlıklı makaleyi inceleyin.
GbpAccount
Shopping Content API |
Merchant API | |||
|---|---|---|---|---|
Field |
Type |
Alan | Tür | Açıklama |
name |
string |
name |
string |
GBP hesabının kaynak adı
Biçim: accounts/{account}/gbpAccount/{gbp_account}
|
| (yok) | (yok) | gbpAccountId |
string |
İşletme profilinin kimliği |
type |
string |
type |
enum (GbpAccount.Type) |
İşletme profilinin türü. Kullanılabilir değerler şunlardır:
|
email |
string |
gbpAccountName |
string |
İşletme profilinin adı:
|
listingCount |
string |
listingCount |
int64 |
Bu hesapla ilişkilendirilmiş girişlerin sayısı |
Shopping Content sürümünü incelemek için GmbAccountsGmbAccount başlıklı makaleye bakın.