खाते के मैनेजमेंट को माइग्रेट करें

Accounts API को संसाधनों के कलेक्शन में बांटा गया है, ताकि Merchant Center खातों को ज़्यादा असरदार तरीके से मैनेज किया जा सके. साथ ही, खाते के अलग-अलग पहलुओं पर ज़्यादा सटीक कंट्रोल रखा जा सके.

इस गाइड में, मुख्य बदलावों के बारे में बताया गया है. साथ ही, इसमें आपको अपने मौजूदा खाते के मैनेजमेंट इंटिग्रेशन को Content API for Shopping से Merchant API पर माइग्रेट करने में मदद मिलती है.

एक संसाधन से कई संसाधनों पर

Content API for Shopping में, Account संसाधन एक मोनोलिथिक ऑब्जेक्ट था. इसमें खाते के नाम और वेबसाइट के यूआरएल से लेकर उपयोगकर्ता सूचियों और कारोबार की जानकारी तक सब कुछ शामिल था.

Merchant API, इसे कई छोटे-छोटे और ज़्यादा फ़ोकस किए गए संसाधनों में बांटता है. इस बदलाव से, एपीआई कॉल को ज़्यादा टारगेट किया जा सकेगा और वे ज़्यादा असरदार होंगी. उदाहरण के लिए, सिर्फ़ अपने कारोबार का पता अपडेट करने के लिए, अब आपको पूरे Account ऑब्जेक्ट को अपडेट करने के बजाय, BusinessInfo रिसॉर्स के लिए PATCH अनुरोध करना होगा.

यहां इस बारे में खास जानकारी दी गई है कि Content API for Shopping Account के संसाधन, Merchant API के नए संसाधनों से कैसे मैप होते हैं:

नई सुविधाएं

Merchant API में, खाता मैनेजमेंट के लिए नई सुविधाएं भी जोड़ी गई हैं. ये सुविधाएं, Content API for Shopping में उपलब्ध नहीं थीं:

  • सेवा की शर्तें: TermsOfService और TermsOfServiceAgreementState संसाधनों का इस्तेमाल करके, प्रोग्राम के हिसाब से सेवा की शर्तें पाएं और उन्हें स्वीकार करें.
  • उर्फ़ के तौर पर इस्तेमाल किए जाने वाले नाम से खाते का ऐक्सेस: providerId~accountAlias फ़ॉर्मैट का इस्तेमाल करके खातों को ऐक्सेस करें. इससे, एक से ज़्यादा खाते मैनेज करने वाले कारोबारों को अपने खाते के आइडेंटिफ़ायर का इस्तेमाल करने का एक जैसा तरीका मिलता है.

अनुरोध

इस टेबल में, Content API for Shopping और Merchant API के बीच, खाते को मैनेज करने से जुड़े सामान्य टास्क के लिए अनुरोध किए गए यूआरएल की तुलना की गई है.

अनुरोध का ब्यौरा Shopping के लिए Content API Merchant API
खाता पाएं GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
उपनाम के हिसाब से खाता पाना सीधे तौर पर उपलब्ध नहीं है GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
उप-खातों की सूची बनाना GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
उप-खाता बनाना POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
खाते का डेटा अपडेट करना PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} PATCH पर क्लिक करें. उदाहरण के लिए, खाते का नाम अपडेट करने के लिए: PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
उप-खाता मिटाना DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
वेबसाइट पर दावा करना POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
खातों को जोड़ें POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

मुख्य खाते की जानकारी मैनेज करना

Merchant API में मौजूद Account संसाधन में, Merchant Center खाते की ज़रूरी जानकारी होती है. जैसे, उसका नाम, आईडी, और बुनियादी सेटिंग.

तुलना करने का अनुरोध करना

अनुरोध का ब्यौरा Shopping के लिए Content API Merchant API
खाते की जानकारी पाना GET /content/v2.1/{merchantId}/accounts/{accountId} (name, adult_content जैसे मुख्य एट्रिब्यूट ऐक्सेस करना) GET /accounts/v1/accounts/{account}
उप-खाता बनाना POST /content/v2.1/{merchantId}/accounts POST /accounts/v1/accounts:createAndConfigure
खाते की जानकारी अपडेट करना PUT /content/v2.1/{merchantId}/accounts/{accountId} (मुख्य एट्रिब्यूट अपडेट किए जा रहे हैं) PATCH /accounts/v1/accounts/{account}
किसी उप-खाते को मिटाना DELETE /content/v2.1/{merchantId}/accounts/{accountId} DELETE /accounts/v1/accounts/{account}

फ़ील्ड की पूरी जानकारी के साथ तुलना करना

Content API for Shopping (Account) Merchant API (Account) नोट
id account_id अब संख्या वाला आईडी, सिर्फ़ आउटपुट फ़ील्ड है. प्राइमरी आइडेंटिफ़ायर, संसाधन name होता है.
name account_name खाते का ऐसा नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
language language_code अब फ़ील्ड का नाम language_code है.

कारोबार की जानकारी मैनेज करना

