Content API for Shopping'den hesap yönetimini taşıma

Bu dokümanda, Content API 2.1 sürümünden Merchant API'ye nasıl geçebileceğiniz açıklanmaktadır.

Content API 2.1'den Merchant API'ye yapılan değişikliklere genel bakış

Merchant API, geliştiriciler ve işletmeler için kullanılabilirliği, tutarlılığı ve esnekliği artırmayı amaçlayan Content API 2.1'e kıyasla önemli iyileştirmeler sunar.

Ayrıntılı kaynak yapısı

Merchant API'deki kaynaklar account, businessDetails, user, homepage ve program gibi tek kavramları temsil eder. Bu öğeler, aralarındaki ilişkileri yansıtacak şekilde hiyerarşik olarak düzenlenir. Örneğin, account bir user için üst kaynaktır.

Birleşik hesap hizmetleri

Tüm hesap hizmetleri (ör. MCA'lar ve alt hesapları için hesap toplama veya üçüncü taraf servis sağlayıcılar ile hesaplar arasında) birleşik bir accountService kaynağı aracılığıyla yönetilir. Hizmet sağlayıcılar, accountRelationship kaynağını kullanarak ilişkilerini yönetebilir.

Basitleştirilmiş URL yapısı

URL'ler artık birden fazla kimlik yerine tek bir hesap kimliği (ör. merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}) kullanıyor. URL yolları, ayrıntılı kaynak yapısını yansıtır.

Diğer gelişmeler

  • Gelişmiş program ve kullanıcı yönetimi: Alışveriş reklamları ve ücretsiz listelemeler gibi programlar tek bir program kaynağı altında birleştirilir. user kaynağı, ayrıntılı erişim haklarına sahip kapsamlı yönetim özellikleri içerir.
  • Yapılandırılmış işletme bilgileri ve işletme kimliği: businessInfo ve businessIdentity için özel kaynaklar vardır. Bölgeye özgü veriler için alanlarla uyumluluk desteği sunarlar. Örneğin, Kore işletme tescil numarası.
  • Basitleştirilmiş ana sayfa hak talebi: Mağazanın ana sayfası URL'sini özel bir homepage kaynak yönetir. claim ve unclaim gibi yöntemler, web sitesi hak talebini doğrudan API üzerinden yönetir.
  • Google API yönergelerine uygunluk: Merchant API, Google'ın API iyileştirme önerilerine uygun olmayı amaçlar.

Hesap yönetimini taşıma

Satıcı hesabınızı oluşturmak ve yönetmek için accounts kaynağını kullanabilirsiniz. Daha fazla bilgi için Satıcı Hesapları API'sine Genel Bakış başlıklı makaleyi inceleyin.

Bu sayfada, hesap yönetimini Content API'den Merchant API'ye nasıl taşıyacağınız açıklanmaktadır.

İstekler

Merchant Accounts API için aşağıdaki istek URL'si biçimini kullanın:

https://merchantapi.googleapis.com/accounts/v1beta/{ACCOUNT_ID}/accounts

Hesap oluşturma ve yönetim istekleri için Content API for Shopping ile Merchant Center API'nin karşılaştırmasını aşağıda bulabilirsiniz:

  Content API for Shopping Merchant Accounts API
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/ https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}
Tanımlayıcılar merchantId,accountId ``ad

Kaynaklar

Hesap verileri, Content API for Shopping'daki Account kaynağı kullanılarak iletilir. Merchant Accounts API, hesap verilerini iletmek için birden fazla kaynak sağlar. Bu kaynaklar arasında Account, User, BusinessInfo ve BusinessIdentity kaynakları yer alır.

Aşağıdaki tabloda, Content API for Shopping'deki Account kaynağı ile Merchant Accounts API'deki Account kaynağı karşılaştırılmıştır.

