खाता-लेवल की उन समस्याओं को देखने का तरीका बदल गया है जिनका असर आपके प्रॉडक्ट और खाते की परफ़ॉर्मेंस पर पड़ सकता है. 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 जैसे फ़ील्ड को स्थानीय भाषा में दिखाया जा सकता है. |