Hesap yönetimini taşı

Hesaplar API'si, Merchant Center hesaplarınızı daha verimli bir şekilde yönetmenize ve hesabınızın farklı yönleri üzerinde daha hassas kontrol sağlamanıza olanak tanımak için bir kaynak koleksiyonuna bölünmüştür.

Bu kılavuzda, temel değişiklikler açıklanmakta ve mevcut hesap yönetimi entegrasyonunuzu Content API for Shopping'den Merchant API'ye taşımanıza yardımcı olunmaktadır.

Tek bir kaynaktan çok sayıda kaynağa

Content API for Shopping'de Account kaynağı, hesap adı ve web sitesi URL'sinden kullanıcı listelerine ve işletme bilgilerine kadar her şeyi içeren tek bir nesneydi.

Merchant API, bu bilgileri daha küçük ve odaklanmış kaynaklara ayırır. Bu değişiklik, daha hedefli ve verimli API çağrılarına olanak tanır. Örneğin, yalnızca işletme adresinizi güncellemek için artık tüm Account nesnesini güncellemek yerine PATCH kaynağına BusinessInfo istek gönderirsiniz.

Content API for Shopping Account kaynağındaki kavramların Merchant API'deki yeni kaynaklarla nasıl eşlendiğinin özeti aşağıda verilmiştir:

Yeni özellikler

Merchant API, hesap yönetimi için Content API for Shopping'de bulunmayan yeni özellikler de sunar:

  • Hizmet Şartları: TermsOfService ve TermsOfServiceAgreementState kaynaklarını kullanarak Hizmet Şartları'nı programatik olarak alın ve kabul edin.
  • Hesap oluşturma: accounts.createAndConfigure yöntemi artık ilişkili hesap oluşturmayı (ör. accountManagement), alias ayarlamayı ve yeni accounts.verifySelf yöntemiyle API tabanlı doğrulama lehine user.verificationMailSettings.verificationMailMode alanını kullanarak e-posta doğrulamasını devre dışı bırakmayı destekliyor.
  • Takma Adla Hesap Erişimi: Hesaplara providerId~accountAlias biçiminde erişerek birden fazla hesabı yöneten işletmelerin kendi hesap tanımlayıcılarını kullanmaları için tutarlı bir yöntem sunar.

İstekler

Bu tabloda, Content API for Shopping ile Merchant API arasındaki yaygın hesap yönetimi görevlerine yönelik istek URL'lerinin birleştirilmiş karşılaştırması sağlanır.

İstek açıklaması Content API for Shopping Merchant API
Hesap edinme GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Hesabı takma ada göre alma Doğrudan kullanılamaz GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
Alt hesapları listeleme GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
Alt hesap oluşturma POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
Hesap verilerini güncelleme PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} PATCH simgesini tıklayın. Örneğin, hesap adını güncellemek için: PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Alt hesabı silme DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Web sitesi için hak talebinde bulunma POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
Hesapları bağla POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

Temel hesap bilgilerini yönetme

Merchant API'deki Account kaynağı, Merchant Center hesabının adı, kimliği ve temel ayarları gibi temel ayrıntılarını içerir.

Karşılaştırma isteği

İstek açıklaması Content API for Shopping Merchant API
Hesap ayrıntılarını alma GET /content/v2.1/{merchantId}/accounts/{accountId} (name, adult_content gibi temel özelliklere erişme) GET /accounts/v1/accounts/{account}
Alt hesap oluşturma POST /content/v2.1/{merchantId}/accounts POST /accounts/v1/accounts:createAndConfigure
Hesap ayrıntılarını güncelleme PUT /content/v2.1/{merchantId}/accounts/{accountId} (temel özellikleri güncelleme) PATCH /accounts/v1/accounts/{account}
Alt hesabı silme DELETE /content/v2.1/{merchantId}/accounts/{accountId} DELETE /accounts/v1/accounts/{account}

Ayrıntılı alan karşılaştırması

Content API for Shopping (Account) Merchant API (Account) Notlar
id account_id Sayısal kimlik artık yalnızca çıkış alanıdır. Birincil tanımlayıcı, kaynak name'dır.
name account_name Hesabın kullanıcılar tarafından okunabilen adı.
language language_code Alan adı artık language_code.

