Hesap bağlamayı taşıma

Hesap ilişkilerinin yönetimi, Content API for Shopping'deki tek bir link yönteminden Merchant API'deki daha ayrıntılı ve açık bir sisteme dönüştü. Yeni API, bir hesabın diğerine sağladığı belirli hizmetleri tanımlamak için AccountRelationship ve AccountService gibi özel kaynaklar kullanır. Daha fazla bilgi için Hesaplar arasındaki ilişkiler başlıklı makaleyi inceleyin.

Temel farklılıklar

  • İlişkiler ve hizmetler için özel kaynaklar: Merchant API'de AccountRelationship kaynağı, bir hizmet sağlayıcı ile satıcı arasındaki bağlantıyı tanımlarken AccountService kaynağı, sağlanan hizmeti (ör. accountAggregation) belirtir. Bu, Content API for Shopping'deki genel linkType ve services alanlarının yerini alır.
  • Açık işlem yöntemleri: Merchant API, link yöntemini action parametresiyle kullanmak yerine hizmetleri yönetmek için propose, approve ve reject gibi farklı yöntemler kullanır.
  • Özel Google İşletme Profili bağlantısı: Daha önce googleMyBusinessLink alanı ayarlanarak gerçekleştirilen Google İşletme Profili'ne bağlantı oluşturma işlemi artık gbpAccounts.linkGbpAccount adlı özel bir yöntemle yapılıyor.
  • Hizmet olarak müşteri hesabı oluşturma: Gelişmiş bir hesap altında müşteri hesabı oluşturma artık accounts.createAndConfigure yöntemi kullanılarak accountAggregation hizmeti önerme olarak değerlendiriliyor. Hesaplar hakkında daha fazla bilgiyi Merchant Accounts API sayfasında bulabilirsiniz. Kullanıcı hem gelişmiş hesaba hem de müşteri hesabına erişebildiğinden el sıkışma gerekmez.

İstekler

Merchant API, farklı türlerdeki hesap bağlantılarını ve hizmetleri yönetmek için belirli uç noktalar sağlar:

Merchant API istek URL'leri

  • Yeni bir hizmet önerme: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • Hizmeti onaylama: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Bir hizmeti reddetme: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Google İşletme Profili'ne bağlantı oluşturma: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • Müşteri hesabı oluşturma (hesap toplama bağlantısı): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

İstek URL'si karşılaştırması

İstek açıklaması Content API for Shopping Merchant API
Hesapları bağlama (ör. üçüncü taraf platformları) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Google İşletme Profili ile bağlantı oluşturma PUT .../v2.1/{merchantId}/accounts/{accountId} (googleMyBusinessLink alanı ile) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
Müşteri hesabı oluşturma POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

Yöntemler

Content API for Shopping yöntemi Merchant API yöntemi Kullanılabilirlik ve notlar
accounts.link accountServices.propose Başka bir hesapla yeni bir hizmet başlatmak için bu yöntemi kullanın.
accounts.link (action: "approve" ile) accountServices.approve Bekleyen bir hizmet teklifini onaylamak için bu yöntemi kullanın.
accounts.link (action: "remove" ile) accountServices.reject Beklemede olan veya oluşturulmuş bir hizmeti reddetmek için bu yöntemi kullanın.
accounts.insert (müşteri hesapları için) accounts.createAndConfigure Gelişmiş bir hesap altında yeni bir müşteri hesabı oluşturmak için bu yöntemi bir accountAggregation hizmetiyle birlikte kullanın.
accounts.update (googleMyBusinessLink ile) gbpAccounts.linkGbpAccount Merchant Center hesabını Google İşletme Profili'ne bağlamak için bu özel yöntemi kullanın.
accounts.update (adsLinks ile) AccountRelationship kaynak Google Ads'e bağlama işlemi Google Ads kullanıcı arayüzünden yönetilir. Sonuçta elde edilen bağlantı, Merchant API'de AccountRelationship olarak gösterilir. Bu bağlantı görüntülenebilir ancak doğrudan oluşturulamaz.

Ayrıntılı alan değişiklikleri

Content API for Shopping Merchant API Açıklama
AccountsLinkRequest.action propose, approve, reject yöntemleri Tek action alanı, hizmet yaşam döngüsündeki her durum değişikliği için özel API yöntemleriyle değiştirilir.
AccountsLinkRequest.linkType AccountService.service_type Genel linkType dizesinin yerini, AccountService kaynağındaki yapılandırılmış bir service_type oneof alanı alır (ör. productsManagement veya accountAggregation).
AccountsLinkRequest.services AccountService.service_type Dize tabanlı hizmetlerin listesi artık AccountService kaynağında seçilen belirli service_type ile temsil ediliyor.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider Hizmeti sağlayan hesabın kimliği artık propose isteğinin provider alanında belirtiliyor.
Account.googleMyBusinessLink LinkGbpAccountRequest GBP bağlantı ayrıntılarını içeren nesnenin yerini linkGbpAccount yöntemi için özel bir istek mesajı alır.
Account.adsLinks AccountRelationship Google Ads bağlantıları, AccountRelationship kaynağı olarak gösterilir. Burada provider, providers/GOOGLE_ADS'dir. Bu ilişki genellikle Google Ads kullanıcı arayüzünden yönetilir.