এই নথিতে ম্যানেজমেন্ট এপিআই এবং রিপোর্টিং এপিআই অনুরোধ করার সীমা এবং কোটা বর্ণনা করা হয়েছে।
Google Analytics লক্ষ লক্ষ সাইট ব্যবহার করে। আমরা API অনুরোধগুলিতে সীমা এবং কোটা রাখি যাতে সিস্টেমটি পরিচালনা করতে পারে তার চেয়ে বেশি ডেটা গ্রহণ থেকে রক্ষা করতে এবং সিস্টেম সংস্থানগুলির একটি ন্যায়সঙ্গত বন্টন নিশ্চিত করতে। সীমা এবং কোটা পরিবর্তন সাপেক্ষে.
এই ভিডিওটি Google Analytics API অনুরোধ কোটা পরিচালনার জন্য সর্বোত্তম অনুশীলন নিয়ে আলোচনা করে।
সাধারণ কোটার সীমা
নিম্নলিখিত কোটাগুলি ম্যানেজমেন্ট এপিআই , কোর রিপোর্টিং এপিআই v3 , MCF রিপোর্টিং এপিআই , মেটাডেটা এপিআই , ইউজার ডিলিট এপিআই এবং রিয়েল টাইম রিপোর্টিং এপিআই- এর ক্ষেত্রে প্রযোজ্য:
- প্রতিদিন প্রকল্প প্রতি ৫০,০০০ অনুরোধ, যা বাড়ানো যেতে পারে ।
- প্রতি সেকেন্ডে 10টি প্রশ্ন (QPS) প্রতি IP ঠিকানা ।
- এপিআই কনসোলে , ব্যবহারকারী প্রতি 100 সেকেন্ডে অনুরোধ হিসাবে উল্লেখ করা একটি অনুরূপ কোটা রয়েছে। ডিফল্টরূপে, এটি প্রতি ব্যবহারকারী প্রতি 100 সেকেন্ডে 100টি অনুরোধে সেট করা হয় এবং সর্বোচ্চ 1,000 মানের সাথে সামঞ্জস্য করা যায়। কিন্তু API-তে অনুরোধের সংখ্যা প্রতি সেকেন্ডে প্রতি ব্যবহারকারী সর্বোচ্চ 10টি অনুরোধের মধ্যে সীমাবদ্ধ।
- যদি আপনার অ্যাপ্লিকেশনটি একটি একক IP ঠিকানা থেকে সমস্ত API অনুরোধ করে (যেমন, আপনার ব্যবহারকারীদের পক্ষে), প্রতিটি ব্যবহারকারীর জন্য সম্পূর্ণ QPS কোটা পেতে প্রতিটি অনুরোধের সাথে
userIPবাquotaUserপ্যারামিটার ব্যবহার করুন। বিস্তারিত জানার জন্য স্ট্যান্ডার্ড ক্যোয়ারী প্যারামিটারের সারাংশ দেখুন।
রিপোর্টিং API
কোর রিপোর্টিং API v3 , Analytics রিপোর্টিং API v4 , রিয়েল টাইম API v3 , এবং মাল্টি-চ্যানেল ফানেল API v3 সহ সমস্ত রিপোর্টিং API-এর ক্ষেত্রে নিম্নলিখিত কোটাগুলি প্রযোজ্য:
- প্রতি ভিউ (প্রোফাইল) প্রতি দিনে 10,000 অনুরোধ (বাড়ানো যাবে না)
- প্রতি ভিউ (প্রোফাইল) 10টি সমবর্তী অনুরোধ (বাড়ানো যাবে না)
রিপোর্টিং এপিআই অনুরোধ ত্রুটি
রিপোর্টিং এপিআই-তে আপনার অনুরোধ সার্ভার ত্রুটির সাথে ব্যর্থ হলে, আপনি একটি প্রতিক্রিয়া কোড 500 বা 503 পাবেন। আপনি অনুরোধ পুনরায় জমা দিতে পারেন; যাইহোক, এই অনুরোধটি বারবার ব্যর্থ হলে একাধিকবার পুনরায় জমা দেবেন না। Google Analytics অনুমতি দেয়:
- প্রতি ঘন্টায় প্রতি ভিউ (প্রোফাইল) প্রতি প্রকল্প প্রতি 10টি সার্ভার ত্রুটি ব্যর্থ অনুরোধ
- প্রতি প্রকল্প প্রতি ভিউ (প্রোফাইল) প্রতি দিন 50 সার্ভার ত্রুটি ব্যর্থ অনুরোধ
যদি আপনার ব্যর্থ অনুরোধের সংখ্যা এই কোটা অতিক্রম করে, তাহলে আপনি নিম্নলিখিত ত্রুটিটি পাবেন:
Quota Error: The number of recent reporting API requests failing by server error is too high. You are temporarily blocked from the reporting API for at least an hour. Please send fewer server errors in the future to avoid being blocked.
অনুরোধ সার্ভারের ত্রুটির সম্ভাবনা কমাতে, অনুরোধটি সহজ করুন: তারিখের পরিসর হ্রাস করে, অনুরোধে মাত্রার সংখ্যা হ্রাস করে বা অনুরোধে মেট্রিকের সংখ্যা হ্রাস করে।
ক্রমাগত একটি ব্যর্থ অনুরোধ পুনরায় জমা দেবেন না. পরিবর্তে, এটি পুনরায় জমা দিতে সূচকীয় ব্যাকঅফ প্রয়োগ করুন ।
সার্ভারের ত্রুটি রেট কোটা প্রতি ঘণ্টায় এবং দৈনিক ত্রুটির হারের কোটার জন্য সময়ের রোলিং উইন্ডোতে প্রয়োগ করা হয়। একটি প্রজেক্ট এবং ভিউ পেয়ারের প্রথম সার্ভার ত্রুটির এক ঘন্টা পরে, কোটা রিসেট হয়৷ যদি একটি প্রজেক্ট এবং ভিউ পেয়ার এক ঘন্টার মধ্যে 10টি সার্ভার ত্রুটি পাঠায়, তাহলে প্রথম সার্ভারের ত্রুটি শেষ হওয়ার এক ঘন্টা পর্যন্ত প্রজেক্ট এবং ভিউ পেয়ারটি API থেকে ব্লক করা হয়।
উদাহরণস্বরূপ, যদি একটি প্রকল্প এবং ভিউ পেয়ার গত 24 ঘন্টার মধ্যে একটি সার্ভার ত্রুটি না পাঠায়, তাহলে এই প্রকল্প এবং ভিউ তার 50টি কোটার মধ্যে 0 ব্যবহার করবে৷ ধরা যাক এই প্রজেক্ট এবং ভিউ এখন 6:12 AM এ একটি সার্ভার এরর পাঠান। এই প্রজেক্ট এবং ভিউ যদি পরের দিনের 6:12 AM আগে 49টি অতিরিক্ত সার্ভারের ত্রুটি পাঠায়, তাহলে এই প্রোজেক্ট এবং ভিউ পরের দিন 6:12 AM পর্যন্ত ব্লক করা হবে। পরের দিনের সকাল 6:12-এ, সার্ভারের ত্রুটির হারের কোটা সম্পূর্ণরূপে এই প্রকল্পের জন্য পুনরায় সেট করা হবে এবং দেখার জন্য।
কোটার সীমা অতিক্রম করছে
যদি একটি Google Analytics API অনুরোধ করার কোটা অতিক্রম করা হয়, API একটি ত্রুটি কোড 403 বা 429 প্রদান করে এবং একটি বার্তা দেয় যে অ্যাকাউন্টটি কোটা অতিক্রম করেছে৷ আরও তথ্যের জন্য পরিষেবার শর্তাবলী দেখুন।
অতিরিক্ত কোটার জন্য অনুরোধ করা হচ্ছে
আপনি শুধুমাত্র বৃদ্ধি করার জন্য অনুরোধ করতে পারেন:
- প্রতি প্রকল্পের দৈনিক পড়ার অনুরোধের সংখ্যা (50,000 ডিফল্ট)
- প্রতি প্রকল্পের দৈনিক লেখার অনুরোধের সংখ্যা (50 ডিফল্ট)
আপনার প্রকল্পের ব্যবহারের সীমা দেখতে বা পরিবর্তন করতে, বা আপনার কোটা বৃদ্ধির অনুরোধ করতে, নিম্নলিখিতগুলি করুন:
- আপনার যদি আপনার প্রকল্পের জন্য ইতিমধ্যে একটি বিলিং অ্যাকাউন্ট না থাকে, তাহলে একটি তৈরি করুন৷
- API কনসোলে API লাইব্রেরির সক্ষম APIs পৃষ্ঠায় যান এবং তালিকা থেকে একটি API নির্বাচন করুন।
- কোটা-সম্পর্কিত সেটিংস দেখতে এবং পরিবর্তন করতে, কোটা নির্বাচন করুন। ব্যবহারের পরিসংখ্যান দেখতে, ব্যবহার নির্বাচন করুন।
সর্বাধিক কোটার পরিমাণ বৃদ্ধির অনুরোধ করতে, অনুগ্রহ করে Analytics API কোটা অনুরোধ ফর্মটি ব্যবহার করুন৷ অনুরোধ জমা দেওয়ার আগে তথ্য পর্যালোচনা এবং কোটা অনুরোধ ফর্মের নির্দেশাবলী অনুসরণ করা নিশ্চিত করুন। রিপোর্টিং API v4-এর জন্য, Google API কনসোলে API নাম হল Google Analytics রিপোর্টিং API । অন্য সব v3 API (যেমন, ম্যানেজমেন্ট API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) Google API কনসোলে Analytics API-এর অধীনে তালিকাভুক্ত।
কোটা ব্যবস্থাপনা সম্পর্কে আরও তথ্যের জন্য এবং কোটা ব্যবহারের জন্য আপনার আবেদন কীভাবে সূক্ষ্ম-টিউন করবেন, দেখুন APIs এবং ক্যাপিং ব্যবহার ।