İşletme bilgilerini yönetme

İşletmenizle ilgili herkese açık bilgileri (ör. adresiniz ve müşteri hizmetleri iletişim bilgileriniz) yönetmek için BusinessInfo<0x0x0A>kaynağını kullanın. Bu, Content API for Shopping'deki businessInformation nesnesinin yerini alır.

Karşılaştırma isteği

İstek açıklaması Content API for Shopping Merchant API
İşletme bilgilerini alma GET /content/v2.1/{merchantId}/accounts/{accountId} (business_information özelliğine erişme) GET /accounts/v1/accounts/{account}/businessInfo
İşletme bilgilerini güncelleme PUT /content/v2.1/{merchantId}/accounts/{accountId} (business_information özelliğini güncelleme) PATCH /accounts/v1/accounts/{account}/businessInfo

Ayrıntılı alan karşılaştırması

Content API for Shopping (business_information) Merchant API (BusinessInfo) Notlar
phone_number phone Alan artık phone ve google.type.PhoneNumber kullanıyor.
customer_service.url customer_service.uri Alan adı artık uri.

Ana sayfanızı yönetme

Mağazanızın web sitesi URL'sini yönetmek, doğrulama ve hak talebinde bulunma işlemlerini gerçekleştirmek için Homepage kaynağını kullanın. Bu, Content API for Shopping'deki websiteUrl alanının ve accounts.claimwebsite yönteminin yerini alır.

Karşılaştırma isteği

İstek açıklaması Content API for Shopping Merchant API
Ana sayfa URL'sini alma GET /content/v2.1/{merchantId}/accounts/{accountId} (website_url özelliğine erişme) GET /accounts/v1/accounts/{account}/homepage
Ana sayfa URL'sini güncelleme PUT /content/v2.1/{merchantId}/accounts/{accountId} (website_url özelliğini güncelleme) PATCH /accounts/v1/accounts/{account}/homepage
Hak talebi ana sayfası POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
Ana sayfa hak talebini iptal etme Kullanılamıyor POST /accounts/v1/accounts/{account}/homepage:unclaim

Ayrıntılı alan karşılaştırması

Content API for Shopping (Account) Merchant API (Homepage) Notlar
website_url uri Mağazanın ana sayfasının URL'si.
Doğrudan kullanılamaz claimed Ana sayfa talep edilmişse true olan bir boole alanı.

Kullanıcıları yönetme

User kaynağı, Merchant Center hesabına kimlerin erişebileceğini yönetmenize olanak tanır. Bu, Account kaynağındaki users dizisinin yerini alır. Temel fark, kullanıcı oluşturma sürecidir. Merchant API'de kullanıcı eklemek için davetiye gönderilir. Kullanıcının hesaba erişebilmesi için daveti kabul etmesi gerekir.

Karşılaştırma isteği

İstek açıklaması Content API for Shopping Merchant API
Kullanıcıları listeleme GET /content/v2.1/{merchantId}/accounts/{accountId} (users özelliğine erişme) GET /accounts/v1/accounts/{account}/users
Kullanıcı oluşturma PUT /content/v2.1/{merchantId}/accounts/{accountId} (users özelliğini güncelleme) POST /accounts/v1/accounts/{account}/users
Kullanıcı güncelleme PUT /content/v2.1/{merchantId}/accounts/{accountId} (users özelliğini güncelleme) PATCH /accounts/v1/accounts/{account}/users/{email}
Kullanıcı silme PUT /content/v2.1/{merchantId}/accounts/{accountId} (users özelliğini güncelleme) DELETE /accounts/v1/accounts/{account}/users/{email}

Ayrıntılı alan karşılaştırması

Content API for Shopping (users dizi nesnesi) Merchant API (User kaynağı) Notlar
email_address name (accounts/{account}/users/{email} biçiminde) Kullanıcının e-posta adresi artık kaynak adının bir parçasıdır.
admin, order_manager, reporting_manager vb. access_rights Erişim hakları artık tekrarlanan bir enum alanında birleştiriliyor.
Kullanılamıyor state Kullanıcının PENDING veya VERIFIED olup olmadığını belirten, yalnızca çıkış için kullanılan yeni bir alan.

