সীমা এবং কোটা Google পরিকাঠামোকে এমন একটি স্বয়ংক্রিয় প্রক্রিয়া থেকে রক্ষা করে যা ডিরেক্টরি API কে অনুপযুক্ত উপায়ে ব্যবহার করে। API থেকে অতিরিক্ত অনুরোধের ফলে কোনও ক্ষতিকারক টাইপো হতে পারে, অথবা অদক্ষভাবে ডিজাইন করা সিস্টেমের ফলে অপ্রয়োজনীয় API কল করা হতে পারে। কারণ যাই হোক না কেন, Google Workspace সিস্টেমের সামগ্রিক স্বাস্থ্যের জন্য একটি নির্দিষ্ট উৎস থেকে ট্র্যাফিক একটি নির্দিষ্ট স্তরে পৌঁছানোর পরে তা ব্লক করা প্রয়োজন। এটি নিশ্চিত করে যে একজন ডেভেলপারের পদক্ষেপ বৃহত্তর সম্প্রদায়ের উপর নেতিবাচক প্রভাব ফেলতে না পারে।
আপনার API অনুরোধ ব্যর্থ হওয়ার সম্ভাবনা কম থাকলে, API একটি HTTP স্ট্যাটাস কোড এবং ত্রুটির কারণ ফেরত পাঠায়। এছাড়াও, প্রতিক্রিয়ার মূল অংশে ত্রুটির কারণের একটি বিশদ বিবরণ থাকে।
নিম্নলিখিত তালিকাটি সম্ভাব্য ত্রুটি কোড, কারণ, সংশ্লিষ্ট বিবরণ এবং কোটা সীমা অতিক্রম করার ফলে সৃষ্ট ত্রুটির জন্য প্রস্তাবিত পদক্ষেপ দেখায়।
| কোড | কারণ | বিবরণ | প্রস্তাবিত পদক্ষেপ |
|---|---|---|---|
| ৪০৩ | ব্যবহারকারীর হারের সীমা অতিক্রম করেছে | ব্যবহারকারীর হারের সীমা অতিক্রম করেছে তা নির্দেশ করে। Google Cloud কনসোলে সেট করা ডিফল্ট মান হল প্রতি ব্যবহারকারীর জন্য প্রতি মিনিটে 2,400টি কোয়েরি, প্রতি Google Cloud প্রকল্পে। | আপনার Google ক্লাউড প্রোজেক্টের অ্যাডমিন SDK API কোটা পৃষ্ঠা থেকে প্রতি ব্যবহারকারীর সীমা বাড়ান, অথবা এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করে অনুরোধ পাঠানোর হার কমিয়ে দিন। |
| ৪০৩ | কোটা অতিক্রম করেছে | নির্দেশ করে যে একটি নির্দিষ্ট ক্রিয়াকলাপের জন্য সমসাময়িক অনুরোধের সীমা পৌঁছে গেছে। | এক্সপোনেনশিয়াল ব্যাক-অফ ব্যবহার করে আবার চেষ্টা করুন। আপনি যে হারে অনুরোধগুলি পাঠাচ্ছেন তা ধীর করতে হবে। |
| ৪২৯ | হারসীমা অতিক্রম করেছে | নির্দেশ করে যে একটি নির্দিষ্ট ক্রিয়াকলাপের জন্য সমসাময়িক অনুরোধের সীমা পৌঁছে গেছে। | এক্সপোনেনশিয়াল ব্যাক-অফ ব্যবহার করে আবার চেষ্টা করুন। আপনাকে অনুরোধ পাঠানোর হার কমাতে হবে। এই সীমা প্রতি 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 পুনরায় সংজ্ঞায়িত করতে হবে।
দ্রষ্টব্য : অপেক্ষা সর্বদা (2 ^ n) + random_number_milliseconds হয়, যেখানে n হল একটি একঘেয়ে ক্রমবর্ধমান পূর্ণসংখ্যা যা প্রাথমিকভাবে 0 হিসাবে সংজ্ঞায়িত করা হয়। প্রতিটি পুনরাবৃত্তির জন্য (প্রতিটি অনুরোধ) n 1 দ্বারা বৃদ্ধি করা হয়।
n ৫ হলে অ্যালগরিদমটি সমাপ্তির জন্য সেট করা হয়। এই সিলিংটি কেবলমাত্র ক্লায়েন্টদের অসীমভাবে পুনরায় চেষ্টা করা থেকে বিরত রাখার জন্য, এবং এর ফলে একটি অনুরোধকে "অপুনরুদ্ধারযোগ্য ত্রুটি" হিসাবে বিবেচনা করার আগে প্রায় 32 সেকেন্ড বিলম্ব হয়। প্রয়োজনে আপনার API ক্লায়েন্ট আরও বেশি সংখ্যক প্রচেষ্টা বাস্তবায়ন করতে পারে।
API সীমা এবং কোটা
| API সীমা বিভাগ | সীমা |
|---|---|
| ব্যবহারকারী তৈরি করা হচ্ছে | ডিরেক্টরি API ব্যবহার করে আপনি প্রতি সেকেন্ডে প্রতি ডোমেনে ১০ জনের বেশি ব্যবহারকারী তৈরি করতে পারবেন না। |
| গ্রুপটিকে অন্য গ্রুপে সদস্য হিসেবে যোগ করা হয়েছে | শিশু গোষ্ঠীর সদস্যরা অভিভাবক গোষ্ঠীর সদস্য হিসেবে উপস্থিত হওয়ার আগে ১০ মিনিট পর্যন্ত বিলম্ব হতে পারে। সিস্টেমের ক্ষমতার উপর নির্ভর করে এই সীমা পরিবর্তিত হতে পারে। |
| মোবাইল ডিভাইস | ডিরেক্টরি API ব্যবহার করে, আপনি সর্বাধিক সম্পাদন করতে পারেন:
|
| ব্যবহারকারীদের নাম পরিবর্তন করা হচ্ছে | সমস্ত পরিষেবা জুড়ে প্রচারিত হতে ১০ মিনিট পর্যন্ত সময় লাগতে পারে। ব্যবহারকারীর নাম পরিবর্তন করার আগে, সমস্ত ব্রাউজার সেশন এবং পরিষেবা থেকে ব্যবহারকারীকে লগ আউট করার পরামর্শ দেওয়া হয়। আরও বিস্তারিত জানার জন্য, ব্যবহারকারীদের আপডেট করুন দেখুন। |
| সাংগঠনিক ইউনিট তৈরি/হালনাগাদ করা |
|
| API কোটা বিভাগ | কোটা |
Chrome ডিভাইসগুলি annotatedLocation , সর্বাধিক অক্ষর | একটি ডিভাইসের অবস্থান তথ্যের জন্য সর্বাধিক ২০০টি অক্ষর থাকতে পারে। |
Chrome ডিভাইসের notes , সর্বাধিক অক্ষর | একটি ডিভাইসের নোট তথ্যের জন্য সর্বাধিক ৫০০টি অক্ষর থাকতে পারে। |
Chrome ডিভাইস, user সর্বাধিক অক্ষর | একটি ডিভাইস ব্যবহারকারীর নামের জন্য সর্বাধিক ১০০টি অক্ষর থাকতে পারে। |
| ডোমেন উপনাম, সর্বাধিক | ডোমেইন উপনামের সর্বোচ্চ সংখ্যা ২০টি। |
| গোষ্ঠী, বর্ণনা | একটি বর্ণনায় সর্বাধিক 4,096টি অক্ষর থাকতে পারে। |
| অ্যাকাউন্ট প্রতি গ্রুপ | জি স্যুট লিগ্যাসি ফ্রি এডিশন অ্যাকাউন্টের সাথে, গ্রুপের সংখ্যা ১০ টির মধ্যে সীমাবদ্ধ। অন্যান্য সংস্করণগুলিতে গ্রুপের সংখ্যার কোনও সীমা নেই। |
| গ্রুপ, প্রতি গ্রুপে সদস্য | একটি G Suite Legacy Free Edition অ্যাকাউন্টের মাধ্যমে, একটি গ্রুপে সর্বাধিক ১০০ জন সদস্য থাকতে পারে। অন্যান্য সংস্করণে একটি গ্রুপের সদস্য সংখ্যার কোনও সীমা নেই। প্রতি ব্যবহারকারীর জন্য গ্রুপ সদস্যতার সীমার জন্য, "Groups নীতি এবং সীমা বুঝুন" দেখুন। |
| maxResults কোয়েরি স্ট্রিং | API ফেরত দেয়:
|
| একাধিক ডোমেন, একটি অ্যাকাউন্টে অনুমোদিত সর্বোচ্চ সংখ্যক ডোমেন | ৬০০ (১টি প্রাথমিক ডোমেইন + ৫৯৯টি অতিরিক্ত ডোমেইন) |
| সাংগঠনিক ইউনিট, এক সময়ে সর্বাধিক সংখ্যক ব্যবহারকারী স্থানান্তরিত হয়েছে | একসাথে ২০ জন ব্যবহারকারীকে স্থানান্তর করা যেতে পারে। এবং ব্যবহারকারীর প্রাথমিক ইমেল ঠিকানাগুলি ইতিমধ্যেই অ্যাকাউন্টে বিদ্যমান থাকতে হবে। |
| ব্যবহারকারীর উপনাম | প্রতিটি ব্যবহারকারীর অ্যাকাউন্টের জন্য অনুমোদিত উপনামের সংখ্যা 30টি। |
| মুছে ফেলা উপনাম ব্যবহার করে ব্যবহারকারীর উপনাম | মুছে ফেলা ব্যবহারকারীর উপনামটি তাৎক্ষণিকভাবে আবার ব্যবহার করা যেতে পারে। |
| অন্যান্য ধরণের সীমা | সীমাবদ্ধতা এবং নির্দেশিকা |
|---|---|
| বিলিং এবং ব্যবহারকারী তৈরি করা | Google Workspace-এর জন্য নমনীয় পরিকল্পনা ব্যবহারকারীদের জন্য, এই API ব্যবহার করে ব্যবহারকারী তৈরি করলে আর্থিক প্রভাব পড়বে এবং এর ফলে আপনার গ্রাহকের বিলিং অ্যাকাউন্টে চার্জ লাগবে। উদাহরণস্বরূপ, যদি আপনি Google Workspace-এর জন্য একটি নমনীয় পরিকল্পনা ব্যবহার করেন, তাহলে ১০ জন ব্যবহারকারী তৈরি করলে আপনার অ্যাকাউন্টে ১০টি Google Workspace লাইসেন্স পোস্ট করার জন্য চার্জ লাগবে, যা তৈরির সময় থেকে আনুপাতিক হারে হবে। যদি আপনি একটি বার্ষিক পরিকল্পনা ব্যবহার করেন, তাহলে আপনি ইতিমধ্যেই নির্দিষ্ট সংখ্যক লাইসেন্সের জন্য অর্থ প্রদানের প্রতিশ্রুতি দিয়েছিলেন এবং আপনি আপনার প্রতিশ্রুতি অনুসারে কেবলমাত্র তত সংখ্যক ব্যবহারকারী তৈরি করতে পারবেন। বিলিং পরিকল্পনা এবং আপনার বিলিং অ্যাকাউন্ট সম্পর্কে আরও তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। |
| প্রথম এবং শেষ নাম | নামের প্রথম এবং শেষ অংশে সর্বাধিক ৪০টি অক্ষর থাকতে পারে। এগুলি Unicode/UTF-8 অক্ষর সমর্থন করে এবং এতে স্পেস, অক্ষর (az), সংখ্যা (0-9), ড্যাশ (-), ফরোয়ার্ড স্ল্যাশ (/), এবং পিরিয়ড (.) থাকতে পারে। অক্ষর ব্যবহারের নিয়ম সম্পর্কে আরও তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। |
| গ্রুপ, মুছে ফেলা হচ্ছে | একটি গ্রুপ মুছে ফেললে গ্রুপ সদস্যের ব্যবহারকারীর অ্যাকাউন্ট মুছে যায় না। |
| গ্রুপ এবং গ্রুপ সদস্যদের, ইমেল ঠিকানা পরিবর্তন | API-এর এই সংস্করণে, Google Workspace পরিষেবা চালু করার আগে একটি গ্রুপের ইমেল ঠিকানা পরিবর্তন করা যেতে পারে। গ্রুপ সদস্যের ইমেল ঠিকানা পরিবর্তন করতে Google অ্যাডমিন কনসোল ব্যবহার করুন। একবার পরিবর্তন করা হলে, API স্বয়ংক্রিয়ভাবে ইমেল ঠিকানার পরিবর্তনগুলি প্রতিফলিত করে। |
| গ্রুপ, সেটিংস | গ্রুপ অ্যাক্সেস সেটিংস, শেয়ারিং অপশন, মনিটরিং এবং আলোচনা সংরক্ষণাগার গুগল অ্যাডমিন কনসোল ব্যবহার করে পরিচালিত হয়। গ্রুপ সেটিংস সম্পর্কে আরও তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। |
| গ্রুপ, বার্তা পাঠানো | স্প্যাম এবং ইমেলের অপব্যবহার রোধ করতে, Google বহিরাগত প্রাপকদের কাছে একবারে পাঠানো বার্তার সংখ্যা সীমিত করে। আপনি যদি একটি গ্রুপে একটি বার্তা পাঠান, তাহলে প্রতিটি বহিরাগত সদস্যকে একজন প্রাপক হিসেবে গণনা করা হবে। আরও তথ্যের জন্য, ইমেল পাঠানোর সীমা এবং Gmail ব্যবহারকারীদের কাছে মেল ব্লক করা বা স্প্যামে পাঠানো থেকে বিরত রাখুন দেখুন। |
| গ্রুপ, NDR বার্তা পাঠানো | আপনি কোনও গ্রুপে নন-ডেলিভারি রসিদ (NDRs), যাকে "বাউন্স মেসেজ"ও বলা হয়, পাঠাতে বা ফরোয়ার্ড করতে পারবেন না। |
| ব্যবহারকারীদের দ্বারা তৈরি গ্রুপ, সীমাবদ্ধতা | ব্যবহারকারী-নির্মিত গ্রুপ সীমার জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। |
| সাংগঠনিক ইউনিট, পরিষেবা চালু/বন্ধ করা | কোনও সাংগঠনিক ইউনিটের জন্য পরিষেবা চালু এবং বন্ধ করার ব্যবস্থা পরিচালনা করতে Google অ্যাডমিন কনসোল ব্যবহার করুন। |
| পাসওয়ার্ড | যেকোনো অক্ষরের সমন্বয় থাকতে পারে। সর্বনিম্ন ৮টি অক্ষর প্রয়োজন। সর্বোচ্চ দৈর্ঘ্য ১০০টি অক্ষর। |
| ছবি | API-এর এই সংস্করণে, একটি ছবি হল ব্যবহারকারীর সর্বশেষ Google প্রোফাইল ছবি। |
| ব্যবহারকারীর নাম | ব্যবহারকারীর নামে অক্ষর (az), সংখ্যা (0-9), ড্যাশ (-), আন্ডারস্কোর (_) থাকতে পারে এবং Google Workspace বিন্দু বা বিরামচিহ্ন (.) চিনতে পারে। এটি Gmail এর মতো নয়। একটি ব্যবহারকারীর নামে সমান চিহ্ন (=), বন্ধনী (<,>), অথবা পরপর একাধিক বিরামচিহ্ন (.) নাও থাকতে পারে। আরও তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। |
| ব্যবহারকারীর নাম, পুনঃনামকরণ | নাম পরিবর্তনের পর Google Hangouts সমস্ত মনে রাখা চ্যাট আমন্ত্রণ বাতিল করে দেয়। ব্যবহারকারীকে আবার বন্ধুদের সাথে চ্যাট করার জন্য অনুমতি চাইতে হবে। ইমেল ফরোয়ার্ডিং সেটিংসের ক্ষেত্রে ক্রমাগত মেল ডেলিভারি নিশ্চিত করার জন্য পুরানো ব্যবহারকারীর নামটি একটি ইমেল উপনাম হিসাবে রাখা হয় এবং নতুন ব্যবহারকারীর নাম হিসাবে উপলব্ধ হবে না। ব্যবহারকারীদের নাম পরিবর্তনের প্রভাব সম্পর্কে গুরুত্বপূর্ণ তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। নাম পরিবর্তনের পর ইমেল উপনামটি সরাতে ব্যবহারকারীর উপনাম মুছে ফেলুন অপারেশনটি ব্যবহার করুন। |
| একাধিক ডোমেনের ব্যবহারকারীরা | একটি Google Workspace অ্যাকাউন্টে আপনার যেকোনো ডোমেন অন্তর্ভুক্ত থাকতে পারে। একাধিক ডোমেন অ্যাকাউন্টে, একটি ডোমেনের ব্যবহারকারীরা অন্য অ্যাকাউন্ট ডোমেনের ব্যবহারকারীদের সাথে পরিষেবা শেয়ার করতে পারেন। একাধিক ডোমেন উপাদান হল:
|
| সতর্কীকরণ, গ্রুপ সদস্যরা | GROUP_CANNOT_CONTAIN_CYCLE – API গ্রুপ সদস্যপদে একটি চক্র অনুমোদন করে না। উদাহরণস্বরূপ, যদি গ্রুপ1 গ্রুপ2 এর সদস্য হয়, তাহলে গ্রুপ2 গ্রুপ1 এর সদস্য হতে পারবে না। |