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} को पाथ पैरामीटर के तौर पर इस्तेमाल किया गया है. {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 जैसे ऐसे फ़ील्ड को स्थानीय भाषा में दिखाया जा सकता है जिन्हें आसानी से पढ़ा जा सकता है.
पीछे जाएं
Migrate account management
आगे बढ़ें
Migrate accountstatuses to Aggregate Product Statuses