एपीआई अनुरोध पूरा होने पर, एपीआई जवाब के मुख्य हिस्से में अनुरोध किए गए डेटा के साथ 200 OK स्टेटस कोड दिखाता है. अगर कोई गड़बड़ी होती है, तो एपीआई, Google API से तय किए गए कैननिकल गड़बड़ी कोड में से एक कोड दिखाता है. यह कोड, एचटीटीपी स्टेटस कोड और गड़बड़ी की जानकारी वाले रिस्पॉन्स के मुख्य हिस्से से मैप किया जाता है. कोई गड़बड़ी होने पर, JSON रिस्पॉन्स बॉडी में मौजूद message और status फ़ील्ड की जांच करें. इससे आपको गड़बड़ी को ठीक करने में मदद मिलेगी.
गड़बड़ी का फ़ॉर्मैट
अगर किसी अनुरोध में गड़बड़ी होती है, तो एपीआई सही एचटीटीपी स्टेटस कोड और JSON रिस्पॉन्स बॉडी दिखाता है. गड़बड़ी के जवाब में, यहां दिए गए स्ट्रक्चर वाला error ऑब्जेक्ट शामिल होता है:
{
"error": {
"code": 403,
"message": "User does not have sufficient permissions for this property.",
"status": "PERMISSION_DENIED"
}
}
error ऑब्जेक्ट में ये फ़ील्ड शामिल होते हैं:
| फ़ील्ड | ब्यौरा |
|---|---|
| code | एचटीटीपी स्टेटस कोड, जैसे कि 400, 401, 403, 429 या 500. |
| मैसेज | गड़बड़ी के बारे में कम शब्दों में जानकारी. |
| स्टेटस | कैननिकल गड़बड़ी का कोड, जैसे कि INVALID_ARGUMENT, UNAUTHENTICATED, PERMISSION_DENIED, RESOURCE_EXHAUSTED या INTERNAL. |
आम तौर पर होने वाली गड़बड़ियां
यहां दी गई टेबल में, एपीआई से मिलने वाली सामान्य गड़बड़ियों की जानकारी दी गई है.
| एचटीटीपी स्टेटस कोड | कैननिकल कोड | कारण | ब्यौरा |
|---|---|---|---|
| 400 | INVALID_ARGUMENT |
गलत अनुरोध | अनुरोध गलत है. ऐसा छूटे हुए या अमान्य पैरामीटर की वजह से हो सकता है. जैसे, तारीख की गलत सीमा या गलत तरीके से बनाया गया फ़िल्टर. |
| 401 | UNAUTHENTICATED |
क्रेडेंशियल गलत हैं | अनुरोध में, टारगेट किए गए संसाधन के लिए पुष्टि करने वाले मान्य क्रेडेंशियल नहीं हैं. ऐसा तब हो सकता है, जब OAuth 2.0 ऐक्सेस टोकन मौजूद न हो, अमान्य हो या उसकी समयसीमा खत्म हो गई हो. मान्य टोकन पाने के लिए, OAuth 2.0 से पुष्टि करना लेख में दिए गए निर्देशों का पालन करें. |
| 403 | PERMISSION_DENIED |
ज़रूरी अनुमतियां नहीं हैं | पुष्टि पा चुके उपयोगकर्ता के पास, अनुरोध की गई Google Analytics प्रॉपर्टी का ऐक्सेस नहीं है. |
| 429 | RESOURCE_EXHAUSTED |
कोटा पार हो गया | एपीआई कोटा की सीमाएं पूरी होने की वजह से, अनुरोध अस्वीकार कर दिया गया. ज़्यादा जानकारी के लिए, Data API की सीमाएं और कोटा देखें. ऐसा हो सकता है कि आपने हर प्रोजेक्ट या हर प्रॉपर्टी के लिए तय सीमाएं पार कर ली हों. |
| 500 | INTERNAL |
आंतरिक सर्वर त्रुटि | सर्वर की कोई गड़बड़ी हुई. आम तौर पर, यह समस्या कुछ समय के लिए होती है. हमारा सुझाव है कि एक्स्पोनेंशियल बैकऑफ़ का इस्तेमाल करके, अनुरोध फिर से करें. सर्वर की गड़बड़ी के कोटा से बचने के लिए, फिर से कोशिश करने की सीमाओं के साथ एक्स्पोनेंशियल बैकऑफ़ लागू करना ज़रूरी है. |
| 503 | UNAVAILABLE |
सेवा उपलब्ध नहीं है | यह सेवा कुछ समय के लिए उपलब्ध नहीं है. आम तौर पर, यह समस्या कुछ समय के लिए होती है. हमारा सुझाव है कि एक्स्पोनेंशियल बैकऑफ़ के साथ अनुरोध फिर से करें. सर्वर की गड़बड़ी के कोटा से बचने के लिए, फिर से कोशिश करने की सीमाओं के साथ एक्स्पोनेंशियल बैकऑफ़ लागू करना ज़रूरी है. |