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 (दोहराया गया मैसेज) असर को अब एक सूची में व्यवस्थित किया गया है. इसमें, असर वाले हर इलाके के लिए डेस्टिनेशन, क्षेत्र, और गंभीरता को ग्रुप किया गया है. Impact मैसेज में, country फ़ील्ड को regionCode से बदल दिया गया है.
(उपलब्‍ध नहीं) language_code, time_zone (अनुरोध के पैरामीटर) list अनुरोध में मौजूद नए पैरामीटर की मदद से, title और detail जैसे फ़ील्ड को स्थानीय भाषा में उपलब्ध कराया जा सकता है.
पीछे जाएं
Migrate account management
आगे बढ़ें
Migrate accountstatuses to Aggregate Product Statuses