Ana sayfa ayarlarını taşıma

Merchant API, özel bir Homepage kaynağı sunar. Bu kaynak, ana sayfa hak talebinizi yönetmek için yeni yöntemler sunar ve klasik Content API for Shopping'in ötesinde özellikler sağlar.

Online mağazanızın özelliklerine erişmek için iki adımlı bir işlem yapmanız gerekir: önce sahipliği doğrulamanız, ardından siteyi hesabınız için talep etmeniz gerekir. Son adımı tamamlamak için accounts.homepage.claim kullanın.

Temel farklar

Merchant API, Content API for Shopping'e kıyasla ana sayfayla ilgili çeşitli değişiklikler yapar:

• Özel kaynak: Merchant API, ana sayfayla ilgili tüm işlemler için ayrı bir Homepage kaynağı (accounts.homepage) sağlar. (Content API for Shopping'de hak talebi işlemini gerçekleştirmek için accounts.claimwebsite kullanıyordunuz, ana sayfa URL'si (website_url) Account kaynağının, hak talebi durumu (website_claimed) ise AccountStatus kaynağının bir parçasıydı.)
• Ayrıntılı yöntemler: Merchant API, şu işlemleri yapmanıza olanak tanıyan belirli yöntemler sunar:
  • Ana sayfa ayrıntılarını alma: accounts.homepage.getHomepage
  • Ana sayfa URI'sini güncelleyin: accounts.homepage.updateHomepage
  • Ana sayfayı talep etme: accounts.homepage.claim
  • Ana sayfayı reddetme: accounts.homepage.unclaim Alışveriş için Content API, hak talebi işlemi için accounts.claimwebsite, URL'yi ayarlamak için accounts.update (ve boş bir URL ayarlayarak etkili bir şekilde reddetmek) ve sırasıyla URL'yi ve hak talebi durumunu almak için accounts.get/accountstatuses.get kullanır.
