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 फ़ील्ड के बारे में ज़्यादा जानकारी देता है. इस फ़ील्ड से, आपको किसी समस्या के असर के बारे में साफ़ तौर पर जानकारी मिलती है. इसमें डेस्टिनेशन (उदाहरण के लिए, शॉपिंग विज्ञापन), खास क्षेत्र, और उस क्षेत्र में समस्या की गंभीरता शामिल है.
  • Severity as an enum: severity फ़ील्ड अब एक enum है. इसमें 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} को पाथ पैरामीटर के तौर पर इस्तेमाल किया गया है. accounts/{ACCOUNT_ID} फ़ॉर्मैट में पाथ पैरामीटर के तौर पर {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 (string) name (string) समस्या के आइडेंटिफ़ायर को अब पूरा संसाधन नाम कहा जाता है. उदाहरण के लिए, accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (string) title (string) कोई बदलाव नहीं.
detail (string) detail (string) कोई बदलाव नहीं.
documentation (string) documentationUri (string) यह एक यूआरएल है, यह बताने के लिए फ़ील्ड का नाम बदला गया है.
severity (string) severity (enum) गंभीरता के लेवल को अब स्ट्रिंग के बजाय, स्ट्रक्चर्ड enum (CRITICAL, ERROR, SUGGESTION) के तौर पर दिखाया जाता है.
country (string), destination (string) impactedDestinations (बार-बार भेजा गया मैसेज) अब असर को एक सूची के तौर पर दिखाया जाता है. इसमें हर प्रभावित इलाके के लिए, डेस्टिनेशन, क्षेत्र, और गंभीरता को ग्रुप किया जाता है. Impact मैसेज में, country फ़ील्ड को regionCode से बदल दिया गया है.
(उपलब्‍ध नहीं) language_code, time_zone (अनुरोध पैरामीटर) list अनुरोध में नए पैरामीटर जोड़े गए हैं. इनकी मदद से, लोगों को आसानी से समझ में आने वाले फ़ील्ड को स्थानीय भाषा में दिखाया जा सकता है. जैसे, title और detail.
पीछे जाएं
Migrate account management
आगे बढ़ें
Migrate accountstatuses to Aggregate Product Statuses