Yerel envanter reklamı (YER) ayarlarını taşıma

Shopping Content API kapsamında yerel envanter reklamı ayarlarını kullandıysanız Merchant API'de birkaç önemli değişiklik yapıldı.

LIA ayarları artık her biri ilişkili bir kaynağa sahip olan üç temel bileşenden birine aittir.

Temel bileşen Kaynak
Çok kanallı yayın için hesap yapılandırması OmnichannelSetting
Envanter verileri için yerel feed'ler iş ortağı (LFP) ile bağlantı LfpProvider
Yerel mağaza verileri için Google İşletme Profili (GBP) hesabına bağlantı GbpAccount

Ayrıca, LIA ayarlarında hesap başına tek bir kaynak vardı ve bu kaynakta her ulusal tüzel kişi için ayarların listesi yer alıyordu. OmnichannelSettings ile birden fazla kaynağı bir hesapla ilişkilendirebilirsiniz. Her kaynak, belirli bir ulusal tüzel kişinin 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ılıyor. Merchant API, tek seferde birden fazla istek gönderme özelliğini destekler.
liasettings.get accounts.omnichannelSettings.list
liasettings.list Tüm alt hesaplar için tüm PBM ayarlarını doğrudan alma yöntemi artık kullanılamamaktadır. Bunun yerine, tüm alt hesapları sorgulamanız ve ilgilendiğiniz hesapların omnichannelSettings değerini almak için accounts.omnichannelSettings.list kullanmanız gerekir.
liasettings.update accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
liasettings.requestinventoryverification accounts.omnichannelSettings.requestInventoryVerification
liasettings.setinventoryverificationcontact Bu yöntem kullanımdan kaldırılıyor. Bunun yerine, güncellenmiş bir maskeyle birlikte accounts.omnichannelSettings.create veya accounts.omnichannelSettings.update kullanın.
liasettings.setomnichannelexperience Bu yöntem kullanımdan kaldırılıyor. Bunun yerine, güncellenmiş bir maskeyle birlikte 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ı davranır. Teslimat 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 (ör. "US")
hostedLocalStorefrontActive boolean lsfType enum (LsfType) Zorunlu. Bu regionCode için yerel vitrin (LSF) türü. Olası değerler şunları içerir:
  • GHLSF (Google üzerinde yerel vitrin)
  • MHLSF_BASIC (Satıcı üzerinde yerel vitrin temel sürümü, mağaza stok durumunu içeren ürün sayfalarını ifade eder)
  • MHLSF_FULL (Mağaza stok durumunu içeren ürün sayfalarını ifade eden Satıcı Üzerinde Yerel Vitrin (Tam))
(yok) (yok) inStock object
(InStock)
Bu regionCode için stoktaki ürün sayfası URI'si (Tekdüzen Kaynak Tanımlayıcısı) ve yayınlama durumu. MHLSF türlerinden birini seçtiyseniz create API'de inStock veya pickup nesnelerinden en az birini ayarlayın ancak lsfType GHLSF ise yalnızca inStock'ü ayarlayın.
storePickupActive boolean pickup object
(Pickup)
Bu regionCode için teslim alma ürün sayfası URI'si ve yayınlama durumu. MHLSF türlerinden birini seçtiyseniz create API'de inStock veya Pickup nesnelerinden en az birini ayarlayın ancak GHLSF lsfType olarak ayarlandığında bunu ayarlamayın.
posDataProvider object
(LiaPosDataProvider)
lfpLink object
(LfpLink)
Yalnızca çıkış. Bir LFP sağlayıcısına kurulan bağlantı
onDisplayToOrder object
(LiaOnDisplayToOrderSettings)
odo object
(OnDisplayToOrder)
"Siparişle temin edilen teşhir ürünü" (ODO) politikasının URI'si ve durumu regionCode
about object
(LiaAboutPageSettings)
about object
(About)
Bu regionCode için hakkında sayfası URI'si ve durumu
inventory object
(LiaInventorySettings)
inventoryVerification object
(InventoryVerification)
Bu regionCode için envanter doğrulama süreci durumu ve iletişim bilgileri
omnichannelExperience object (LiaOmnichannelExperience) (yok) (yok) lsfType ve pickup (yukarıda) seçeneklerini 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:
  • GHLSF (Google üzerinde yerel vitrin)
  • MHLSF_BASIC (Satıcı üzerinde yerel vitrin - temel)
  • MHLSF_FULL (Satıcı üzerinde yerel vitrin (tam))

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 gereklidir. Nesne ayarlanmışsa gereklidir. GHLSF için boş, MHLSF için ise boş olmamalıdır. Hizmet bu özelliği yalnızca stoktaki yayını incelemek için kullanır. Bu URI alanı, satıcının ana sayfasıyla eşleşmelidir.
(yok) (yok) state enum
(ReviewState.State)
Yalnızca çıkış. Stoktaki ürün sunma durumunu gösterir. Kullanılabilir değerler:
  • ACTIVE
  • FAILED
  • RUNNING
  • ACTION_REQUIRED

Alışveriş içeriği sürümünü incelemek için LiaCountrySettings ve LiaOmnichannelExperience'e 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 gereklidir. API, bu özelliği yalnızca yayını incelemek için kullanır. Bu URI alanı, satıcının ana sayfasıyla eşleşmelidir.
LiaInventorySettings.status string state enum (ReviewState.State) Yalnızca çıkış. Teslim alma sunma işleminin durumu. Kullanılabilir değerler:
  • ACTIVE
  • FAILED
  • RUNNING

Alışveriş içeriği sürümünü incelemek için LiaCountrySettings ve LiaOmnichannelExperience'e bakın.

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 bilinen hesap kimliği
(yok) (yok) state enum (ReviewState.State) Yalnızca çıkış. LfpLink'in durumu. Kullanılabilir değerler:
  • ACTIVE
  • RUNNING

Alışveriş iç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) politikası URI'si.
status string state enum (ReviewState.State) Yalnızca çıkış. URI'nin durumu. Olası değerler:
  • ACTIVE
  • FAILED
  • RUNNING

Alışveriş içeriği sürümünü incelemek için LiaOnDisplayToOrderSettings bölümüne bakın.

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:
  • ACTIVE
  • FAILED
  • RUNNING

Alışveriş içeriği sürümünü incelemek için LiaAboutPageSettings bölümüne bakın.

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:
  • ACTION_REQUIRED
  • INACTIVE
  • RUNNING
  • SUCCEEDED
  • SUSPENDED
inventoryVerificationContactName string contact string Zorunlu. Envanter doğrulama sürecine ait iletişim kişisinin adı
inventoryVerificationContactEmail string contactEmail string Zorunlu. Envanter doğrulama süreciyle ilgili iletişim kişininin e-posta adresi
inventoryVerificationContactStatus string contactState enum (ReviewState.State) Yalnızca çıkış. İletişim doğrulamasının durumu. Olası değerler:
  • ACTIVE
  • RUNNING

Alışveriş içeriği sürümünü incelemek için LiaCountrySettings ve LiaInventorySettings öğelerine 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ır.
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 bölümüne bakın.

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:
  • USER (kişisel hesap)
  • BUSINESS_ACCOUNT (işletme hesabı)
email string gbpAccountName string İşletme profilinin adı:
  • Kişisel hesaplarda bu, sahibin e-posta kimliğidir.
  • İşletme hesapları için bu, işletme hesabının adıdır.
listingCount string listingCount int64 Bu hesapla ilişkilendirilen girişlerin sayısı

Alışveriş İçeriği sürümünü incelemek için GmbAccountsGmbAccount bölümüne bakın.