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

खाता-लेवल की उन समस्याओं को देखने का तरीका बदल गया है जिनका असर आपके प्रॉडक्ट और खाते की परफ़ॉर्मेंस पर पड़ सकता है. Merchant API में, Content API for Shopping के accountstatuses संसाधन की तुलना में, एक खास AccountIssue संसाधन उपलब्ध कराया गया है. इससे ज़्यादा स्ट्रक्चर्ड और ज़्यादा जानकारी मिलती है.

नई सुविधा का इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, खाते से जुड़ी समस्याओं की जानकारी देखने के लिए गाइड देखें.

मुख्य अंतर

Merchant API AccountIssue रिसॉर्स में हुए मुख्य सुधार और अंतर यहां दिए गए हैं:

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