होम पेज की सेटिंग माइग्रेट करना

Merchant API में एक खास Homepage संसाधन उपलब्ध है. इस संसाधन में, होम पेज पर किए गए दावे को मैनेज करने के नए तरीके दिए गए हैं. साथ ही, इसमें Content API for Shopping के क्लासिक वर्शन से ज़्यादा सुविधाएं उपलब्ध हैं.

अपने ऑनलाइन स्टोर के लिए सुविधाओं को ऐक्सेस करने की प्रोसेस दो चरणों में पूरी होती है: पहले मालिकाना हक की पुष्टि करना और फिर अपने खाते के लिए साइट पर दावा करना. आखिरी चरण पूरा करने के लिए, accounts.homepage.claim का इस्तेमाल करें.

मुख्य अंतर

Merchant API, Content API for Shopping की तुलना में होम पेज से जुड़े कई बदलाव करता है:

• होम पेज के लिए अलग संसाधन: Merchant API, होम पेज से जुड़ी सभी कार्रवाइयों के लिए, अलग Homepage संसाधन (accounts.homepage) उपलब्ध कराता है. (Content API for Shopping में, दावा करने की कार्रवाई करने के लिए accounts.claimwebsite का इस्तेमाल किया जाता था. होम पेज का यूआरएल website_url, Account संसाधन का हिस्सा था. साथ ही, दावे की स्थिति website_claimed, AccountStatus संसाधन का हिस्सा थी.)
• ज़्यादा जानकारी वाले तरीके: Merchant API, इन कामों के लिए खास तरीके उपलब्ध कराता है:
  • होम पेज की जानकारी वापस पाएं: accounts.homepage.getHomepage
  • होम पेज का यूआरआई अपडेट करें: accounts.homepage.updateHomepage
  • होम पेज पर दावा करें: accounts.homepage.claim
  • होम पेज का दावा छोड़ना: accounts.homepage.unclaim Content API for Shopping ने दावा छोड़ने की कार्रवाई के लिए accounts.claimwebsite का इस्तेमाल किया. साथ ही, यूआरएल सेट करने के लिए accounts.update का इस्तेमाल किया. इससे, खाली यूआरएल सेट करके दावा छोड़ने की कार्रवाई को असरदार तरीके से किया जा सका. इसके अलावा, यूआरएल और दावे की स्थिति को वापस पाने के लिए, accounts.get/accountstatuses.get का इस्तेमाल किया.
• एक जगह पर उपलब्ध जानकारी: Merchant API Homepage संसाधन में, uri (होम पेज का यूआरएल) और claimed की स्थिति, दोनों की जानकारी सीधे तौर पर उपलब्ध होती है. Homepage संसाधन पर काम करने वाले सभी तरीके, इस संसाधन को दिखाते हैं. इससे मौजूदा स्थिति के बारे में तुरंत जानकारी मिलती है. Content API for Shopping में, accounts.claimwebsite अपडेट की गई स्थिति नहीं दिखाई गई; इसके लिए अलग-अलग कॉल की ज़रूरत पड़ी.
• साफ़ तौर पर अस्वीकार करना: Content API for Shopping में, अस्वीकार करने के लिए आम तौर पर Account.website_url को खाली स्ट्रिंग पर अपडेट किया जाता था. Merchant API, इसके लिए एक खास homepage.unclaim तरीका उपलब्ध कराता है.
• दावे को बदलना: दोनों एपीआई, दावे की प्रोसेस के दौरान overwrite पैरामीटर का इस्तेमाल करते हैं. इससे, मालिकाना हक की पुष्टि होने पर, किसी दूसरे खाते से किए गए दावे को बदला जा सकता है.

अनुरोध

Merchant API, होम पेज के अलग-अलग पहलुओं को मैनेज करने के लिए, अलग-अलग RESTful एंडपॉइंट का इस्तेमाल करता है.

अनुरोध का ब्यौरा	Content API for Shopping	Merchant API
होम पेज की जानकारी पाना	accounts.get (Account.website_url पढ़ने के लिए), accountstatuses.get (AccountStatus.website_claimed पढ़ने के लिए)	GET /accounts/v1/accounts/{account}/homepage
होमपेज का यूआरआई अपडेट करना	accounts.update (Account.website_url सेटिंग)	PATCH /accounts/v1/accounts/{account}/homepage
होम पेज पर दावा करना या उसकी फिर से पुष्टि करना	POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite (accounts.update का इस्तेमाल करके सेट किए गए Account.website_url पर कार्रवाई की गई)	POST /accounts/v1/accounts/{account}/homepage:claim
होम पेज को अस्वीकार करना	accounts.update (Account.website_url को खाली स्ट्रिंग पर सेट करना)	POST /accounts/v1/accounts/{account}/homepage:unclaim

आइडेंटिफ़ायर

Merchant API में संसाधन की पहचान करने की प्रोसेस को आसान बना दिया गया है.