• Merkezi bilgiler: Merchant API Homepage kaynağı hem uri (ana sayfa URL'si) hem de claimed durumunu doğrudan içerir. Homepage kaynağında çalışan tüm yöntemler, mevcut durumla ilgili anında geri bildirim sağlayarak bu kaynağı döndürür. Content API for Shopping'de, accounts.claimwebsite güncellenen durumu döndürmedi; ayrı çağrılar gerekiyordu.
• Açıkça sorumluluk reddi beyanı: Content API for Shopping'de sorumluluk reddi beyanı genellikle Account.website_url boş bir dize olarak güncellenerek yapılıyordu. Merchant API, özel bir homepage.unclaim yöntem sunar.
• İddiayı geçersiz kılma: Her iki API de, sahiplik doğrulanabiliyorsa başka bir hesaptaki iddiayı devralmak için iddia süreci sırasında overwrite parametresini destekler.

İstekler

Merchant API, ana sayfanın farklı yönlerini yönetmek için farklı RESTful uç noktaları kullanır.

İstek açıklaması	Content API for Shopping	Merchant API
Ana sayfa ayrıntılarını alma	accounts.get (Account.website_url okumak için), accountstatuses.get (AccountStatus.website_claimed okumak için)	GET /accounts/v1/accounts/{account}/homepage
Ana sayfa URI'sini güncelleme	accounts.update (Account.website_url ayarı)	PATCH /accounts/v1/accounts/{account}/homepage
Ana sayfayla ilgili hak talebinde bulunma veya sayfayı yeniden doğrulama	POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite (accounts.update kullanılarak Account.website_url tarihinde ayarlandı)	POST /accounts/v1/accounts/{account}/homepage:claim
Ana sayfayı reddetme	accounts.update (Account.website_url ayarını boş bir dizeye ayarlama)	POST /accounts/v1/accounts/{account}/homepage:unclaim

Tanımlayıcılar

Kaynak tanımlama, Merchant API'de kolaylaştırıldı.

Tanımlayıcı açıklaması	Content API for Shopping	Merchant API
Kaynak erişimi için hesap tanımlayıcısı	Yoldaki merchantId (gelişmiş hesap) ve accountId (alt hesap)	account (name alanının bir parçası, örneğin accounts/{account_id}/homepage)
Ana sayfa kaynak tanımlayıcısı	Geçerli değil (Account kaynağı için geçerli)	name: accounts/{account_id}/homepage (Homepage alt kaynağını tanımlar)

Yöntemler

Alışveriş için Content API'deki accounts.claimwebsite yöntemi, hak talebinde bulunma işlemine odaklanıyordu ve artık Merchant API'nin Homepage kaynağındaki daha geniş bir işlevler kümesinin parçası.

Content API for Shopping Yöntemi	Merchant API Yöntemi	Kullanılabilirlik ve Notlar
accounts.claimwebsite	accounts.homepage.claim	Doğrudan bir web sitesi hak talebini başlatır veya yeniden doğrular. homepage.update kullanılarak daha önce ayarlanan uri üzerinde işlem yapar. overwrite parametresi içerir. Mevcut uri ve claimed durumuyla birlikte Homepage kaynağını döndürür.
accounts.get (Account.website_url okumak için), accountstatuses.get (AccountStatus.website_claimed okumak için)	accounts.homepage.getHomepage	Mevcut ana sayfayı uri ve claimed durumunu tek bir çağrıyla almak için yeni bir yöntem.
accounts.update (Account.website_url olarak ayarlamak için)	accounts.homepage.updateHomepage	Ana sayfayı ayarlamak veya değiştirmek için yeni bir yöntem eklendi uri.
accounts.update (hak talebinde bulunmamak için geçici çözüm olarak Account.website_url ayarını boş dizeye ayarlama)	accounts.homepage.unclaim	Ana sayfanın sahipliğini açıkça kaldırmak için yeni bir yöntem.

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

Ana sayfa bilgilerinin yapılandırılma ve erişilme şekli önemli ölçüde değişti. Artık Merchant API'deki açık Homepage kaynağı kullanılıyor.

Content API for Shopping	Merchant API	Açıklama
merchantId (accounts.claimwebsite için yol parametresi)	name (Homepage yöntemleri için yol parametresi, biçim: accounts/{account}/homepage)	Merchant API'deki account dizesinin name kısmı, Content API for Shopping'deki accountId ile eşleşir.
accountId (accounts.claimwebsite için yol parametresi)	name (Homepage yöntemleri için yol parametresi, biçim: accounts/{account}/homepage)	Ana sayfası yönetilen belirli hesabın tanımlayıcısı.
overwrite (ContentAccountsClaimwebsiteRequest gövdesinde ve AccountsCustomBatchRequestEntry içinde boole)	ClaimHomepageRequest.overwrite (homepage.claim istek metninde boole)	İsteğe bağlı. true, web sitesi için hak talebinde bulunursa sahiplik, talepte bulunan hesap tarafından doğrulanabildiği takdirde başka bir hesaptaki mevcut hak talebi kaldırılabilir.
Account.website_url (Account kaynağındaki alan, accounts.update kullanılarak ayarlanır, accounts.get kullanılarak okunur)	Homepage.uri (Homepage kaynağındaki alan)	Mağazanın ana sayfasının URI'si (URL). Merchant API'de bu, Homepage kaynağındaki açık bir alandır. accounts.homepage.updateHomepage kullanılarak ayarlanır ve tüm Homepage yöntemleriyle döndürülür.
AccountStatus.website_claimed (AccountStatus kaynağındaki alan, accountstatuses.get kullanılarak okunur)	Homepage.claimed (Homepage kaynağındaki output_only boolean alanı)	uri öğesinin talep edilip doğrulandığını gösterir. Bu durum, ilişkili tüm Merchant API yöntemleri tarafından döndürülen Homepage kaynağında doğrudan kullanılabilir.
Yok	UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage istek gövdesi parametresi)	Hangi alanların (ör.homepage.update Homepage kaynağının uri) güncelleniyor.