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

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:
  • 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 uygulaması, mağaza stok durumunu içeren ürün sayfalarını ifade eder)
(yok) (yok) inStock object
(InStock)
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
(Pickup)
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
(LiaPosDataProvider)
lfpLink object
(LfpLink)
Yalnızca çıkış. LFP sağlayıcısıyla kurulan bağlantı
onDisplayToOrder object
(LiaOnDisplayToOrderSettings)
odo object
(OnDisplayToOrder)
Bu ürün için "siparişle temin edilen teşhir ürünü" (ODO) politika 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)
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:
  • 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 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
(ReviewState.State)
Yalnızca çıkış. Stokta olan ürünlerin yayınlanma 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, 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:
  • 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. 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:
  • ACTIVE
  • RUNNING

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

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

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:
  • ACTION_REQUIRED
  • INACTIVE
  • RUNNING
  • SUCCEEDED
  • SUSPENDED
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:
  • 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 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:
  • 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şkilendirilmiş girişlerin sayısı

Shopping Content sürümünü incelemek için GmbAccountsGmbAccount başlıklı makaleye bakın.