Content API for Shopping Merchant Accounts API
id name
name accountName
kind Kullanılamıyor
websiteUrl Homepage kaynağındaki uri alanı
adultContent adultContent
sellerId AccountRelationship kaynağındaki accountIdAlias alanı
users User kaynağında
youtubeChannelLinks Henüz mevcut değil
googleMyBusinessLink Henüz mevcut değil
businessInformation businessInfo kaynağında
businessIdentity businessIdentity kaynağında
automaticImprovements Henüz mevcut değil
adsLinks AccountService kaynağındaki campaignsManagement alanı
cssId Yalnızca CSS API'de kullanılabilir
labelIds Yalnızca CSS API'de kullanılabilir
accountManagement AccountService kaynağındaki accountManagement alanı
automaticLabelIds Yalnızca CSS API'de kullanılabilir
conversionSettings Henüz mevcut değil

Aşağıdaki tabloda, Content API for Shopping'deki AccountUser kaynağı ile Merchant Accounts API'deki User kaynağı karşılaştırılmıştır.

Content API for Shopping Merchant Accounts API
emailAddress e-posta adresi, name (accounts/{account}/users/{email}) kapsamındadır.
admin user#accessRights.ADMIN
orderManager Kullanılamıyor
paymentsManager Kullanılamaz
paymentsAnalyst Kullanılamıyor
reportingManager user#accessRights.PERFORMANCE_REPORTING

Aşağıdaki tabloda, Content API for Shopping'teki AccountBusinessInformation kaynağı ile Merchant Center API'sindeki eşdeğer kaynağı businessInfo karşılaştırılmıştır.

Content API for Shopping Merchant Accounts API
address address
phoneNumber phone
phoneVerificationStatus phoneVerificationState
customerService customerService
koreanBusinessRegistrationNumber koreanBusinessRegistrationNumber

Aşağıdaki tabloda, Content API for Shopping'deki AccountBusinessIdentity kaynağı ile Merchant Accounts API'deki businessIdentity kaynağı karşılaştırılmıştır.

Content API for Shopping Merchant Accounts API
blackOwned blackOwned
womenOwned womenOwned
veteranOwned veteranOwned
latinoOwned latinoOwned
smallBusiness smallBusiness
includeForPromotions promotionsConsent
- true, PROMOTION_CONSENT_GIVEN anlamına gelir
- false, PROMOTION_CONSENT_DENIED anlamına gelir

Content API'deki AccountIdentityType kaynağı, MerchantAPI'deki IdentityAttribute türü ve identityDeclaration alanı ile temsil edilir.

Content API for Shopping Merchant Accounts API
self_identified identityDeclaration
- true, SELF_IDENTIFIES_AS anlamına gelir
- false, DOES_NOT_SELF_IDENTIFY_AS anlamına gelir

Yöntemler

Merchant Accounts API'de aşağıdaki yöntemler kullanıma sunulmuştur:

Content API for Shopping Merchant Accounts API
accounts.authinfo Filtre uygulanmamış GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
accounts.claimwebsite POST https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/homepage:claim Daha fazla bilgi için Yöntem: accounts.v1beta.accounts.homepage.claim başlıklı makaleyi inceleyin.
accounts.custombatch Yok. Özel toplu işlem Merchant API'de desteklenmez.
accounts.delete DELETE https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}
accounts.get GET https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}`
accounts.insert POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure Daha fazla bilgi için Satıcı hesabı oluşturma ve yapılandırma başlıklı makaleyi inceleyin.
accounts.link AccountService kaynağı
accounts.list GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}:listSubaccounts
accounts.listlinks GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/services
accounts.requestphoneverification Desteklenmiyor.
accounts.update Gerekli alanın veya alan grubunun tanımlandığı kaynak için bir güncelleme isteğiyle eşlenir.
accounts.updatelabels Yalnızca CSS API'de kullanılabilir
accounts.verifyphonenumber Desteklenmiyor.
Önceki
Genel bakış
Sonraki
Envanter yönetimini taşı