खाते के लेवल की उन समस्याओं को वापस पाने का तरीका बदल गया है जो आपके प्रॉडक्ट और खाते की परफ़ॉर्मेंस पर असर डाल सकती हैं. Content API for Shopping में मौजूद accountstatuses संसाधन की तुलना में, Merchant API में एक खास AccountIssue संसाधन उपलब्ध है. यह ज़्यादा स्ट्रक्चर्ड और ज़्यादा जानकारी देता है.
नई सुविधा को इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, खाते से जुड़ी समस्याएं देखने की गाइड पढ़ें.
ध्यान दें: Merchant API में, खाते के लेवल की समस्याओं और प्रॉडक्ट की कुल स्थितियों को अलग-अलग किया जाता है. accountstatuses से प्रॉडक्ट के एग्रीगेट किए गए स्टेटस पर माइग्रेट करने के बारे में हमारी गाइड भी देखें.
मुख्य अंतर
Merchant API AccountIssue रिसॉर्स में किए गए मुख्य सुधार और अंतर यहां दिए गए हैं:
- खास संसाधन: खाते से जुड़ी समस्याएं, उनके अपने संसाधन हैं. Content API for Shopping में, खाता लेवल की समस्याएं, सामान्य
AccountStatusरिसॉर्स में नेस्ट किया गया फ़ील्ड था. Merchant API की मदद से,accounts.issues.listतरीके का इस्तेमाल करके, उन्हें सीधे तौर पर लिस्ट किया जा सकता है. - स्ट्रक्चर्ड इंपैक्ट डेटा:
AccountIssueसंसाधन,impactedDestinationsफ़ील्ड के बारे में ज़्यादा जानकारी देता है. इस फ़ील्ड से, आपको किसी समस्या के असर के बारे में साफ़ तौर पर जानकारी मिलती है. इसमें डेस्टिनेशन (उदाहरण के लिए, शॉपिंग विज्ञापन), खास क्षेत्र, और उस क्षेत्र में समस्या की गंभीरता शामिल है. - एनम के तौर पर गंभीरता:
severityफ़ील्ड अब एक एनम है. इसमेंCRITICAL,ERROR,SUGGESTIONजैसी वैल्यू होती हैं. इससे, Content API for Shopping में स्ट्रिंग पर आधारित वैल्यू की तुलना में, प्रोग्राम के हिसाब से प्रोसेस करना आसान हो जाता है. - स्टैंडर्ड आइडेंटिफ़ायर: खाते से जुड़ी हर समस्या के लिए,
accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}फ़ॉर्मैट में एक यूनीक, पूरा संसाधनnameहोता है. मानकीकृत किए गए इस तरीके से, Content API for Shopping कीidस्ट्रिंग बदल जाती है. - स्थानीय भाषा में जानकारी पाने की सुविधा:
accounts.issues.listतरीके से,language_codeको सेट किया जा सकता है. इससे आपको समस्या की जानकारी, जैसे कि टाइटल और ब्यौरा, अपनी पसंदीदा भाषा में मिल सकती है. Content API for Shopping में ऐसा नहीं किया जा सकता था. - ऐडवांस खाते का व्यवहार: ऐडवांस खाते में
accounts.issues.listको कॉल करने पर, यह सिर्फ़ उन समस्याओं को दिखाता है जो सीधे तौर पर उस ऐडवांस खाते पर लागू होती हैं. यह अपने किसी भी उप-खाते के लिए समस्याएं नहीं दिखाता है. Content API for Shopping में,accountstatuses.listतरीके से सभी उप-खातों के स्टेटस दिखेंगे. Merchant API में सभी उप-खातों से जुड़ी समस्याएं पाने के लिए, आपकोaccounts.listSubaccountsको कॉल करना होगा. इसके बाद, हर उप-खाते के लिए अलग-अलगaccounts.issues.listको कॉल करना होगा.
अनुरोध
Merchant API में, किसी Merchant Center खाते से जुड़ी समस्याएं दिखाई जा सकती हैं.
GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues
यूआरएल की तुलना करने का अनुरोध करना
| अनुरोध का ब्यौरा | Shopping के लिए Content API | Merchant API |
|---|---|---|
| किसी एक खाते के लिए, खाता-लेवल की समस्याएं दिखाएं | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} |
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues |
| किसी ऐडवांस खाते के सभी उप-खातों के लिए, खाते के लेवल की समस्याएं दिखाएं | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses |
यह सुविधा उपलब्ध नहीं है. आपको उप-खातों के हिसाब से दोहराना होगा. |
आइडेंटिफ़ायर
Merchant API में खातों और समस्याओं के आइडेंटिफ़ायर बदल गए हैं.
आइडेंटिफ़ायर की तुलना
| आइडेंटिफ़ायर की जानकारी | Shopping के लिए Content API | Merchant API |
|---|---|---|
| खाता आइडेंटिफ़ायर | {MERCHANT_ID} और {ACCOUNT_ID} को पाथ पैरामीटर के तौर पर इस्तेमाल किया जाता है. |
{ACCOUNT_ID} को accounts/{ACCOUNT_ID} फ़ॉर्मैट में पाथ पैरामीटर के तौर पर इस्तेमाल करें. |
| समस्या का आइडेंटिफ़ायर | जवाब के मुख्य हिस्से में मौजूद id फ़ील्ड (उदाहरण के लिए, "products-that-enable-dishonest-behavior-hacking-policy"). |
जवाब के मुख्य हिस्से में मौजूद name फ़ील्ड, जो संसाधन का पूरा नाम है. उदाहरण के लिए, accounts/12345/issues/example-issue-id. |
तरीके
Merchant API में, खाते से जुड़ी समस्याओं को वापस पाने के तरीकों को एक साथ रखा गया है और उन्हें आसान बनाया गया है.
तरीकों की तुलना
| Shopping के लिए Content API | Merchant API | उपलब्धता और नोट |
|---|---|---|
accountstatuses.get |
accounts.issues.list |
उपलब्ध है. किसी एक खाते से जुड़ी समस्याएं पाने के लिए, accounts.issues.list का इस्तेमाल करें और खाते का आईडी डालें. कारोबारी या कंपनी के एपीआई में, किसी एक समस्या के लिए get तरीका उपलब्ध नहीं है. |
accountstatuses.list |
कोई भी सुविधा सीधे तौर पर उपलब्ध नहीं है. | उपलब्ध नहीं है. Merchant API में accounts.issues.list तरीके का इस्तेमाल करके, सिर्फ़ चुने गए खाते से जुड़ी समस्याएं देखी जा सकती हैं. इसके उप-खातों से जुड़ी समस्याएं नहीं देखी जा सकतीं. सभी उप-खातों से जुड़ी समस्याएं पाने के लिए, आपको सबसे पहले accounts.listSubaccounts को कॉल करना होगा. इसके बाद, हर उप-खाते के लिए accounts.issues.list को कॉल करना होगा. |
accountstatuses.custombatch |
कोई भी सुविधा सीधे तौर पर उपलब्ध नहीं है. | उपलब्ध नहीं है. Merchant API में, खाते से जुड़ी समस्याओं के लिए बैच प्रोसेसिंग की सुविधा उपलब्ध नहीं है. आपको हर खाते के लिए अलग-अलग list कॉल करने होंगे. |
फ़ील्ड में किए गए बदलावों की पूरी जानकारी
खाते से जुड़ी समस्या की जानकारी देने वाले संसाधन के फ़ील्ड अपडेट किए गए हैं, ताकि ज़्यादा स्ट्रक्चर और साफ़ तौर पर जानकारी दी जा सके.
फ़ील्ड की तुलना
| Shopping के लिए Content API | Merchant API | ब्यौरा |
|---|---|---|
accountLevelIssues (AccountStatus में मौजूद कलेक्शन) |
accountIssues (ListAccountIssuesResponse में मौजूद कलेक्शन) |
समस्याएं अब एक खास और टॉप-लेवल का संसाधन हैं, न कि नेस्ट किया गया फ़ील्ड. |
id (स्ट्रिंग) |
name (स्ट्रिंग) |
समस्या का आइडेंटिफ़ायर अब पूरा संसाधन नाम है. उदाहरण के लिए, accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. |
title (स्ट्रिंग) |
title (स्ट्रिंग) |
कोई बदलाव नहीं. |
detail (स्ट्रिंग) |
detail (स्ट्रिंग) |
कोई बदलाव नहीं. |
documentation (स्ट्रिंग) |
documentationUri (स्ट्रिंग) |
इस फ़ील्ड का नाम बदलकर, इसे यूआरएल के तौर पर दिखाया गया है. |
severity (स्ट्रिंग) |
severity (enum) |
गंभीरता अब स्ट्रिंग के बजाय स्ट्रक्चर्ड enum (CRITICAL, ERROR, SUGGESTION) है. |
country (string), destination (string) |
impactedDestinations (बार-बार दिखने वाला मैसेज) |
अब असर को एक सूची में व्यवस्थित किया गया है. इसमें हर प्रभावित इलाके के लिए, डेस्टिनेशन, क्षेत्र, और गंभीरता को ग्रुप किया गया है. country फ़ील्ड को Impact मैसेज में regionCode से बदल दिया जाता है. |
| (उपलब्ध नहीं) | language_code, time_zone (अनुरोध पैरामीटर) |
list अनुरोध में नए पैरामीटर जोड़े गए हैं. इनकी मदद से, title और detail जैसे ऐसे फ़ील्ड को स्थानीय भाषा में दिखाया जा सकता है जिन्हें आसानी से पढ़ा जा सकता है. |