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

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 पर दावा किया गया है और उसकी पुष्टि की गई है या नहीं. यह स्टेटस, Merchant API के सभी तरीकों से मिलने वाले Homepage रिसॉर्स में सीधे तौर पर उपलब्ध होता है.
लागू नहीं	UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage अनुरोध के मुख्य हिस्से का पैरामीटर)	homepage.update के लिए एक वैकल्पिक फ़ील्ड मास्क, जिससे यह तय किया जा सके कि Homepage संसाधन के किन फ़ील्ड (जैसे, uri) को अपडेट किया जा रहा है.