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

अनुरोध यूआरएल की तुलना

अनुरोध का ब्यौरा Content API for Shopping 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 में, खातों और समस्याओं के आइडेंटिफ़ायर बदल गए हैं.

आइडेंटिफ़ायर की तुलना

आइडेंटिफ़ायर का ब्यौरा Content API for Shopping 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 में, खाते से जुड़ी समस्याएं वापस पाने के तरीकों को एक साथ जोड़ा गया है और आसान बनाया गया है.

तरीकों की तुलना

Content API for Shopping 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 को अलग-अलग कॉल करना होगा.

फ़ील्ड में किए गए बदलावों की ज़्यादा जानकारी

खाते से जुड़ी समस्या के संसाधन में मौजूद फ़ील्ड को अपडेट किया गया है, ताकि ज़्यादा स्ट्रक्चर्ड और साफ़ तौर पर जानकारी दी जा सके.

फ़ील्ड की तुलना

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