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

Shopping için Content API'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, bunu daha küçük ve daha odaklanmış birkaç kaynağa böler. Bu değişiklik, daha hedefli ve verimli API çağrıları yapılmasını sağlar. Örneğin, yalnızca işletme adresinizi güncellemek için artık tüm Account nesnesini güncellemek yerine BusinessInfo kaynağına PATCH isteği gönderiyorsunuz.

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.
  • Takma Adla Hesap Erişimi: Hesaplara providerId~accountAlias biçiminde erişin. Bu özellik, 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ğlanmaktadır.

İstek açıklaması Content API for Shopping Merchant API
Hesap oluşturma 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 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 temel ayrıntılarını içerir.

İstek karşılaştırması

İ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 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 yalnızca çıkış alanıdır. Birincil tanımlayıcı, kaynak name'dır.
name account_name Hesabın kullanıcılar tarafından okunabilir 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 bilgileri) yönetmek için BusinessInfo kaynağını kullanın. Bu, Content API for Shopping'deki businessInformation nesnesinin yerini alır.

İstek karşılaştırması

İ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 talebi 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.

İstek karşılaştırması

İ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
Ana sayfayla ilgili hak talebinde bulunma POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
Ana sayfa sahipliğini bırakma 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ğı, bir 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.

İstek karşılaştırması

İ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 yeni bir yalnızca çıkış alanı.

Hesap ilişkilerini ve hizmetlerini yönetme

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

İstek karşılaştırması

İ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ış 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.

İstek karşılaştırması

İ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ş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 (boolean) black_owned.identity_declaration (enum) Boole değeri, daha açık bir bildirim için 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 (boolean) promotions_consent (enum) Genel bir Boole değeri, daha açıklayıcı bir enum ile değiştirildi (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED).

Hesapları listeleme

Content API for Shopping'de tek gelişmiş hesap türü "çok müşterili hesap (MCA)" idi ve belirli bir çok müşterili hesabın alt 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ü ve ilişkisi 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.

İstek karşılaştırması

İstek açıklaması Content API for Shopping Merchant API
Alt hesapları 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 kimliği accounts/{account} biçimindedir.
max_results page_size Döndürülecek maksimum hesap sayısı.