accountstatuses से खाते की समस्याओं पर माइग्रेट करना

खाते के लेवल की उन समस्याओं को वापस पाने का तरीका बदल गया है जो आपके प्रॉडक्ट और खाते की परफ़ॉर्मेंस पर असर डाल सकती हैं. 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 फ़ील्ड की ज़्यादा जानकारी देता है. इस फ़ील्ड से, आपको किसी समस्या के असर के बारे में साफ़ तौर पर जानकारी मिलती है. जैसे, डेस्टिनेशन (उदाहरण के लिए, शॉपिंग विज्ञापन), खास क्षेत्र, और उस क्षेत्र में समस्या की गंभीरता.
• enum के तौर पर गंभीरता: severity फ़ील्ड अब एक enum है. इसमें CRITICAL, ERROR, SUGGESTION जैसी वैल्यू होती हैं. इससे, Content API for Shopping में स्ट्रिंग पर आधारित वैल्यू की तुलना में, प्रोग्राम के हिसाब से प्रोसेस करना आसान हो जाता है.
• स्टैंडर्ड आइडेंटिफ़ायर: खाते से जुड़ी हर समस्या के लिए, एक यूनीक, पूरा संसाधन name accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} फ़ॉर्मैट में होता है. यह स्टैंडर्ड तरीका, 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 का इस्तेमाल करें और खाता आईडी डालें. Merchant API में, किसी एक समस्या के लिए 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 जैसे इंसानों के पढ़ने लायक फ़ील्ड को स्थानीय भाषा में दिखाया जा सकता है.