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 के नए रिसॉर्स से कैसे मैप होते हैं:
- खाते की मुख्य जानकारी (आईडी, नाम, वयस्कों के लिए बने कॉन्टेंट की सेटिंग)
Accountरिसॉर्स में मौजूद रहती है. - कारोबार की जानकारी (पता, फ़ोन नंबर, ग्राहक सेवा) को अब
BusinessInfoरिसॉर्स मैनेज करता है. - वेबसाइट के यूआरएल और दावे को
Homepageरिसोर्स मैनेज करता है. - उपयोगकर्ता मैनेजमेंट को
Userरिसॉर्स मैनेज करता है. - खाते के संबंध (ऐडवांस खातों, तीसरे पक्ष के सेवा देने वाले लोगों या कंपनियों, और Google की अन्य सेवाओं के लिंक) को
AccountRelationshipऔरAccountServiceसंसाधनों से मैनेज किया जाता है. - 'कारोबार की पहचान' एट्रिब्यूट (उदाहरण के लिए, कारोबार के मालिक अफ़्रीकी मूल के हैं, कारोबार महिला चलाती है) को
BusinessIdentityरिसॉर्स मैनेज करता है. - सेवा की शर्तों (टीओएस) के कानूनी समझौते, एक नई सुविधा है. इसे
TermsOfServiceऔरTermsOfServiceAgreementStateरिसॉर्स मैनेज करते हैं.
नई सुविधाएं
Merchant API में, खाता मैनेज करने के लिए नई सुविधाएं भी जोड़ी गई हैं. ये सुविधाएं, Content API for Shopping में उपलब्ध नहीं थीं:
- सेवा की शर्तें:
TermsOfServiceऔरTermsOfServiceAgreementStateरिसॉर्स का इस्तेमाल करके, प्रोग्राम के हिसाब से सेवा की शर्तें पाएं और उन्हें स्वीकार करें. - खाता बनाना:
accounts.createAndConfigureतरीके का इस्तेमाल करके, अब ऐसे खाते बनाए जा सकते हैं जो किसी दूसरे खाते से जुड़े हों. जैसे,accountManagement. साथ ही,aliasसेट किया जा सकता है. इसके अलावा,user.verificationMailSettings.verificationMailModeफ़ील्ड का इस्तेमाल करके, ईमेल पते की पुष्टि करने की प्रोसेस को रोका जा सकता है. इसके बजाय, नएaccounts.verifySelfतरीके का इस्तेमाल करके, एपीआई के ज़रिए पुष्टि की जा सकती है. - उपनाम से खाते को ऐक्सेस करना:
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 रिसॉर्स का इस्तेमाल करें. यह Content API for Shopping के websiteUrl फ़ील्ड और 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 ऐरे ऑब्जेक्ट) |
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 में उपलब्ध नहीं है. अब अमेरिका में लगने वाले सेल्स टैक्स की जानकारी देना ज़रूरी नहीं है. ज़्यादा जानकारी के लिए, साल 2025 में, Merchant Center के प्रॉडक्ट डेटा स्पेसिफ़िकेशन में किए गए बदलाव देखें.
कारोबार की पहचान मैनेज करना
अपने कारोबार के एट्रिब्यूट के बारे में खुद जानकारी देने के लिए,
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 |
ज़्यादा से ज़्यादा कितने खाते दिखाए जाएं. |