आइडेंटिफ़ायर की जानकारी	Shopping के लिए Content API	Merchant API
संसाधन ऐक्सेस करने के लिए खाता आइडेंटिफ़ायर	पाथ में merchantId (ऐडवांस खाता) और accountId (उप-खाता)	account (name फ़ील्ड का हिस्सा, जैसे कि accounts/{account_id}/homepage)
होम पेज का रिसॉर्स आइडेंटिफ़ायर	लागू नहीं होता (Account संसाधन के लिए डिफ़ॉल्ट रूप से लागू होता है)	name: accounts/{account_id}/homepage (Homepage सब-रिसोर्स की पहचान करता है)

तरीके

Content API for Shopping का accounts.claimwebsite तरीका, दावा करने की कार्रवाई पर फ़ोकस करता था. अब यह Merchant API के Homepage संसाधन में, ज़्यादा फ़ंक्शन के सेट का हिस्सा है.

Content API for Shopping का तरीका	Merchant API का तरीका	उपलब्धता और नोट
accounts.claimwebsite	accounts.homepage.claim	इससे वेबसाइट पर किए गए दावे की पुष्टि सीधे तौर पर शुरू होती है या उसकी फिर से पुष्टि की जाती है. homepage.update का इस्तेमाल करके पहले से सेट किए गए uri पर कार्रवाई करता है. इसमें overwrite पैरामीटर शामिल है. यह Homepage संसाधन को उसके मौजूदा uri और claimed स्टेटस के साथ दिखाता है.
accounts.get (Account.website_url पढ़ने के लिए), accountstatuses.get (AccountStatus.website_claimed पढ़ने के लिए)	accounts.homepage.getHomepage	मौजूदा होम पेज uri और उसके claimed स्टेटस को एक ही कॉल में वापस पाने का नया तरीका.
accounts.update (Account.website_url सेट करने के लिए)	accounts.homepage.updateHomepage	होम पेज सेट करने या बदलने का नया तरीका uri.
accounts.update (दावा हटाने के लिए, Account.website_url को खाली स्ट्रिंग पर सेट किया जा रहा है)	accounts.homepage.unclaim	होम पेज से दावा हटाने का नया तरीका.

फ़ील्ड में किए गए बदलावों की पूरी जानकारी

होम पेज पर मौजूद जानकारी को व्यवस्थित करने और उसे ऐक्सेस करने के तरीके में काफ़ी बदलाव हुआ है. अब यह जानकारी, Merchant API में मौजूद Homepage संसाधन के ज़रिए उपलब्ध कराई जाती है.

Shopping के लिए Content API	Merchant API	ब्यौरा
merchantId (accounts.claimwebsite के लिए पाथ पैरामीटर)	name (Homepage तरीकों के लिए पाथ पैरामीटर, फ़ॉर्मैट: accounts/{account}/homepage)	Merchant API में name स्ट्रिंग का account हिस्सा, Content API for Shopping के accountId से मेल खाता है.
accountId (accounts.claimwebsite के लिए पाथ पैरामीटर)	name (Homepage तरीकों के लिए पाथ पैरामीटर, फ़ॉर्मैट: accounts/{account}/homepage)	यह उस खाते का आइडेंटिफ़ायर होता है जिसके होम पेज को मैनेज किया जा रहा है.
overwrite (ContentAccountsClaimwebsiteRequest के मुख्य हिस्से में बूलियन और AccountsCustomBatchRequestEntry)	ClaimHomepageRequest.overwrite (homepage.claim अनुरोध के मुख्य हिस्से में बूलियन)	ज़रूरी नहीं. अगर true, वेबसाइट पर दावा करने की कोशिश करता है, तो हो सकता है कि वह किसी दूसरे खाते से किए गए मौजूदा दावे को हटा दे. ऐसा तब होगा, जब अनुरोध करने वाला खाता मालिकाना हक की पुष्टि कर पाएगा.
Account.website_url (Account संसाधन में मौजूद फ़ील्ड, accounts.update का इस्तेमाल करके सेट किया गया, accounts.get का इस्तेमाल करके पढ़ा गया)	Homepage.uri (Homepage संसाधन में मौजूद फ़ील्ड)	स्टोर के होम पेज का यूआरआई (यूआरएल). Merchant API में, यह Homepage संसाधन के अंदर मौजूद एक फ़ील्ड है. इसे accounts.homepage.updateHomepage का इस्तेमाल करके सेट किया जाता है. साथ ही, इसे सभी Homepage तरीकों से वापस भेजा जाता है.
AccountStatus.website_claimed (AccountStatus संसाधन में मौजूद फ़ील्ड, accountstatuses.get का इस्तेमाल करके पढ़ा गया)	Homepage.claimed (Homepage संसाधन में output_only बूलियन फ़ील्ड)	इससे पता चलता है कि uri पर दावा किया गया है और उसकी पुष्टि हो गई है. यह स्टेटस, सीधे तौर पर Homepage संसाधन में उपलब्ध होता है. यह संसाधन, Merchant API से जुड़े सभी तरीकों से मिलता है.
लागू नहीं	UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage अनुरोध के मुख्य हिस्से का पैरामीटर)	homepage.update के लिए वैकल्पिक फ़ील्ड मास्क, ताकि यह तय किया जा सके कि कौनसे फ़ील्ड (जैसे, Homepage संसाधन के uri) को अपडेट किया जा रहा है.