Bu sayfa, Cloud Translation API ile çevrilmiştir.

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 kaynaklar, 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 sağlarlar. Örneğin, Kore işletme tescil numarası.
Basitleştirilmiş ana sayfa hak talebi: Mağazanın ana sayfa URL'sini özel bir homepage kaynağı 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:

POST https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/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/accounts/`accountId
Tanımlayıcılar	merchantId`/accounts/`accountId	`accounts/`accountId

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](/merchant/api/reference/rest/v1/accounts.v1beta.accounts.users)` kaynağında
`youtubeChannelLinks`	Henüz mevcut değil
`googleMyBusinessLink`	Henüz mevcut değil
`businessInformation`	`[businessInfo](/merchant/api/reference/rest/v1/BusinessInfo)` kaynağında
`businessIdentity`	`[businessIdentity](/merchant/api/reference/rest/v1/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
`businessInformation`	`businessInfo`
`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/accounts/`accountId`/homepage:claim`
	Daha fazla bilgi için Metod: 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/accounts/`accountId
`accounts.get`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`
`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/`accountId`:listSubaccounts`
`accounts.listlinks`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`/services`
`accounts.update`	Gerekli alanın veya alan grubunun tanımlandığı kaynak için bir güncelleme isteğiyle eşlenir.

Genel bakış

Envanter yönetimini taşı