API অনুরোধ সফল হলে, API রেসপন্স বডিতে অনুরোধ করা ডেটার সাথে একটি 200 OK স্ট্যাটাস কোড
রিটার্ন করে। কোনও সমস্যা হলে, API
Google API-এর দ্বারা সংজ্ঞায়িত ক্যাননিক্যাল সমস্যা কোডগুলির মধ্যে একটি রিটার্ন করে, যা
HTTP স্ট্যাটাস কোডের সাথে ম্যাপ করা হয় এবং এতে সমস্যা সংক্রান্ত তথ্য সহ একটি রেসপন্স বডি থাকে। কোনও সমস্যা হলে, ডিবাগিংয়ের জন্য JSON
রেসপন্স বডির মধ্যে message এবং status ফিল্ড
ভালো করে দেখুন।
সমস্যার ফর্ম্যাট
অনুরোধের ফলে কোনও সমস্যা হলে, API উপযুক্ত HTTP স্ট্যাটাস
কোড ও JSON রেসপন্স বডি রিটার্ন করে। সমস্যার উত্তরে নিম্নলিখিত গঠন সহ একটি error অবজেক্ট
থাকে:
{
"error": {
"code": 403,
"message": "User does not have sufficient permissions for this property.",
"status": "PERMISSION_DENIED"
}
}
error অবজেক্টে এইসব ফিল্ড থাকে:
| ফিল্ড | বিবরণ |
|---|---|
| কোড | HTTP স্ট্যাটাস কোড, যেমন 400, 401, 403, 429 বা 500. |
| মেসেজ | সমস্যার সংক্ষিপ্ত বিবরণ। |
| স্ট্যাটাস | ক্যাননিকাল সমস্যার কোড, যেমন INVALID_ARGUMENT, UNAUTHENTICATED, PERMISSION_DENIED, RESOURCE_EXHAUSTED বা INTERNAL. |
যে ভুলগুলি প্রায়ই হয়ে থাকে
নিচের টেবিলে API-এর মাধ্যমে ফেরত পাঠানো সাধারণ সমস্যার তালিকা দেওয়া হল।
| HTTP স্ট্যাটাস কোড | ক্যানোনিকাল কোড | কারণ | বিবরণ |
|---|---|---|---|
| 400 | INVALID_ARGUMENT |
ত্রুটিযুক্ত অনুরোধ | অনুরোধটি ভুল ফর্ম্যাটে আছে। ভুল তারিখের রেঞ্জ বা ভুল ফিল্টারের মতো অনুপস্থিত বা ভুল প্যারামিটারের কারণে এটি হতে পারে। |
| 401 | UNAUTHENTICATED |
ভুল ক্রেডেনশিয়াল | অনুরোধে টার্গেট রিসোর্সের জন্য সঠিক যাচাইকরণ ক্রেডেনশিয়াল নেই। OAuth 2.0 অ্যাক্সেস টোকেন না থাকলে, ভুল হলে বা মেয়াদ শেষ হয়ে গেলে এটি হতে পারে। সঠিক টোকেন পেতে OAuth 2.0-এর মাধ্যমে যাচাইকরণ লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করুন। |
| 403 | PERMISSION_DENIED |
যথেষ্ট অনুমতি নেই | অনুরোধ করা Google Analytics প্রপার্টিতে যাচাই করা ব্যবহারকারীর অ্যাক্সেস নেই। |
| 429 | RESOURCE_EXHAUSTED |
কোটা অতিক্রান্ত হয়েছে | API কোটার সীমা পৌঁছে যাওয়ার কারণে অনুরোধটি প্রত্যাখ্যান করা হয়েছে। আরও তথ্যের জন্য ডেটা API সংক্রান্ত সীমা ও কোটা দেখুন। আপনি হয়ত প্রোজেক্ট বা প্রপার্টি পিছু সীমা অতিক্রম করছেন। |
| 500 | INTERNAL |
ইন্টার্নাল সার্ভারে সমস্যা | সার্ভারে কোনও অপ্রত্যাশিত সমস্যা হয়েছে। এটি সাধারণত সাময়িক সমস্যা। এক্সপোনেনশিয়াল ব্যাকঅফ সহ অনুরোধটি আবার চেষ্টা করার জন্য সাজেস্ট করা হয়। সার্ভার সংক্রান্ত সমস্যার কোটা যাতে অতিক্রম না করে যায়, তার জন্য আবার চেষ্টা করার সীমা সহ এক্সপোনেনশিয়াল ব্যাকঅফ প্রয়োগ করা গুরুত্বপূর্ণ। |
| 503 | UNAVAILABLE |
পরিষেবা উপলভ্য নেই | পরিষেবা সাময়িকভাবে উপলভ্য নেই। এটি সাধারণত সাময়িক সমস্যা। এক্সপোনেনশিয়াল ব্যাকঅফ সহ অনুরোধটি আবার চেষ্টা করার জন্য সাজেস্ট করা হয়। সার্ভার সংক্রান্ত সমস্যার কোটা যাতে অতিক্রম না করে যায়, তার জন্য আবার চেষ্টা করার সীমা সহ এক্সপোনেনশিয়াল ব্যাকঅফ প্রয়োগ করা গুরুত্বপূর্ণ। |