Hesap ilişkilerini ve hizmetlerini yönetme

Content API for Shopping'de ilişkiler accounts.link ile yönetiliyordu. Merchant API, AccountService ve AccountRelationship kaynaklarıyla daha açık bir model sunar ve el sıkışma süreci (öneri ve kabul) gerektirir.

Karşılaştırma isteği

İstek açıklaması Content API for Shopping Merchant API
Hesapları bağla POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
Bağlı hesapları listeleme GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks GET /accounts/v1/accounts/{account}/relationships ve GET /accounts/v1/accounts/{account}/services

Ayrıntılı alan karşılaştırması

Content API for Shopping (AccountLink) Merchant API (AccountService, AccountRelationship) Notlar
linked_account_id provider (AccountService bölgesinde) Hizmeti sağlayan hesabın kimliği.
service service_type (AccountService bölgesinde) Sunulan hizmetin türü (ör. ACCOUNT_AGGREGATION).
status handshake.approval_state (AccountService bölgesinde) Bağlantının durumu (ör. PENDING, ESTABLISHED).

Hesap vergi ayarları

Content API for Shopping'deki accounttax hizmeti Merchant API'de kullanılamaz. ABD satış vergisinin sağlanması artık zorunlu değil. Daha fazla bilgi için Merchant Center ürün verileri spesifikasyonunun 2025 güncellemesi başlıklı makaleyi inceleyin.

İşletme kimliğini yönetme

İşletmenizle ilgili özellikleri kendiniz bildirmek için BusinessIdentity kaynağını kullanın. Bu, Content API for Shopping'deki businessIdentity nesnesinin yerini alır.

Karşılaştırma isteği

İstek açıklaması Content API for Shopping Merchant API
İşletme kimliği edinme GET /content/v2.1/{merchantId}/accounts/{accountId} (business_identity özelliğine erişme) GET /accounts/v1/accounts/{account}/businessIdentity
İşletme kimliğini güncelleme PUT /content/v2.1/{merchantId}/accounts/{accountId} (business_identity özelliğini güncelleme) PATCH /accounts/v1/accounts/{account}/businessIdentity

Ayrıntılı alan karşılaştırması

Content API for Shopping (business_identity) Merchant API (BusinessIdentity) Notlar
black_owned.self_identified (boole) black_owned.identity_declaration (enum) Daha açık bir beyan için boole, enum ile (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) değiştirilir. Bu durum tüm kimlik özellikleri için geçerlidir.
include_for_promotions (boole) promotions_consent (enum) Genel bir boolean, daha açıklayıcı bir enum ile değiştirildi (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED).

Hesapları listeleme

Shopping için Content API'de tek gelişmiş hesap türü "çok müşterili hesap (MCA)" idi ve belirli bir çok müşterili hesabın hesaplarını listelemek için accounts.list yöntemini kullanıyordu. Merchant API'deki gelişmiş hesaplar çok daha güçlüdür ve daha geniş bir hesap türü ile ilişki yelpazesine olanak tanır. Gelişmiş hesapların kolayca taşınmasına olanak tanımak için Merchant API, Content API for Shopping'in accounts.list yöntemine doğrudan eşdeğer bir accounts.listSubaccounts yöntemi sunar. Gelişmiş hesap filtrelemeye olanak tanıyan yeni ve daha güçlü bir accounts.list yöntemi kullanıma sunuyoruz.

Karşılaştırma isteği

İstek açıklaması Content API for Shopping Merchant API
Gelişmiş hesapların hesaplarını listeleme GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
Erişilebilen tüm hesapları listeleme Kullanılamıyor GET /accounts/v1/accounts

Ayrıntılı alan karşılaştırması (istek parametreleri)

Content API for Shopping (accounts.list) Merchant API (accounts.listSubaccounts) Notlar
merchant_id (yol parametresi) provider (yol parametresi) Gelişmiş hesabın accounts/{account} biçimindeki kimliği.
max_results page_size Döndürülecek maksimum hesap sayısı.
Önceki
Refactor code for concurrent requests
Sonraki
Migrate accountstatuses to Account Issues