अपने कारोबार के बारे में सार्वजनिक जानकारी मैनेज करने के लिए, BusinessInfo संसाधन का इस्तेमाल करें. जैसे, आपका पता और ग्राहक सेवा से संपर्क करने की जानकारी. यह Content API for Shopping में मौजूद businessInformation ऑब्जेक्ट की जगह लेता है.

तुलना करने का अनुरोध करना

अनुरोध का ब्यौरा Shopping के लिए Content API Merchant API
कारोबार की जानकारी पाना GET /content/v2.1/{merchantId}/accounts/{accountId} (business_information एट्रिब्यूट को ऐक्सेस करना) GET /accounts/v1/accounts/{account}/businessInfo
कारोबार की जानकारी अपडेट करना PUT /content/v2.1/{merchantId}/accounts/{accountId} (business_information एट्रिब्यूट की वैल्यू अपडेट करना) PATCH /accounts/v1/accounts/{account}/businessInfo

फ़ील्ड की पूरी जानकारी के साथ तुलना करना

Content API for Shopping (business_information) Merchant API (BusinessInfo) नोट
phone_number phone अब यह फ़ील्ड phone है और google.type.PhoneNumber का इस्तेमाल करता है.
customer_service.url customer_service.uri अब फ़ील्ड का नाम uri है.

अपना होम पेज मैनेज करना

अपने स्टोर की वेबसाइट के यूआरएल को मैनेज करने के लिए, Homepage संसाधन का इस्तेमाल करें. साथ ही, इसकी पुष्टि करें और इस पर दावा करें. यह websiteUrl फ़ील्ड और Content API for Shopping के accounts.claimwebsite तरीके की जगह लेता है.

तुलना करने का अनुरोध करना

अनुरोध का ब्यौरा Shopping के लिए Content API Merchant API
होम पेज का यूआरएल पाना GET /content/v2.1/{merchantId}/accounts/{accountId} (website_url एट्रिब्यूट को ऐक्सेस करना) GET /accounts/v1/accounts/{account}/homepage
होम पेज का यूआरएल अपडेट करना PUT /content/v2.1/{merchantId}/accounts/{accountId} (website_url एट्रिब्यूट की वैल्यू अपडेट करना) PATCH /accounts/v1/accounts/{account}/homepage
होम पेज पर दावा करना POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
होम पेज पर दावा छोड़ना उपलब्ध नहीं है POST /accounts/v1/accounts/{account}/homepage:unclaim

फ़ील्ड की पूरी जानकारी के साथ तुलना करना

Content API for Shopping (Account) Merchant API (Homepage) नोट
website_url uri स्टोर के होम पेज का यूआरएल.
सीधे तौर पर उपलब्ध नहीं है claimed यह एक बूलियन फ़ील्ड है. अगर होम पेज पर दावा किया गया है, तो इसकी वैल्यू true होती है.

उपयोगकर्ताओं को मैनेज करना

User संसाधन की मदद से, यह मैनेज किया जा सकता है कि कौन Merchant Center खाते को ऐक्सेस कर सकता है. यह Account रिसॉर्स में मौजूद users अरे की जगह लेता है. मुख्य अंतर, उपयोगकर्ता बनाने की प्रोसेस में है. Merchant API में, किसी उपयोगकर्ता को जोड़ने पर उसे न्योता भेजा जाता है. उपयोगकर्ता को खाता ऐक्सेस करने से पहले, न्योता स्वीकार करना होगा.

तुलना करने का अनुरोध करना

अनुरोध का ब्यौरा Shopping के लिए Content API Merchant API
उपयोगकर्ताओं की सूची बनाना GET /content/v2.1/{merchantId}/accounts/{accountId} (users एट्रिब्यूट को ऐक्सेस करना) GET /accounts/v1/accounts/{account}/users
उपयोगकर्ता बनाना PUT /content/v2.1/{merchantId}/accounts/{accountId} (users एट्रिब्यूट की वैल्यू अपडेट करना) POST /accounts/v1/accounts/{account}/users
किसी उपयोगकर्ता की जानकारी अपडेट करना PUT /content/v2.1/{merchantId}/accounts/{accountId} (users एट्रिब्यूट की वैल्यू अपडेट करना) PATCH /accounts/v1/accounts/{account}/users/{email}
उपयोगकर्ता को हटाना PUT /content/v2.1/{merchantId}/accounts/{accountId} (users एट्रिब्यूट की वैल्यू अपडेट करना) DELETE /accounts/v1/accounts/{account}/users/{email}

फ़ील्ड की पूरी जानकारी के साथ तुलना करना

Content API for Shopping (users array object) Merchant API (User संसाधन) नोट
email_address name (accounts/{account}/users/{email} फ़ॉर्मैट में) उपयोगकर्ता का ईमेल पता अब संसाधन के नाम का हिस्सा है.
admin, order_manager, reporting_manager वगैरह access_rights ऐक्सेस के अधिकारों को अब दोहराए गए enum फ़ील्ड में शामिल कर दिया गया है.
उपलब्ध नहीं है state सिर्फ़ आउटपुट वाला नया फ़ील्ड. इससे पता चलता है कि उपयोगकर्ता PENDING है या VERIFIED.

