সীমা এবং কোটা Google পরিকাঠামোকে একটি স্বয়ংক্রিয় প্রক্রিয়া থেকে রক্ষা করে যা একটি অনুপযুক্ত উপায়ে ডিরেক্টরি API ব্যবহার করে। একটি API থেকে অত্যধিক অনুরোধ একটি ক্ষতিকারক টাইপোর ফলে হতে পারে, অথবা একটি অদক্ষভাবে ডিজাইন করা সিস্টেমের ফলে হতে পারে যা অপ্রয়োজনীয় API কল করে। কারণ যাই হোক না কেন, Google Workspace সিস্টেমের সামগ্রিক স্বাস্থ্যের জন্য একটি নির্দিষ্ট উৎস থেকে ট্রাফিক একটি নির্দিষ্ট স্তরে পৌঁছালে তা ব্লক করা প্রয়োজন। এটি নিশ্চিত করে যে একজন বিকাশকারীর ক্রিয়াকলাপ বৃহত্তর সম্প্রদায়কে নেতিবাচকভাবে প্রভাবিত করতে পারে না।
আপনার API অনুরোধ ব্যর্থ হওয়ার সম্ভাবনা কম হলে, API একটি HTTP স্থিতি কোড এবং ত্রুটির কারণ প্রদান করে। উপরন্তু, প্রতিক্রিয়ার মূল অংশে ত্রুটির কারণের একটি বিশদ বিবরণ রয়েছে।
নিম্নলিখিত তালিকাটি সম্ভাব্য ত্রুটি কোড, কারণ, সংশ্লিষ্ট বিবরণ এবং কোটা সীমা আঘাত করার কারণে সৃষ্ট ত্রুটির জন্য সুপারিশকৃত পদক্ষেপ দেখায়।
কোড | কারণ | বর্ণনা | সুপারিশকৃত কাজ |
---|---|---|---|
403 | userRate LimitExeded | নির্দেশ করে যে ব্যবহারকারীর হারের সীমা অতিক্রম করা হয়েছে। Google ক্লাউড কনসোলে সেট করা ডিফল্ট মান হল Google ক্লাউড প্রকল্প প্রতি ব্যবহারকারী প্রতি মিনিটে 2,400টি প্রশ্ন। | আপনার Google ক্লাউড প্রজেক্টের অ্যাডমিন SDK API কোটা পৃষ্ঠা থেকে প্রতি ব্যবহারকারীর সীমা বাড়ান, অথবা সূচকীয় ব্যাকঅফ ব্যবহার করে আপনি যে হারে অনুরোধগুলি পাঠাচ্ছেন তা কমিয়ে দিন। |
403 | কোটা অতিক্রম করেছে | নির্দেশ করে যে একটি নির্দিষ্ট অপারেশনের জন্য সমসাময়িক অনুরোধের সীমা পৌঁছে গেছে। | সূচকীয় ব্যাক-অফ ব্যবহার করে পুনরায় চেষ্টা করুন। আপনি যে হারে অনুরোধ পাঠাচ্ছেন তার গতি কমাতে হবে। |
429 | হার সীমা অতিক্রম করেছে | নির্দেশ করে যে একটি নির্দিষ্ট অপারেশনের জন্য সমসাময়িক অনুরোধের সীমা পৌঁছে গেছে। | সূচকীয় ব্যাক-অফ ব্যবহার করে পুনরায় চেষ্টা করুন। আপনি যে হারে অনুরোধ পাঠাচ্ছেন তা আপনাকে অবশ্যই ধীর করতে হবে। এই সীমাটি Google Workspace অ্যাকাউন্টের জন্য, API ক্লায়েন্ট বা ব্যবহারকারী পিছু নয়। এই সীমা বাড়ানো যাবে না। |
সূচকীয় ব্যাকঅফ বাস্তবায়ন
সূচকীয় ব্যাকঅফ হল একটি ক্লায়েন্টের প্রক্রিয়া যা পর্যায়ক্রমে একটি ক্রমবর্ধমান পরিমাণে একটি ব্যর্থ অনুরোধ পুনরায় চেষ্টা করে। এটি নেটওয়ার্ক অ্যাপ্লিকেশনের জন্য একটি আদর্শ ত্রুটি পরিচালনার কৌশল। সূচকীয় ব্যাকঅফ ব্যবহার করা ব্যান্ডউইথ ব্যবহারের দক্ষতা বাড়ায়, একটি সফল প্রতিক্রিয়া পেতে প্রয়োজনীয় অনুরোধের সংখ্যা হ্রাস করে এবং সমসাময়িক পরিবেশে অনুরোধের থ্রুপুট সর্বাধিক করে।
সাধারণ সূচকীয় ব্যাকঅফ বাস্তবায়নের জন্য প্রবাহ নিম্নরূপ।
- API এ একটি অনুরোধ করুন
- একটি ত্রুটির প্রতিক্রিয়া পান যাতে একটি পুনরায় চেষ্টা-সক্ষম ত্রুটি কোড রয়েছে৷
- 1s +
random_number_milliseconds
সেকেন্ড অপেক্ষা করুন - অনুরোধ পুনরায় চেষ্টা করুন
- একটি ত্রুটির প্রতিক্রিয়া পান যাতে একটি পুনরায় চেষ্টা-সক্ষম ত্রুটি কোড রয়েছে৷
- 2s +
random_number_milliseconds
সেকেন্ড অপেক্ষা করুন - অনুরোধ পুনরায় চেষ্টা করুন
- একটি ত্রুটির প্রতিক্রিয়া পান যাতে একটি পুনরায় চেষ্টা-সক্ষম ত্রুটি কোড রয়েছে৷
- 4s +
random_number_milliseconds
সেকেন্ড অপেক্ষা করুন - অনুরোধ পুনরায় চেষ্টা করুন
- একটি ত্রুটির প্রতিক্রিয়া পান যাতে একটি পুনরায় চেষ্টা-সক্ষম ত্রুটি কোড রয়েছে৷
- 8s +
random_number_milliseconds
সেকেন্ড অপেক্ষা করুন - অনুরোধ পুনরায় চেষ্টা করুন
- একটি ত্রুটির প্রতিক্রিয়া পান যাতে একটি পুনরায় চেষ্টা-সক্ষম ত্রুটি কোড রয়েছে৷
- 16s +
random_number_milliseconds
সেকেন্ড অপেক্ষা করুন - অনুরোধ পুনরায় চেষ্টা করুন
- আপনি যদি এখনও একটি ত্রুটি পান, থামুন এবং ত্রুটি লগ.
উপরের প্রবাহে, random_number_milliseconds
হল 1000 এর থেকে কম বা সমান মিলিসেকেন্ডের একটি এলোমেলো সংখ্যা। কিছু সমবর্তী বাস্তবায়নে নির্দিষ্ট লক ত্রুটি এড়াতে এটি প্রয়োজনীয়। random_number_milliseconds
অবশ্যই প্রতিটি অপেক্ষার পরে পুনরায় সংজ্ঞায়িত করা উচিত।
দ্রষ্টব্য : অপেক্ষা সর্বদা হয় (2^n) + random_number_milliseconds
, যেখানে n হল একটি একঘেয়ে ক্রমবর্ধমান পূর্ণসংখ্যা যা প্রাথমিকভাবে 0 হিসাবে সংজ্ঞায়িত করা হয়। n প্রতিটি পুনরাবৃত্তির (প্রতিটি অনুরোধ) জন্য 1 দ্বারা বৃদ্ধি করা হয়।
n 5 হলে অ্যালগরিদমটি সমাপ্ত হতে সেট করা হয়। এই সিলিংটি কেবলমাত্র ক্লায়েন্টদের অসীমভাবে পুনরায় চেষ্টা করা থেকে বিরত রাখার জন্য এবং এর ফলে একটি অনুরোধ "একটি পুনরুদ্ধারযোগ্য ত্রুটি" হিসাবে বিবেচিত হওয়ার আগে প্রায় 32 সেকেন্ডের মোট বিলম্ব হয়। প্রয়োজনে আপনার API ক্লায়েন্ট অনেক বেশি সংখ্যক প্রচেষ্টা বাস্তবায়ন করতে পারে।
API সীমা এবং কোটা
API সীমা বিভাগ | সীমা |
---|---|
ব্যবহারকারী তৈরি করা | আপনি ডিরেক্টরি API ব্যবহার করে প্রতি সেকেন্ডে প্রতি ডোমেনে 10 জনের বেশি ব্যবহারকারী তৈরি করতে পারবেন না। |
গ্রুপ অন্য গ্রুপে সদস্য হিসাবে যোগ করা হয়েছে | চাইল্ড গ্রুপের সদস্যদের অভিভাবক গোষ্ঠীর সদস্য হিসাবে উপস্থিত হওয়ার আগে 10 মিনিট পর্যন্ত বিলম্ব হতে পারে। সিস্টেমের ক্ষমতার উপর নির্ভর করে এই সীমা পরিবর্তিত হতে পারে। |
মোবাইল ডিভাইস | ডিরেক্টরি API ব্যবহার করে, আপনি এটি করতে পারেন:
|
ব্যবহারকারীদের নাম পরিবর্তন করা হচ্ছে | সমস্ত পরিষেবা জুড়ে প্রচার করতে 10 মিনিট পর্যন্ত সময় নিতে পারে৷ ব্যবহারকারীর নাম পরিবর্তন করার আগে, সমস্ত ব্রাউজার সেশন এবং পরিষেবাগুলি থেকে ব্যবহারকারীকে লগ আউট করার পরামর্শ দেওয়া হয়৷ আরো বিস্তারিত জানার জন্য, ব্যবহারকারীদের আপডেট করুন দেখুন। |
সাংগঠনিক ইউনিট তৈরি/হালনাগাদ করা |
|
API কোটা বিভাগ | কোটা |
ক্রোম ডিভাইসগুলি annotatedLocation , সর্বাধিক অক্ষর৷ | একটি ডিভাইসের অবস্থানের তথ্যের জন্য সর্বাধিক 200টি অক্ষর। |
ক্রোম ডিভাইস notes , সর্বোচ্চ অক্ষর | একটি ডিভাইসের নোট তথ্যের জন্য সর্বাধিক অক্ষর সংখ্যা 500। |
Chrome ডিভাইস, user সর্বোচ্চ অক্ষর | একটি ডিভাইস ব্যবহারকারীর নামের জন্য সর্বোচ্চ 100টি অক্ষর। |
ডোমেন উপনাম, সর্বাধিক | ডোমেন উপনামের সর্বাধিক সংখ্যা 20টি। |
গ্রুপ, বর্ণনা | একটি বর্ণনায় অক্ষরের সর্বোচ্চ সংখ্যা 4,096। |
গ্রুপ, অ্যাকাউন্ট প্রতি | একটি G Suite লিগ্যাসি ফ্রি সংস্করণ অ্যাকাউন্টের সাথে, গোষ্ঠীর সংখ্যা 10-এর মধ্যে সীমাবদ্ধ। অন্যান্য সংস্করণগুলিতে গোষ্ঠীর সংখ্যার কোনও সীমা নেই। |
গ্রুপ, প্রতি গ্রুপে সদস্য | একটি G Suite লিগ্যাসি ফ্রি সংস্করণ অ্যাকাউন্টের সাথে, একটি গ্রুপে 100 জন সদস্য থাকতে পারে। অন্যান্য সংস্করণে একটি গ্রুপ থাকতে পারে এমন সদস্য সংখ্যার কোন সীমা নেই। ব্যবহারকারী প্রতি গ্রুপ সদস্যতা সীমার জন্য, গ্রুপ নীতি এবং সীমা বুঝতে দেখুন |
maxResults ক্যোয়ারী স্ট্রিং | API ফেরত দেয়:
|
একাধিক ডোমেন, একটি অ্যাকাউন্টে অনুমোদিত সর্বাধিক সংখ্যক ডোমেন | 600 (1 প্রাথমিক ডোমেন + 599 অতিরিক্ত ডোমেন) |
সাংগঠনিক ইউনিট, এক সময়ে সর্বাধিক সংখ্যক ব্যবহারকারী সরানো হয়েছে | এক সময়ে 20 জন ব্যবহারকারী সরানো যেতে পারে। এবং ব্যবহারকারীর প্রাথমিক ইমেল ঠিকানাগুলি অবশ্যই অ্যাকাউন্টে বিদ্যমান থাকতে হবে। |
ব্যবহারকারীর উপনাম | প্রতিটি ব্যবহারকারীর অ্যাকাউন্টের জন্য অনুমোদিত উপনামের মোট সংখ্যা 30। |
ব্যবহারকারীর উপনাম, একটি মুছে ফেলা উপনাম ব্যবহার করে | একটি মুছে ফেলা ব্যবহারকারী উপনাম অবিলম্বে আবার ব্যবহার করা যেতে পারে. |
সীমা অন্যান্য প্রকার | সীমাবদ্ধতা এবং নির্দেশিকা |
---|---|
বিলিং এবং ব্যবহারকারী তৈরি | Google Workspace-এর জন্য একটি নমনীয় প্ল্যান ব্যবহারকারীদের জন্য, এই API ব্যবহার করে ব্যবহারকারী তৈরি করা আর্থিক প্রভাব ফেলবে এবং এর ফলে আপনার গ্রাহকের বিলিং অ্যাকাউন্টে চার্জ করা হবে। উদাহরণস্বরূপ, আপনি যদি Google Workspace-এর জন্য একটি নমনীয় প্ল্যানে থাকেন, তাহলে 10 জন ব্যবহারকারী তৈরি করার ফলে আপনার অ্যাকাউন্টে 10টি Google Workspace লাইসেন্স পোস্ট করার জন্য চার্জ করা হবে, যা তৈরি করার সময় থেকে অনুপাতে। আপনি যদি একটি বার্ষিক পরিকল্পনায় থাকেন, তাহলে আপনি আগে থেকেই নির্দিষ্ট সংখ্যক লাইসেন্সের জন্য অর্থপ্রদান করতে প্রতিশ্রুতিবদ্ধ থাকবেন এবং আপনি আপনার প্রতিশ্রুতি অনুযায়ী শুধুমাত্র তত বেশি ব্যবহারকারী তৈরি করতে পারবেন। বিলিং পরিকল্পনা এবং আপনার বিলিং অ্যাকাউন্ট সম্পর্কে আরও তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। |
প্রথম এবং শেষ নাম | প্রথম এবং শেষ নামের সর্বোচ্চ 40টি অক্ষর আছে। তারা ইউনিকোড/UTF-8 অক্ষর সমর্থন করে এবং এতে স্পেস, অক্ষর (az), সংখ্যা (0-9), ড্যাশ (-), ফরোয়ার্ড স্ল্যাশ (/), এবং পিরিয়ড (.) থাকতে পারে। অক্ষর ব্যবহারের নিয়ম সম্পর্কে আরও তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। |
গ্রুপ, মুছে ফেলা | একটি গ্রুপ মুছে ফেলা গ্রুপ সদস্যের ব্যবহারকারী অ্যাকাউন্ট মুছে ফেলা হয় না. |
গ্রুপ এবং গ্রুপ সদস্য, ইমেল ঠিকানা পরিবর্তন | API-এর এই সংস্করণে, Google Workspace পরিষেবা চালু করার আগে একটি গ্রুপের ইমেল ঠিকানা পরিবর্তন করা যেতে পারে। গোষ্ঠীর সদস্যের ইমেল ঠিকানা পরিবর্তন করতে অ্যাডমিন কনসোল ব্যবহার করুন। একবার পরিবর্তিত হলে, API স্বয়ংক্রিয়ভাবে ইমেল ঠিকানা পরিবর্তনগুলি প্রতিফলিত করে। |
গ্রুপ, সেটিংস | গোষ্ঠী অ্যাক্সেস সেটিংস, ভাগ করার বিকল্প, পর্যবেক্ষণ, এবং আলোচনা সংরক্ষণাগার অ্যাডমিন কনসোল ব্যবহার করে পরিচালিত হয়৷ গ্রুপ সেটিংস সম্পর্কে আরও তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। |
গ্রুপ, বার্তা পাঠানো | স্প্যাম এবং ইমেলের অপব্যবহার রোধ করতে, Google বহিরাগত প্রাপকদের কাছে একবারে আপনি কত বার্তা পাঠাতে পারেন তা সীমিত করে। আপনি যদি একটি গ্রুপে একটি বার্তা পাঠান, প্রতিটি বহিরাগত সদস্যকে একজন প্রাপক হিসাবে গণনা করা হয়। আরও তথ্যের জন্য, ইমেল পাঠানোর সীমা দেখুন এবং Gmail ব্যবহারকারীদের ব্লক হওয়া বা স্প্যামে পাঠানো থেকে মেল প্রতিরোধ করুন । |
গ্রুপ, NDR বার্তা পাঠানো | আপনি একটি গ্রুপে নন-ডেলিভারি রসিদ (এনডিআর) পাঠাতে বা ফরওয়ার্ড করতে পারবেন না, যাকে "বাউন্স মেসেজ"ও বলা হয়। |
ব্যবহারকারীদের দ্বারা তৈরি গ্রুপ, সীমাবদ্ধতা | ব্যবহারকারীর তৈরি গ্রুপ সীমার জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন |
সাংগঠনিক ইউনিট, পরিষেবা চালু/বন্ধ করা | একটি সাংগঠনিক ইউনিটের জন্য পরিষেবা চালু এবং বন্ধ করার জন্য অ্যাডমিন কনসোল ব্যবহার করুন। |
পাসওয়ার্ড | অক্ষরের কোনো সমন্বয় থাকতে পারে। একটি সর্বনিম্ন 8 অক্ষর প্রয়োজন. সর্বাধিক দৈর্ঘ্য 100 অক্ষর। |
ফটো | API-এর এই সংস্করণে, একটি ফটো হল ব্যবহারকারীর সর্বশেষ Google প্রোফাইল ফটো৷ |
ব্যবহারকারীর নাম | ব্যবহারকারীর নামগুলিতে অক্ষর (az), সংখ্যা (0-9), ড্যাশ (-), আন্ডারস্কোর (_) থাকতে পারে এবং Google Workspace ডট বা পিরিয়ড (.) চিনতে পারে। এটি Gmail এর মতো নয়। একটি ব্যবহারকারীর নামে একটি সমান চিহ্ন (=), বন্ধনী (<,>), বা এক সারিতে একাধিক পিরিয়ড (.) থাকতে পারে না। আরও তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। |
ব্যবহারকারীর নাম, পুনঃনামকরণ | পুনঃনামকরণের পরে Google Hangouts সমস্ত মনে রাখা চ্যাট আমন্ত্রণ বাতিল করে। ব্যবহারকারীকে অবশ্যই বন্ধুদের সাথে আবার চ্যাট করার অনুমতির অনুরোধ করতে হবে। ইমেল ফরওয়ার্ডিং সেটিংসের ক্ষেত্রে ক্রমাগত মেল ডেলিভারি নিশ্চিত করার জন্য পুরানো ব্যবহারকারীর নামটি একটি ইমেল উপনাম হিসাবে রাখা হয় এবং একটি নতুন ব্যবহারকারীর নাম হিসাবে উপলব্ধ হবে না। ব্যবহারকারীদের নাম পরিবর্তনের প্রভাব সম্পর্কে গুরুত্বপূর্ণ বিশদ বিবরণের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। পুনঃনামকরণের পরে ইমেল উপনাম সরাতে ব্যবহারকারীর উপনাম মুছুন অপারেশনটি ব্যবহার করুন। |
একাধিক ডোমেনে ব্যবহারকারী | একটি Google Workspace অ্যাকাউন্ট আপনার যেকোনো ডোমেন অন্তর্ভুক্ত করতে পারে। একাধিক ডোমেন অ্যাকাউন্টে, একটি ডোমেনের ব্যবহারকারীরা অন্য অ্যাকাউন্ট ডোমেনের ব্যবহারকারীদের সাথে পরিষেবাগুলি ভাগ করতে পারে। একাধিক ডোমেইন উপাদান হল:
|
সতর্কবার্তা, গ্রুপের সদস্যরা | GROUP_CANNOT_CONTAIN_CYCLE – API গ্রুপ সদস্যপদে একটি চক্রের অনুমতি দেয় না। উদাহরণস্বরূপ, যদি গ্রুপ 1 গ্রুপ 2 এর সদস্য হয় তবে গ্রুপ 2 গ্রুপ 1 এর সদস্য হতে পারে না। |