ত্রুটি প্রতিক্রিয়া

যখন একটি এপিআই অনুরোধ সফল হয়, তখন এপিআইটি রেসপন্স বডিতে অনুরোধ করা ডেটার সাথে একটি 200 OK স্ট্যাটাস কোড ফেরত দেয়। যদি কোনো ত্রুটি ঘটে, তাহলে এপিআইটি গুগল এপিআই দ্বারা সংজ্ঞায়িত ক্যানোনিকাল এরর কোডগুলোর মধ্যে একটি ফেরত দেয়, যা একটি 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 ।

সাধারণ ভুল

নিম্নলিখিত সারণিতে এপিআই দ্বারা ফেরত আসা সাধারণ ত্রুটিগুলি তালিকাভুক্ত করা হয়েছে।

HTTP স্ট্যাটাস কোড	ক্যানোনিকাল কোড	কারণ	বর্ণনা
৪০০	INVALID_ARGUMENT	খারাপ অনুরোধ	অনুরোধটি ত্রুটিপূর্ণ। এর কারণ হতে পারে অনুপস্থিত বা অবৈধ প্যারামিটার, যেমন ভুল তারিখের পরিসর বা ত্রুটিপূর্ণ ফিল্টার।
৪০১	UNAUTHENTICATED	অবৈধ পরিচয়পত্র	অনুরোধটিতে নির্দিষ্ট রিসোর্সের জন্য বৈধ প্রমাণীকরণ তথ্য নেই। OAuth 2.0 অ্যাক্সেস টোকেনটি অনুপস্থিত, অবৈধ বা মেয়াদোত্তীর্ণ হলে এমনটা হতে পারে। একটি বৈধ টোকেন পেতে “OAuth 2.0 দিয়ে প্রমাণীকরণ” অংশে দেওয়া নির্দেশাবলী অনুসরণ করুন।
৪০৩	PERMISSION_DENIED	অপর্যাপ্ত অনুমতি	প্রমাণীকৃত ব্যবহারকারীর অনুরোধকৃত গুগল অ্যানালিটিক্স প্রপার্টিতে অ্যাক্সেস নেই।
৪২৯	RESOURCE_EXHAUSTED	কোটা অতিক্রম করা হয়েছে	এপিআই কোটার সীমা পূর্ণ হয়ে যাওয়ায় অনুরোধটি প্রত্যাখ্যান করা হয়েছে। আরও তথ্যের জন্য ডেটা এপিআই সীমা ও কোটা দেখুন। আপনি হয়তো প্রকল্প-ভিত্তিক বা সম্পত্তি-ভিত্তিক সীমা অতিক্রম করছেন।
৫০০	INTERNAL	অভ্যন্তরীণ সার্ভার ত্রুটি	একটি অপ্রত্যাশিত সার্ভার ত্রুটি ঘটেছে। এটি সাধারণত একটি অস্থায়ী সমস্যা। এক্সপোনেনশিয়াল ব্যাকঅফ সহ অনুরোধটি পুনরায় চেষ্টা করার পরামর্শ দেওয়া হচ্ছে। সার্ভার ত্রুটির কোটা অতিক্রম করা এড়াতে, রিট্রাই লিমিট সহ এক্সপোনেনশিয়াল ব্যাকঅফ প্রয়োগ করা গুরুত্বপূর্ণ।
৫০৩	UNAVAILABLE	পরিষেবা অনুপলব্ধ	পরিষেবাটি সাময়িকভাবে অনুপলব্ধ। এটি সাধারণত একটি সাময়িক সমস্যা। এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করে অনুরোধটি পুনরায় চেষ্টা করার পরামর্শ দেওয়া হচ্ছে। সার্ভার ত্রুটির কোটা অতিক্রম করা এড়ানোর জন্য, রিট্রাই লিমিট সহ এক্সপোনেনশিয়াল ব্যাকঅফ প্রয়োগ করা গুরুত্বপূর্ণ।