Hesap yönetimini taşı

Accounts API, Merchant Center hesaplarınızı hesabınızın farklı yönleri üzerinde daha hassas kontrolle daha verimli bir şekilde yönetmenize olanak tanımak için bir kaynak koleksiyonuna bölünmüştür.

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

Bir kaynaktan birçok 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 monolitik bir nesneydi.

Merchant API, bu kaynağı daha küçük ve daha odaklı birkaç kaynağa böler. Bu değişiklik, daha hedefli ve verimli API çağrıları yapılmasına olanak tanır. Örneğin, yalnızca işletme adresinizi güncellemek için artık tüm Account nesnesini güncellemek yerine BusinessInfo kaynağına bir PATCH isteği gönderirsiniz.

Content API for Shopping Account kaynağındaki kavramların Merchant API'deki yeni kaynaklarla nasıl eşleştiğini gösteren bir özet:

Yeni özellikler

Merchant API, Content API for Shopping'de bulunmayan yeni hesap yönetimi özellikleri de sunar:

  • Hizmet Şartları: TermsOfService ve TermsOfServiceAgreementState kaynaklarını kullanarak Hizmet Şartları'nı programatik olarak alıp kabul edin.
  • Hesap oluşturma: accounts.createAndConfigure yöntemi artık ilişkili hesaplar (ör. accountManagement) oluşturmayı, alias ayarlamayı ve yeni accounts.verifySelf yöntemini kullanarak API tabanlı doğrulama lehine user.verificationMailSettings.verificationMailMode alanını kullanarak e-posta doğrulamasını engellemeyi destekliyor.
  • Takma adla hesaba erişim: providerId~accountAlias biçimini kullanarak hesaplara erişin. Bu sayede, birden fazla hesabı yöneten işletmeler kendi hesap tanımlayıcılarını tutarlı bir şekilde kullanabilir.

İstekler

Bu tabloda, Content API for Shopping ve Merchant API'deki yaygın hesap yönetimi görevleri için istek URL'lerinin birleştirilmiş bir karşılaştırması sunulmaktadır.

İstek açıklaması Content API for Shopping Merchant API
Hesap alma 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. Ö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 sitesiyle ilgili 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 önemli ayrıntıları 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şim) 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üncelleyin PUT /content/v2.1/{merchantId}/accounts/{accountId} (temel özellikler güncelleniyor) PATCH /accounts/v1/accounts/{account}
Alt hesap 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 salt çıkış alanıdır. Birincil tanımlayıcı, name kaynağı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 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şiliyor) GET /accounts/v1/accounts/{account}/businessInfo
İşletme bilgilerini güncelleyin 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 al GET /content/v2.1/{merchantId}/accounts/{accountId} (website_url özelliğine erişiliyor) 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 için hak talebinde bulunulmuşsa 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 farklardan biri, kullanıcı oluşturma sürecidir. Merchant API'de kullanıcı eklediğinizde 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şiliyor) 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ştirilmiştir.
Kullanılamıyor state Kullanıcının PENDING veya VERIFIED olup olmadığını gösteren, salt çıkışlı yeni bir alan.

Hesap ilişkilerini ve hizmetleri 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. Bu model, el sıkışma süreci (teklif 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) Sağlanan 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ış vergisini sağlamak artık zorunlu değildir. 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 beyan etmek 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 alma GET /content/v2.1/{merchantId}/accounts/{accountId} (business_identity özelliğine erişiliyor) 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 değeri bir enum (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) ile değiştirilir. Bu durum tüm kimlik özellikleri için geçerlidir.
include_for_promotions (boole) promotions_consent (enum) Global bir boole, daha açıklayıcı bir enum (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED) ile değiştirildi.

Hesapları listeleme

Content API for Shopping'de tek gelişmiş hesap türü "Çok Müşterili Hesap (MCA)" idi ve bu hesap, belirli bir çok müşterili hesabın hesaplarını listelemek için bir accounts.list yöntemi sunuyordu. Merchant API'deki gelişmiş hesaplar çok daha güçlüdür ve daha geniş bir hesap türü ve ilişki yelpazesine olanak tanır. Gelişmiş hesapların kolayca taşınabilmesi 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öntemini kullanıma sunuyoruz.

Karşılaştırma isteği

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

Ayrıntılı alan karşılaştırması (İstek 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