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

Shopping Content API'de yerel envanter reklamları ayarlarını kullandıysanız Merchant API'de birkaç önemli değişiklik yapılmıştır.

YRE 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 İş Ortaklığı (LFP) iş ortağıyla bağlantı LfpProvider
Yerel mağaza verileri için Google İşletme Profili (GİP) hesabına bağlantı GbpAccount

Ayrıca, YER 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 birden fazla kaynağı bir hesapla ilişkilendirebilirsiniz. Her kaynak, belirli bir ulusal tüzel kişinin ayarlarını temsil eder.

İstekler ve kaynaklar şu şekilde değişti.

İstekler

Yeni alan adı 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 tüm LIA ayarlarını almak için kullanılan yöntem artık doğrudan kullanılamıyor. Bunun yerine, tüm alt hesapları sorgulayın ve ilgilendiğiniz hesapların omnichannelSettings değerini 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 davranı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. Ortak Yerel Veri Deposu (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:
  • GHLSF (Google üzerinde yerel vitrin)
  • MHLSF_BASIC (Mağaza stok durumunu içeren ürün sayfalarını ifade eden satıcı üzerinde yerel vitrin temel)
  • MHLSF_FULL (Satıcı üzerinde yerel vitrin tam, mağaza stok durumunu içeren ürün sayfalarını ifade eder)
(yok) (yok) inStock object
(InStock)
Bu regionCode için stokta bulunan ürün sayfası URI'si (Evrensel Kaynak Tanımlayıcı) 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 nesnesini ayarlayın.
storePickupActive boolean pickup object
(Pickup)
Bu regionCode için teslim alma ürün sayfası URI'si ve yayınlanma durumu. MHLSF türlerinden birini seçtiyseniz oluşturma API'sinde 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ış. Yerel fiyat listesi sağlayıcısıyla kurulan bağlantı
onDisplayToOrder object
(LiaOnDisplayToOrderSettings)
odo object
(OnDisplayToOrder)
Bu regionCode için "siparişle temin edilen teşhir ürünü" (ODO) politika URI'si ve durumu
about object
(LiaAboutPageSettings)
about object
(About)
Bu regionCode için "Hakkında" sayfasının 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) 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 tarafından barındırılan 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 zorunludur. Nesne ayarlanmışsa zorunludur. GHLSF için boş, MHLSF için ise boş olmamalıdır. Hizmet, bu bilgileri yalnızca stokta bulunan ü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
(ReviewState.State)
Yalnızca çıkış. Stokta bulunan ürünlerin reklam yayınlama durumu. Kullanılabilir değerler şunlardır:
  • ACTIVE
  • FAILED
  • RUNNING
  • ACTION_REQUIRED

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, bu bilgileri yalnızca teslim alma hizmetini 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 hizmetinin durumu. Kullanılabilir değerler şunlardır:
  • ACTIVE
  • FAILED
  • RUNNING

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

Shopping Content API Merchant API
Alan Tür Alan Tür Açıklama
posDataProviderId string lfpProvider string Zorunlu. Yerel fiyat listesi sağlayıcısının kaynak adı
posExternalAccountId string externalAccountId string Zorunlu. Bu satıcının yerel ürün feed'i 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 şunlardır:
  • ACTIVE
  • RUNNING

Alışveriş içeriği sürümünü incelemek için LiaPosDataProvider sayfasına 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 sayfasına 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ının 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 sayfasına 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üreci için 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:
  • ACTIVE
  • RUNNING

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 Yerel fiyat listesi 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 Yerel ürünler feed'i sağlayıcısı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 şunlardır:
  • 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şkili girişlerin sayısı

Alışveriş içeriği sürümünü incelemek için GmbAccountsGmbAccount sayfasına bakın.