खाते के संबंध और सेवाओं को मैनेज करना

Content API for Shopping में, संबंधों को accounts.link की मदद से मैनेज किया जाता था. Merchant API, AccountService और AccountRelationship संसाधनों के साथ ज़्यादा साफ़ तौर पर मॉडल पेश करता है. इसके लिए, हैंडशेक प्रोसेस (प्रस्ताव देना और स्वीकार करना) ज़रूरी है.

तुलना करने का अनुरोध करना

अनुरोध का ब्यौरा Shopping के लिए Content API Merchant API
खातों को जोड़ें POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
लिंक किए गए खातों की सूची GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks GET /accounts/v1/accounts/{account}/relationships और GET /accounts/v1/accounts/{account}/services

फ़ील्ड की पूरी जानकारी के साथ तुलना करना

Content API for Shopping (AccountLink) Merchant API (AccountService, AccountRelationship) नोट
linked_account_id provider (AccountService में) सेवा देने वाले खाते का आईडी.
service service_type (AccountService में) दी जा रही सेवा का टाइप (जैसे, ACCOUNT_AGGREGATION).
status handshake.approval_state (AccountService में) लिंक का स्टेटस (जैसे, PENDING, ESTABLISHED).

खाते के टैक्स की सेटिंग

Content API for Shopping की accounttax सेवा, Merchant API में उपलब्ध नहीं है. अब अमेरिका में लगने वाले सेल्स टैक्स की जानकारी देने की ज़रूरत नहीं है. ज़्यादा जानकारी के लिए, Merchant Center के प्रॉडक्ट डेटा स्पेसिफ़िकेशन में, साल 2025 में किए गए बदलाव देखें.

कारोबार की पहचान मैनेज करना

अपने कारोबार के एट्रिब्यूट के बारे में खुद जानकारी देने के लिए, BusinessIdentity रिसोर्स का इस्तेमाल करें. यह Content API for Shopping में मौजूद businessIdentity ऑब्जेक्ट की जगह लेता है.

तुलना करने का अनुरोध करना

अनुरोध का ब्यौरा Shopping के लिए Content API Merchant API
कारोबार की पहचान की पुष्टि कराना GET /content/v2.1/{merchantId}/accounts/{accountId} (business_identity एट्रिब्यूट को ऐक्सेस करना) GET /accounts/v1/accounts/{account}/businessIdentity
कारोबार की पहचान अपडेट करना PUT /content/v2.1/{merchantId}/accounts/{accountId} (business_identity एट्रिब्यूट की वैल्यू अपडेट करना) PATCH /accounts/v1/accounts/{account}/businessIdentity

फ़ील्ड की पूरी जानकारी के साथ तुलना करना

Content API for Shopping (business_identity) Merchant API (BusinessIdentity) नोट
black_owned.self_identified (बूलियन) black_owned.identity_declaration (enum) ज़्यादा साफ़ तौर पर जानकारी देने के लिए, बूलियन को enum (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) से बदल दिया गया है. यह सभी पहचान एट्रिब्यूट पर लागू होता है.
include_for_promotions (बूलियन) promotions_consent (enum) ग्लोबल बूलियन को ज़्यादा जानकारी देने वाले enum (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED) से बदल दिया गया है.

खातों की सूची बनाएं

Content API for Shopping में, ऐडवांस खाते के तौर पर सिर्फ़ 'एक से ज़्यादा क्लाइंट वाला खाता (एमसीए)' उपलब्ध था. इसमें, accounts.list तरीके का इस्तेमाल करके, एक से ज़्यादा क्लाइंट वाले खाते के उप-खातों की सूची दिखाई जाती थी. Merchant API में मौजूद ऐडवांस खाते, ज़्यादा बेहतर होते हैं. इनसे अलग-अलग तरह के खातों और उनके बीच के संबंधों को मैनेज किया जा सकता है. ऐडवांस खातों को आसानी से माइग्रेट करने के लिए, Merchant API, Content API for Shopping के accounts.list के बराबर accounts.listSubaccounts तरीके का इस्तेमाल करता है. हम एक नया और ज़्यादा बेहतर accounts.list तरीका लेकर आ रहे हैं. इससे खातों को बेहतर तरीके से फ़िल्टर किया जा सकेगा.

तुलना करने का अनुरोध करना

अनुरोध का ब्यौरा Shopping के लिए Content API Merchant API
उप-खातों की सूची बनाना GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
ऐक्सेस किए जा सकने वाले सभी खातों की सूची बनाना उपलब्ध नहीं है GET /accounts/v1/accounts

फ़ील्ड की पूरी तुलना (अनुरोध के पैरामीटर)

Content API for Shopping (accounts.list) Merchant API (accounts.listSubaccounts) नोट
merchant_id (पाथ पैरामीटर) provider (पाथ पैरामीटर) बेहतर खाते का आईडी, accounts/{account} फ़ॉर्मैट में होता है.
max_results page_size ज्यादा से ज्यादा कितने खाते दिखाने हैं.