Google ক্যালেন্ডার API-এর কোটা আছে তা নিশ্চিত করার জন্য যে এটি সমস্ত ব্যবহারকারীর দ্বারা ন্যায্যভাবে ব্যবহার করা হয়েছে৷ ক্যালেন্ডার API ব্যবহার করার সময় বিবেচনা করার জন্য তিনটি গুরুত্বপূর্ণ সীমাবদ্ধতা রয়েছে:
- এপিআই ব্যবহার কোটা প্রতি প্রকল্প এবং ব্যবহারকারী প্রতি প্রয়োগ করা হয়। আরও তথ্যের জন্য পরবর্তী বিভাগে দেখুন.
- সাধারণ ক্যালেন্ডার ব্যবহারের সীমা : ক্যালেন্ডার ব্যবহারের সীমা এড়িয়ে চলুন।
- কর্মক্ষম সীমা: আপনি যে কোনো সময় সীমিত হার হতে পারে. উদাহরণস্বরূপ যদি আপনি একটি একক ক্যালেন্ডারে দ্রুত ধারাবাহিকভাবে লেখার চেষ্টা করেন।
ক্যালেন্ডার API ব্যবহার কোটার প্রকার
দুই ধরনের কোটা প্রয়োগ করা হয়:
- প্রতি মিনিট প্রতি প্রকল্প: এটি আপনার Google ক্লাউড প্রকল্প দ্বারা করা অনুরোধের সংখ্যা।
- প্রতি মিনিটে প্রতি প্রকল্প প্রতি ব্যবহারকারী: এটি আপনার ক্লাউড প্রকল্পে কোনো একটি নির্দিষ্ট ব্যবহারকারীর দ্বারা করা অনুরোধের সংখ্যা। এই সীমার লক্ষ্য আপনাকে আপনার ব্যবহারকারীদের মধ্যে ব্যবহারের একটি ন্যায্য বন্টন নিশ্চিত করতে সহায়তা করা।
একটি স্লাইডিং উইন্ডো ব্যবহার করে প্রতি মিনিটে কোটা গণনা করা হয়, তাই ট্র্যাফিকের একটি দ্রুত বিস্ফোরণ যা এক মিনিটের মধ্যে আপনার প্রতি-মিনিটের কোটা অতিক্রম করে তার ফলে পরবর্তী উইন্ডোতে হার সীমিত হবে যাতে নিশ্চিত করা যায় যে, গড় আপনার ব্যবহার কোটার মধ্যেই থাকে।
যদি কোন একটি কোটা অতিক্রম করে, তাহলে আপনি সীমিত হার এবং আপনার প্রশ্নের জন্য একটি 403 usageLimits স্থিতি কোড বা একটি 429 usageLimits স্থিতি কোড পাবেন৷ যদি এটি ঘটে তবে আপনি যা করতে পারেন তা এখানে:
- নিশ্চিত করুন যে আপনি সমস্ত সেরা অনুশীলনগুলি অনুসরণ করছেন: সূচকীয় ব্যাকঅফ ব্যবহার করুন , ট্রাফিক প্যাটার্নগুলি এলোমেলো করুন , পুশ বিজ্ঞপ্তিগুলি ব্যবহার করুন ৷
- যদি আপনার প্রজেক্ট ক্রমবর্ধমান হয় এবং আপনার বেশি ব্যবহারকারী থাকে, আপনি প্রতি-প্রকল্প কোটা বৃদ্ধির অনুরোধ করতে পারেন।
- যদি প্রতি-ব্যবহারকারী কোটার সীমা আঘাতপ্রাপ্ত হয়, আপনি নিম্নলিখিতগুলি করতে পারেন:
- আপনি যদি একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করেন, ব্যবহারকারীদের জন্য লোড বরাদ্দ করুন বা একাধিক পরিষেবা অ্যাকাউন্টের মধ্যে বিভক্ত করুন৷
- যদিও আপনি প্রতি-ব্যবহারকারীর কোটা বৃদ্ধির অনুরোধ করতে পারেন, সাধারণভাবে এটিকে ডিফল্ট মানের উপরে বাড়ানোর সুপারিশ করা হয় না কারণ আপনার অ্যাপ্লিকেশন অন্যান্য ধরনের সীমাগুলিকে আঘাত করতে শুরু করতে পারে, উদাহরণস্বরূপ সাধারণ ক্যালেন্ডার ব্যবহারের সীমা বা অপারেশনাল সীমা।
কোটা বাড়ানোর আবেদন
আপনার প্রকল্পের ব্যবহারের সীমা দেখতে বা পরিবর্তন করতে, বা আপনার কোটা বৃদ্ধির অনুরোধ করতে, নিম্নলিখিতগুলি করুন:
- আপনার যদি আপনার প্রকল্পের জন্য ইতিমধ্যে একটি বিলিং অ্যাকাউন্ট না থাকে, তাহলে একটি তৈরি করুন৷
- API কনসোলে API লাইব্রেরির সক্ষম APIs পৃষ্ঠায় যান এবং তালিকা থেকে একটি API নির্বাচন করুন।
- কোটা-সম্পর্কিত সেটিংস দেখতে এবং পরিবর্তন করতে, কোটা নির্বাচন করুন। ব্যবহারের পরিসংখ্যান দেখতে, ব্যবহার নির্বাচন করুন।
সূচকীয় ব্যাকঅফ ব্যবহার করুন
যখন আমরা চাই যে আপনি আপনার অনুরোধের হার কমিয়ে দিন, আমরা একটি 403 "ব্যবহারের সীমা" প্রতিক্রিয়া বা একটি 429 প্রতিক্রিয়া ফেরত দেব ( সম্পূর্ণ ত্রুটি ডকুমেন্টেশন দেখুন)। এটি একটি মারাত্মক ত্রুটি নয় এবং আমরা আশা করি আপনি একটি সংক্ষিপ্ত বিরতির পরে অনুরোধটি পুনরায় চেষ্টা করবেন৷ যদি অনুরোধগুলি এখনও খুব দ্রুত আসে, আমরা আবার জিজ্ঞাসা করব, এবং তাই। এটি সঠিকভাবে কাজ করার জন্য, এটি গুরুত্বপূর্ণ যে অনুরোধগুলির মধ্যে বিলম্ব সময়ের সাথে বৃদ্ধি পায়৷
সাধারণত, আপনার ছেঁটে যাওয়া সূচকীয় ব্যাকঅফ ব্যবহার করা উচিত; ক্লাউড স্টোরেজ ডকুমেন্টেশনে এটি কীভাবে কাজ করে এবং পছন্দের অ্যালগরিদমের একটি ভাল ব্যাখ্যা রয়েছে। আপনি যদি একটি Google ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন তবে এটি সাধারণত আপনার জন্য পরিচালনা করা হবে; আপনার লাইব্রেরি ডকুমেন্টেশন পরামর্শ. সাধারণত, আপনার নিজের লেখার পরিবর্তে লাইব্রেরি বাস্তবায়ন ব্যবহার করা উচিত।
ট্রাফিক প্যাটার্ন এলোমেলো করুন
ক্যালেন্ডার ক্লায়েন্টরা একই সময়ে একাধিক ক্লায়েন্ট অপারেশন সম্পাদন করার কারণে সৃষ্ট স্পাইকি ট্রাফিক প্যাটার্নের প্রবণ। উদাহরণস্বরূপ, একটি ক্যালেন্ডার ক্লায়েন্টের জন্য একটি সাধারণ খারাপ অভ্যাস হল মধ্যরাতে সম্পূর্ণ সিঙ্ক করা। এটি প্রায় নিশ্চিতভাবেই আপনার প্রতি মিনিটের কোটা অতিক্রম করবে এবং এর ফলে হার সীমিত হবে এবং ব্যাকঅফ হবে।
এটি এড়ানোর জন্য, নিশ্চিত করুন যে আপনার ট্র্যাফিক যেখানেই সম্ভব সারা দিন জুড়ে ছড়িয়ে আছে। যদি আপনার ক্লায়েন্টকে দৈনিক সিঙ্ক করতে হয়, তাহলে ক্লায়েন্টকে একটি এলোমেলো সময় নির্ধারণ করতে দিন (প্রতিটি ক্লায়েন্টের জন্য আলাদা)। আপনার যদি নিয়মিত অপারেশন করতে হয়, তাহলে ব্যবধান +/- 25% পরিবর্তন করুন। এটি ট্র্যাফিককে আরও সমানভাবে বিতরণ করবে এবং আরও ভাল ব্যবহারকারীর অভিজ্ঞতা প্রদান করবে।
পুশ বিজ্ঞপ্তি ব্যবহার করুন
একটি সাধারণ ব্যবহারের ক্ষেত্রে যখনই ব্যবহারকারীর ক্যালেন্ডারে কিছু পরিবর্তন হয় তখন একটি ক্রিয়া সম্পাদন করতে চান৷ এখানে একটি বিরোধী প্যাটার্ন হল আগ্রহের প্রতিটি ক্যালেন্ডারে বারবার পোল করা। এটি খুব দ্রুত আপনার সমস্ত কোটা ব্যবহার করবে-উদাহরণস্বরূপ, যদি আপনার অ্যাপ্লিকেশনের 5,000 ব্যবহারকারী থাকে এবং প্রতিটি ব্যবহারকারীর ক্যালেন্ডারে একবার প্রতি মিনিটে পোল করে, তাহলে কোনও কাজ করার আগেও এটির জন্য প্রতি মিনিটের 5,000 কোটা প্রয়োজন।
সার্ভার-সাইড অ্যাপ্লিকেশনগুলি পুশ বিজ্ঞপ্তিগুলির জন্য নিবন্ধন করতে পারে, যা আমাদের আগ্রহের কিছু ঘটলে আপনাকে জানানোর অনুমতি দেয়। এইগুলি সেট আপ করার জন্য আরও পরিশ্রমের প্রয়োজন, তবে আপনার কোটার নাটকীয়ভাবে আরও দক্ষ ব্যবহারের অনুমতি দেয় এবং আরও ভাল ব্যবহারকারীর অভিজ্ঞতা প্রদান করে৷ নিশ্চিত করুন যে আপনি eventType নির্দিষ্ট করেছেন যার জন্য আপনি বিজ্ঞপ্তি পেতে চান৷ আরও তথ্যের জন্য, পুশ বিজ্ঞপ্তি দেখুন।
পরিষেবা অ্যাকাউন্টের সাথে সঠিক হিসাব
যদি আপনার অ্যাপ্লিকেশনটি ডোমেন-ওয়াইড ডেলিগেশন ব্যবহার করে অনুরোধগুলি সম্পাদন করে, ডিফল্টরূপে পরিষেবা অ্যাকাউন্টটি "ব্যবহারকারী প্রতি প্রকল্প প্রতি মিনিট" কোটার ক্ষেত্রে চার্জ করা হয়, এবং আপনি যে ব্যবহারকারীর ছদ্মবেশ ধারণ করছেন তার নয়৷ এর মানে হল যে পরিষেবা অ্যাকাউন্টটি সম্ভবত কোটা শেষ হয়ে যাবে এবং রেট-সীমিত হবে, যদিও এটি একাধিক ব্যবহারকারীর ক্যালেন্ডারে কাজ করছে। কোন ব্যবহারকারীকে চার্জ করা হবে তা নির্দেশ করার জন্য আপনি quotaUser URL প্যারামিটার (বা x-goog-quota-user HTTP হেডার) ব্যবহার করে এটি এড়াতে পারেন। এটি শুধুমাত্র কোটা গণনার জন্য ব্যবহৃত হয়। আরও তথ্যের জন্য ক্লাউড ডকুমেন্টেশনে ব্যবহারকারী প্রতি অনুরোধ সীমিত করা দেখুন।
পরীক্ষা কোটা সীমা হ্যান্ডলিং
আপনার অ্যাপ্লিকেশনটি অনুশীলনে কোটা সীমাতে পৌঁছানোর সুদৃঢ়ভাবে পরিচালনা করতে পারে তা নিশ্চিত করার জন্য (যেমন সূচকীয় ব্যাকঅফের সাথে পুনরায় চেষ্টা করে ) এবং আপনার ব্যবহারকারীদের যেকোন সম্ভাব্য ব্যাঘাত কমাতে আমরা দৃঢ়ভাবে এই দৃশ্যটি একটি বাস্তব পরিবেশে পরীক্ষা করার পরামর্শ দিই।
এই ধরনের পরীক্ষার জন্য যাতে আপনার প্রকৃত অ্যাপ্লিকেশন ব্যবহারে হস্তক্ষেপ না হয়, আমরা Google API কনসোলে একটি পৃথক পরীক্ষা-শুধু প্রকল্প নিবন্ধন করার এবং এটিকে আপনার উত্পাদন প্রকল্পের অনুরূপভাবে কনফিগার করার পরামর্শ দিই। তারপর আপনি এই প্রকল্পের জন্য কৃত্রিমভাবে কম কোটা সেট করতে পারেন এবং আপনার আবেদনের আচরণ পর্যবেক্ষণ করতে পারেন।
মূল্য নির্ধারণ
Google ক্যালেন্ডার API-এর সমস্ত ব্যবহার কোনো অতিরিক্ত খরচ ছাড়াই উপলব্ধ। কোটা অনুরোধের সীমা অতিক্রম করলে অতিরিক্ত চার্জ লাগে না এবং আপনার অ্যাকাউন্টে বিল করা হয় না।