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:

• Temel hesap ayrıntıları (kimlik, ad, yetişkinlere uygun içerik ayarları) Account kaynağında kalır.
• İşletme bilgileri (adres, telefon numarası, müşteri hizmetleri) artık BusinessInfo kaynağı tarafından yönetiliyor.
• Web sitesi URL'si ve hak talebinde bulunma işlemi, Homepage kaynağı tarafından yapılır.
• Kullanıcı yönetimi, User kaynağı tarafından gerçekleştirilir.
• Hesap ilişkileri (gelişmiş hesaplara, üçüncü taraf sağlayıcılara ve diğer Google hizmetlerine bağlantılar) AccountRelationship ve AccountService kaynakları tarafından yönetilir.
• İşletme kimliği özellikleri (örneğin, siyahi girişimci, kadın girişimci) BusinessIdentity kaynağı tarafından yönetilir.
• Yeni bir özellik olan Hizmet Şartları (ToS) sözleşmeleri, TermsOfService ve TermsOfServiceAgreementState kaynakları tarafından yönetilir.

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 hesaplar (ör. accountManagement) oluşturmayı, 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ş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 dizisi 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, 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 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
Gelişmiş hesabın alt 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ı.