সীমা ও কোটা Google-এর পরিকাঠামোকে এমন অটোমেটিক প্রসেস থেকে রক্ষা করে যা Directory API-কে অনুপযুক্ত উপায়ে ব্যবহার করে। কোনও API থেকে অত্যধিক অনুরোধের কারণ হতে পারে কোনও নিরীহ টাইপো বা অদক্ষভাবে ডিজাইন করা সিস্টেম যা অপ্রয়োজনীয় API কল করে। কারণ যাই হোক না কেন, Google Workspace সিস্টেমের সামগ্রিক স্বাস্থ্য বজায় রাখার জন্য নির্দিষ্ট সোর্স থেকে আসা ট্রাফিক একটি নির্দিষ্ট লেভেলে পৌঁছালে তা ব্লক করা প্রয়োজন। এটি নিশ্চিত করে যে একজন ডেভেলপারের অ্যাকশন বৃহত্তর কমিউনিটির উপর নেতিবাচক প্রভাব ফেলতে পারবে না।
আপনার API অনুরোধ ব্যর্থ হলে, API একটি HTTP স্ট্যাটাস কোড এবং সমস্যার কারণ দেখায়। এছাড়াও, উত্তরের মূল অংশে কী কারণে সমস্যা হয়েছে তার বিস্তারিত বিবরণ থাকে।
কোটার সীমা অতিক্রম করার কারণে হওয়া সমস্যার জন্য সম্ভাব্য সমস্যার কোড, কারণ, সংশ্লিষ্ট বিবরণ এবং সাজেস্ট করা অ্যাকশন নিম্নলিখিত তালিকায় দেখানো হয়েছে।
| কোড | কারণ | বিবরণ | প্রস্তাবিত পদক্ষেপ |
|---|---|---|---|
| 403 | userRateLimitExceeded | ব্যবহারকারীর রেট লিমিট পেরিয়ে গেছে বলে দেখায়। Google Cloud কনসোলে সেট করা ডিফল্ট ভ্যালু হল প্রতি Google Cloud প্রোজেক্টে প্রতি ব্যবহারকারী প্রতি মিনিটে ২,৪০০টি কোয়েরি। | আপনার Google Cloud প্রোজেক্টের Admin SDK API কোটা পৃষ্ঠা থেকে ব্যবহারকারী প্রতি সীমা বাড়ান, অথবা এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করে অনুরোধ পাঠানোর হার কমান। |
| 403 | quotaExceeded | নির্দিষ্ট অপারেশনের জন্য একসাথে করা অনুরোধের সীমায় পৌঁছে গেছেন বলে ইঙ্গিত করে। | এক্সপোনেনশিয়াল ব্যাক-অফ ব্যবহার করে আবার চেষ্টা করুন। আপনি যে হারে অনুরোধ পাঠাচ্ছেন তা কমাতে হবে। |
| 429 | rateLimitExceeded | নির্দিষ্ট অপারেশনের জন্য একসাথে করা অনুরোধের সীমায় পৌঁছে গেছেন বলে ইঙ্গিত করে। | এক্সপোনেনশিয়াল ব্যাক-অফ ব্যবহার করে আবার চেষ্টা করুন। আপনাকে অনুরোধ পাঠানোর হার কমাতে হবে। এই সীমা প্রতিটি Google Workspace অ্যাকাউন্টের জন্য প্রযোজ্য, প্রতিটি API ক্লায়েন্ট বা ব্যবহারকারীর জন্য নয়। এই সীমা বাড়ানো যাবে না। |
এক্সপোনেনশিয়াল ব্যাকঅফ প্রয়োগ করা
এক্সপোনেনশিয়াল ব্যাকঅফ হল এমন একটি প্রসেস যেখানে ক্লায়েন্ট নির্দিষ্ট সময় অন্তর ব্যর্থ অনুরোধের জন্য ক্রমবর্ধমান সময় ধরে আবার চেষ্টা করে। এটি নেটওয়ার্ক অ্যাপ্লিকেশনের জন্য স্ট্যান্ডার্ড এরর ম্যানেজমেন্ট স্ট্র্যাটেজি। এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করলে ব্যান্ডউইথের ব্যবহার আরও দক্ষ হয়, সফল উত্তর পাওয়ার জন্য প্রয়োজনীয় অনুরোধের সংখ্যা কমে যায় এবং একই সময়ে একাধিক অনুরোধের ক্ষেত্রে থ্রুপুট সর্বাধিক হয়।
সহজ এক্সপোনেনশিয়াল ব্যাকঅফ প্রয়োগ করার ফ্লো নিচে দেওয়া হল।
- API-তে অনুরোধ করুন
- এমন একটি সমস্যার রেসপন্স পান যাতে আবার চেষ্টা করার মতো সমস্যার কোড আছে
- ১ সেকেন্ড +
random_number_millisecondsসেকেন্ড অপেক্ষা করুন - আবার অনুরোধ করুন
- এমন একটি সমস্যার রেসপন্স পান যাতে আবার চেষ্টা করার মতো সমস্যার কোড আছে
- ২ সেকেন্ড +
random_number_millisecondsসেকেন্ড অপেক্ষা করুন - আবার অনুরোধ করুন
- এমন একটি সমস্যার রেসপন্স পান যাতে আবার চেষ্টা করার মতো সমস্যার কোড আছে
- ৪ সেকেন্ড +
random_number_millisecondsসেকেন্ড অপেক্ষা করুন - আবার অনুরোধ করুন
- এমন একটি সমস্যার রেসপন্স পান যাতে আবার চেষ্টা করার মতো সমস্যার কোড আছে
- ৮ সেকেন্ড +
random_number_millisecondsসেকেন্ড অপেক্ষা করুন - আবার অনুরোধ করুন
- এমন একটি সমস্যার রেসপন্স পান যাতে আবার চেষ্টা করার মতো সমস্যার কোড আছে
- ১৬ সেকেন্ড +
random_number_millisecondsসেকেন্ড অপেক্ষা করুন - আবার অনুরোধ করুন
- আপনি এখনও সমস্যার মেসেজ পেলে, থামুন এবং সমস্যাটি লগ করুন।
উপরের ফ্লোতে, random_number_milliseconds হল ১০০০-এর সমান বা তার চেয়ে কম
মিলিসেকেন্ডের একটি র্যান্ডম সংখ্যা। কিছু সমবর্তী ইমপ্লিমেন্টেশনে
নির্দিষ্ট লক সংক্রান্ত সমস্যা এড়াতে এটি প্রয়োজন।
প্রতিটি অপেক্ষার পরে random_number_milliseconds আবার সংজ্ঞায়িত করতে হবে।
মনে রাখবেন: অপেক্ষা করার সময় সবসময়
(২ ^ n) + random_number_milliseconds, যেখানে
n হল একটি একঘেয়ে ক্রমবর্ধমান পূর্ণসংখ্যা যা প্রাথমিকভাবে ০ হিসেবে
সংজ্ঞায়িত করা হয়। প্রতিটি পুনরাবৃত্তির (প্রতিটি অনুরোধ) জন্য n-এর মান ১ করে বৃদ্ধি পায়।
n-এর মান ৫ হলে অ্যালগরিদম বন্ধ হয়ে যাবে। এই সীমা শুধুমাত্র ক্লায়েন্টদের অসীম সংখ্যক বার চেষ্টা করা থেকে বিরত রাখার জন্য নির্ধারিত করা হয়েছে এবং এর ফলে কোনও অনুরোধকে "ডেটা ফিরিয়ে আনা যাবে না এমন সমস্যা" হিসেবে গণ্য করার আগে মোট প্রায় ৩২ সেকেন্ডের বিলম্ব হয়। প্রয়োজন হলে, আপনার API ক্লায়েন্ট আরও বেশি সংখ্যক বার চেষ্টা করতে পারে।
API-এর সীমা ও কোটা
| API সীমা বিভাগ | সীমা |
|---|---|
| ব্যবহারকারীর প্রোফাইল তৈরি করা হচ্ছে | Directory API ব্যবহার করে আপনি প্রতি সেকেন্ডে ডোমেন পিছু ১০ জনের বেশি ব্যবহারকারী তৈরি করতে পারবেন না। |
| ব্যবহারকারীদের মুছে ফেলা হচ্ছে | আপনি Directory API ব্যবহার করে প্রতি সেকেন্ডে ডোমেন প্রতি সর্বাধিক ৫ জন ব্যবহারকারীকে মুছে ফেলতে পারবেন। এটি হল ডোমেন প্রতি ব্যাকএন্ড পরিষেবার সীমা যা Google Cloud কনসোল প্রোজেক্ট কোটায় অ্যাডজাস্ট করা যায় না। ব্যাচ অনুরোধ পাঠানোর সময়, নিশ্চিত করুন যে ব্যাচ জুড়ে মোট অপারেশন প্রতি সেকেন্ডে ৫টি কোয়েরির (QPS) কম থাকে। |
| গ্রুপ মেম্বারদের সরানো হচ্ছে | আপনি Directory API ব্যবহার করে প্রতি সেকেন্ডে ডোমেন প্রতি সর্বাধিক ৩০ জন গ্রুপ মেম্বারকে মুছে ফেলতে পারবেন। এটি হল ডোমেন প্রতি ব্যাকএন্ড পরিষেবার সীমা যা Google Cloud কনসোল প্রোজেক্ট কোটায় অ্যাডজাস্ট করা যায় না। ব্যাচ অনুরোধ পাঠানোর সময়, নিশ্চিত করুন যে ব্যাচ জুড়ে মোট অপারেশন প্রতি সেকেন্ডে ৩০টি কোয়েরির (QPS) নিচে থাকে। |
| অন্য গ্রুপে মেম্বার হিসেবে গ্রুপ যোগ করা হয়েছে | চাইল্ড গ্রুপের মেম্বারদের পেরেন্ট গ্রুপের মেম্বার হিসেবে দেখাতে ১০ মিনিট পর্যন্ত দেরি হতে পারে। সিস্টেমের ক্ষমতার উপর নির্ভর করে এই সীমা পরিবর্তন হতে পারে। |
| মোবাইল ডিভাইস |
Directory API ব্যবহার করে, আপনি সর্বাধিক এইগুলি করতে পারবেন:
|
| ব্যবহারকারীদের নাম পরিবর্তন করা | সব পরিষেবা জুড়ে প্রচার করতে ১০ মিনিট পর্যন্ত সময় লাগতে পারে। ব্যবহারকারীর নাম পরিবর্তন করার আগে, সব ব্রাউজার সেশন ও পরিষেবা থেকে ব্যবহারকারীকে লগ-আউট করে দেওয়া ভাল। আরও তথ্যের জন্য, ব্যবহারকারী আপডেট করুন দেখুন। |
| প্রাতিষ্ঠানিক ইউনিট তৈরি/আপডেট করা হচ্ছে |
|
| API কোটার বিভাগ | কোটা |
Chrome ডিভাইস annotatedLocation, সর্বাধিক অক্ষর
|
ডিভাইসের লোকেশন সংক্রান্ত তথ্যের জন্য সর্বাধিক ২০০টি অক্ষর ব্যবহার করা যাবে। |
Chrome ডিভাইস notes, সর্বাধিক অক্ষর
|
ডিভাইসের নোটের তথ্যের জন্য সর্বাধিক ৫০০টি অক্ষর ব্যবহার করা যাবে। |
Chrome ডিভাইস, সর্বাধিক userটি অক্ষর
|
ডিভাইস ব্যবহারকারীর নামের ক্ষেত্রে অক্ষর সীমা হল ১০০টি। |
| ডোমেন উপনাম, সর্বাধিক | ডোমেন উপনামের সর্বাধিক সংখ্যা হল ২০। |
| গ্রুপ, বিবরণ | বিবরণে সর্বাধিক ৪,০৯৬টি অক্ষর থাকতে পারে। |
| গ্রুপ, অ্যাকাউন্ট প্রতি | G Suite লিগ্যাসি ফ্রি এডিশন অ্যাকাউন্টের মাধ্যমে, গ্রুপের সংখ্যা ১০-এ সীমিত করা হয়েছে। অন্যান্য সংস্করণে গ্রুপের সংখ্যার কোনও সীমা নেই। |
| গ্রুপ, প্রতিটি গ্রুপে মেম্বার সংখ্যা | G Suite-এর পুরনো ফ্রি ভার্সন অ্যাকাউন্টের মাধ্যমে, কোনও গ্রুপে সর্বাধিক ১০০ জন মেম্বার থাকতে পারেন। অন্যান্য সংস্করণে, কোনও গ্রুপে কতজন মেম্বার থাকতে পারবেন তার কোনও সীমা নেই। প্রতি ব্যবহারকারীর জন্য গ্রুপ মেম্বারশিপের সীমা সম্পর্কে জানতে, Groups-এর নীতি ও সীমা সম্পর্কে জানুন |
| maxResults কোয়েরি স্ট্রিং | API এটি রিটার্ন করে:
|
| একাধিক ডোমেন, একটি অ্যাকাউন্টে অনুমোদিত ডোমেনের সর্বাধিক সংখ্যা | ৬০০ (১টি প্রাথমিক ডোমেন + ৫৯৯টি অতিরিক্ত ডোমেন) |
| সাংগঠনিক ইউনিট, একবারে সরানো ব্যবহারকারীর সর্বাধিক সংখ্যা | একবারে ২০ জন ব্যবহারকারীকে সরানো যাবে। এবং ব্যবহারকারীর প্রাথমিক ইমেল আইডি অবশ্যই অ্যাকাউন্টে আগে থেকেই থাকতে হবে। |
| ব্যবহারকারীর অ্যালিয়াস | প্রতিটি ব্যবহারকারীর অ্যাকাউন্টের জন্য অনুমোদিত উপনামের মোট সংখ্যা হল ৩০। |
| ব্যবহারকারীর উপনাম, মুছে ফেলা উপনাম ব্যবহার করা হচ্ছে | মুছে দেওয়া ব্যবহারকারীর উপনাম অবিলম্বে আবার ব্যবহার করা যেতে পারে। |
| অন্যান্য ধরনের সীমা | সীমাবদ্ধতা ও নির্দেশিকা |
|---|---|
| বিলিং এবং ব্যবহারকারী তৈরি করা | Google Workspace-এর জন্য ফ্লেক্সিবল প্ল্যানে থাকা ব্যবহারকারীদের জন্য, এই API ব্যবহার করে ব্যবহারকারী তৈরি করলে আর্থিক প্রভাব পড়বে এবং এর ফলে আপনার গ্রাহক বিলিং অ্যাকাউন্টে চার্জ করা হবে। যেমন, আপনি Google Workspace-এর জন্য কোনও ফ্লেক্সিবল প্ল্যান ব্যবহার করলে, ১০ জন ব্যবহারকারী তৈরি করার ফলে আপনার অ্যাকাউন্টে ১০টি Google Workspace লাইসেন্সের জন্য চার্জ পোস্ট করা হবে, যা তৈরি করার সময় থেকে আনুপাতিক হারে গণনা করা হবে। আপনি বার্ষিক প্ল্যান ব্যবহার করলে, নির্দিষ্ট সংখ্যক লাইসেন্সের জন্য আপনাকে আগেই পেমেন্ট করতে হবে এবং আপনি যতগুলি লাইসেন্সের জন্য পেমেন্ট করেছেন, ততগুলিই ব্যবহারকারী তৈরি করতে পারবেন। বিলিং প্ল্যান ও আপনার বিলিং অ্যাকাউন্ট সম্পর্কে আরও তথ্যের জন্য, অ্যাডমিনিস্ট্রেশন সহায়তা কেন্দ্র দেখুন। |
| নাম ও পদবি | নাম ও পদবিতে সর্বাধিক ৪০টি অক্ষর থাকতে পারে। এগুলি ইউনিকোড/UTF-8 অক্ষর সমর্থন করে এবং এতে স্পেস, অক্ষর (a-z), সংখ্যা (0-9), ড্যাশ (-), ফরওয়ার্ড স্ল্যাশ (/) এবং ফুলস্টপ (.) থাকতে পারে। অক্ষর ব্যবহারের নিয়ম সম্পর্কে আরও তথ্যের জন্য, অ্যাডমিনিস্ট্রেশন সহায়তা কেন্দ্র দেখুন। |
| গ্রুপ, মুছে ফেলা হচ্ছে | গ্রুপ মুছে দিলে গ্রুপ মেম্বারের ব্যবহারকারী অ্যাকাউন্ট মুছে যায় না। |
| গ্রুপ ও গ্রুপ মেম্বার, ইমেল আইডি পরিবর্তন | API-এর এই ভার্সনে, Google Workspace পরিষেবা চালু করার আগে গ্রুপের ইমেল আইডি পরিবর্তন করা যেতে পারে। গ্রুপ মেম্বারের ইমেল আইডি পরিবর্তন করতে Google Admin কনসোল ব্যবহার করুন। পরিবর্তন করা হয়ে গেলে, API অটোমেটিক ইমেল আইডিতে হওয়া পরিবর্তন দেখায়। |
| গ্রুপ, সেটিংস | Google অ্যাডমিন কনসোল ব্যবহার করে গ্রুপের অ্যাক্সেস সেটিংস, শেয়ার করার বিকল্প, মনিটর করা এবং আলোচনার আর্কাইভ ম্যানেজ করা হয়। গ্রুপ সেটিংস সম্পর্কে আরও জানতে, অ্যাডমিনিস্ট্রেশন সহায়তা কেন্দ্র দেখুন। |
| গ্রুপ, মেসেজ পাঠানো | স্প্যাম ও ইমেলের অপব্যবহার প্রতিরোধ করতে, Google এক্সটার্নাল প্রাপকদের একবারে আপনি কতগুলি মেসেজ পাঠাতে পারবেন তার সংখ্যা সীমিত করে। আপনি কোনও গ্রুপে মেসেজ পাঠালে, প্রতিটি এক্সটার্নাল মেম্বারকে একজন প্রাপক হিসেবে গণনা করা হয়। আরও তথ্যের জন্য, ইমেল পাঠানোর সীমা এবং Gmail ব্যবহারকারীদের পাঠানো মেল ব্লক করা বা স্প্যামে পাঠানো আটকানো দেখুন। |
| গ্রুপ, NDR মেসেজ পাঠানো | আপনি কোনও গ্রুপে নন-ডেলিভারি রসিদ (NDR) পাঠাতে বা ফরওয়ার্ড করতে পারবেন না, এটিকে "বাউন্স মেসেজ"ও বলা হয়। |
| ব্যবহারকারীর তৈরি করা গ্রুপ, সীমাবদ্ধতা | ব্যবহারকারীর তৈরি করা গ্রুপের সীমা সম্পর্কে জানতে, অ্যাডমিনিস্ট্রেশন সহায়তা কেন্দ্র দেখুন |
| প্রতিষ্ঠানের ইউনিট, পরিষেবা চালু/বন্ধ করা | কোনও সাংগঠনিক ইউনিটের জন্য পরিষেবা চালু ও বন্ধ করা ম্যানেজ করতে Google Admin কনসোল ব্যবহার করুন। |
| পাসওয়ার্ড | যেকোনও অক্ষর, সংখ্যা ও চিহ্ন মিলিয়ে-মিশিয়ে রাখা যেতে পারে। কমপক্ষে ৮টি অক্ষর থাকতে হবে। এটি ১০০টি অক্ষরের মধ্যে লিখতে হবে। |
| ফটো | API-এর এই ভার্সনে, ব্যবহারকারীর লেটেস্ট Google প্রোফাইল ফটোই হল ফটো। |
| ব্যবহারকারীর নাম | ইউজার নেমে অক্ষর (a-z), সংখ্যা (0-9), ড্যাশ (-), আন্ডারস্কোর (_) থাকতে পারে এবং Google Workspace ডট বা পিরিয়ড (.) শনাক্ত করে। এটি Gmail-এর মতো নয়। ইউজার নেমে সমান চিহ্ন (=), ব্র্যাকেট (<,>) বা পরপর একাধিক ফুল স্টপ (.) থাকলে চলবে না। আরও তথ্যের জন্য, অ্যাডমিনিস্ট্রেশন সহায়তা কেন্দ্র দেখুন। |
| ইউজার নেম, নাম পরিবর্তন করা | নাম পরিবর্তন করার পরে Google Hangouts মনে রাখা সব চ্যাট আমন্ত্রণ বাতিল করে দেয়। বন্ধুদের সাথে আবার চ্যাট করার জন্য ব্যবহারকারীকে অবশ্যই অনুমতি চাইতে হবে। ইমেল ফরওয়ার্ডিং সেটিংসের ক্ষেত্রে নিরবচ্ছিন্ন মেল ডেলিভারি নিশ্চিত করতে পুরনো ইউজার নেমটি ইমেল অ্যালিয়াস হিসেবে রেখে দেওয়া হয় এবং নতুন ইউজার নেম হিসেবে উপলভ্য হবে না। ব্যবহারকারীর নাম পরিবর্তন করার প্রভাব সম্পর্কে গুরুত্বপূর্ণ বিবরণ জানতে, অ্যাডমিনিস্ট্রেশন সহায়তা কেন্দ্র দেখুন। নাম পরিবর্তন করার পরে ইমেল অ্যালিয়াস সরাতে ব্যবহারকারীর অ্যালিয়াস মুছুন অপারেশন ব্যবহার করুন। |
| একাধিক ডোমেনে থাকা ব্যবহারকারী | Google Workspace অ্যাকাউন্টে আপনার যেকোনও ডোমেন অন্তর্ভুক্ত থাকতে পারে। একাধিক ডোমেন অ্যাকাউন্টে, একটি ডোমেনের ব্যবহারকারীরা অন্য অ্যাকাউন্ট ডোমেনের ব্যবহারকারীদের সাথে পরিষেবা শেয়ার করতে পারেন। একাধিক ডোমেন কম্পোনেন্ট হল:
|
| সতর্কতা, গ্রুপের মেম্বার | GROUP_CANNOT_CONTAIN_CYCLE – API গ্রুপ মেম্বারশিপে সাইকেলের অনুমতি দেয় না। যেমন, গ্রুপ১ যদি গ্রুপ২-এর মেম্বার হয়, তাহলে গ্রুপ২, গ্রুপ১-এর মেম্বার হতে পারবে না। |