Ana sayfa ayarlarını taşıma

Merchant API, özel bir Homepage kaynağı sunar. Bu kaynak, ana sayfa 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ğrulayın, ardından siteyi hesabınız için talep edin. 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ğı sağlar (accounts.homepage). (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, aşağıdaki işlemler için özel yöntemler sunar:
  • 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, bu kaynağı döndürerek mevcut durumla ilgili anında geri bildirim sağlar. 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 (Account.website_url tarihinde accounts.update kullanılarak 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

Merchant API'de kaynak tanımlama işlemi 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, talep etme 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 talebini başlatır veya yeniden doğrular. homepage.update kullanılarak daha önce ayarlanan uri üzerinde işlem yapar. overwrite parametresini içerir. Homepage kaynağını mevcut uri ve claimed durumuyla birlikte 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 talebini iptal etmek için Account.website_url ayarını boş dize olarak 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. Bu değişiklik, Merchant API'deki açık Homepage kaynağına doğru bir geçişi ifade ediyor.

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 bölümü, Content API for Shopping'deki name dizesinin accountId bölümüne karşılık gelir.
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 ve sahiplik, talepte bulunan hesap tarafından doğrulanabilirse başka bir hesabın 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) homepage.update kaynağının hangi alanlarının (ör. uri) güncellendiğini belirtmek için isteğe bağlı bir alan maskesi.Homepage
Önceki
Migrate user and access management
Sonraki
Migrate region management