যেহেতু Google Vault API একটি শেয়ার করা পরিষেবা, তাই আমরা কোটা এবং সীমাবদ্ধতাগুলি প্রয়োগ করি যাতে এটি সমস্ত ব্যবহারকারীর দ্বারা ন্যায্যভাবে ব্যবহার করা হয় এবং Google Workspace সিস্টেমের সামগ্রিক স্বাস্থ্য রক্ষা করে।
পণ্যের সীমা
আপনি আপনার প্রতিষ্ঠান জুড়ে 20টির বেশি রপ্তানি করতে পারবেন না।
API অনুরোধ কোটা
Vault API এবং vault.google.com-এর মাধ্যমে অনুরোধ সহ সমস্ত প্রকল্প এবং ব্যবহারকারী জুড়ে প্রতিটি সংস্থাকে প্রতি মিনিটে 600টি বিষয় পড়ার অনুমতি দেওয়া হয়৷
নিম্নলিখিত সারণীগুলি প্রতি-মিনিট প্রতি-প্রকল্প অনুরোধের সীমা তালিকাভুক্ত করে:
| প্রতি মিনিটে প্রতি প্রকল্পের অনুরোধ পড়ুন | |
|---|---|
| রপ্তানি, ব্যাপার, এবং ক্যোয়ারী সংরক্ষিত | 120 |
| ধরে রাখুন | 228 |
| দীর্ঘমেয়াদী অপারেশন | 300 |
| প্রতি মিনিটে প্রতি প্রকল্পে অনুরোধ লিখুন | |
|---|---|
| রপ্তানি | 20 |
| ধরে রাখুন | 60 |
| বিষয় অনুমতি | 30 |
| ব্যাপার | 60 |
| সেভ করা প্রশ্ন | 45 |
| অনুসন্ধান (গণনা) প্রতি মিনিট প্রতি প্রকল্প প্রতি অনুরোধ | |
|---|---|
| অনুসন্ধান গণনা | 20 |
পদ্ধতি দ্বারা কোটা ব্যবহার
একটি অনুরোধ দ্বারা ব্যবহৃত কোটা কল পদ্ধতির উপর নির্ভর করে। নিম্নলিখিত সারণীতে প্রতি-পদ্ধতি কোটা ব্যবহারের তালিকা রয়েছে:
| পদ্ধতি | কোটা খরচ |
|---|---|
matters.closematters.creatematters.deletematters.reopenmatters.updatematters.undelete | 1 বিষয় পড়া 1 বিষয় লিখুন |
matters.count | 1 গণনা |
matters.get | 1 বিষয় পড়া |
matters.list | 10টি বিষয় পড়ে |
matters.addPermissionsmatters.removePermissions | 1 বিষয় পড়া 1 বিষয় লিখুন 1 বিষয় অনুমতি লিখুন |
matters.exports.create | 1 রপ্তানি পড়া 10 রপ্তানি লিখেছেন |
matters.exports.delete | 1 রপ্তানি লিখুন |
matters.exports.get | 1 রপ্তানি পড়া |
matters.exports.list | 5টি রপ্তানি পড়ে |
matters.holds.addHeldAccountsmatters.holds.creatematters.holds.deletematters.holds.removeHeldAccountsmatters.holds.update | 1 বিষয় পড়া 1 বিষয় লিখুন 1 হোল্ড পড়া 1 হোল্ড লিখুন |
matters.holds.list | 1 বিষয় পড়া 3 হোল্ড রিড |
matters.holds.accounts.creatematters.holds.accounts.deletematters.holds.accounts.list | 1 বিষয় পড়া 1 বিষয় লিখুন 1 হোল্ড পড়া 1 হোল্ড লিখুন |
matters.savedQueries.creatematters.savedQueries.delete | 1 বিষয় পড়া 1 বিষয় লিখুন 1টি সংরক্ষিত প্রশ্ন পড়া হয়েছে 1 সংরক্ষিত প্রশ্ন লিখুন |
matters.savedQueries.get | 1 বিষয় পড়া 1টি সংরক্ষিত প্রশ্ন পড়া হয়েছে |
matters.savedQueries.list | 1 বিষয় পড়া 3টি সংরক্ষিত প্রশ্ন পড়ে |
operations.get | 1টি দীর্ঘ-চলমান অপারেশন পড়া হয়েছে |
সময়-ভিত্তিক কোটা ত্রুটিগুলি সমাধান করুন
আপনি যদি প্রতি-মিনিট বা প্রতি-প্রতিষ্ঠান কোটা অতিক্রম করেন, আপনি সাধারণত একটি 429: Too many requests HTTP স্থিতি কোড প্রতিক্রিয়া।
সমস্ত সময়-ভিত্তিক ত্রুটির জন্য (প্রতি X মিনিটে সর্বাধিক N অনুরোধ), আমরা সুপারিশ করি যে আপনার কোডটি ব্যতিক্রম ক্যাচ করে এবং আপনার ডিভাইসগুলি অত্যধিক লোড তৈরি না করে তা নিশ্চিত করার জন্য একটি ছোট সূচক ব্যাকঅফ ব্যবহার করুন৷
সূচকীয় ব্যাকঅফ হল নেটওয়ার্ক অ্যাপ্লিকেশনগুলির জন্য একটি আদর্শ ত্রুটি পরিচালনার কৌশল। একটি এক্সপোনেনশিয়াল ব্যাকঅফ অ্যালগরিদম অনুরোধের মধ্যে সর্বোচ্চ ব্যাকঅফ টাইম পর্যন্ত দ্রুতগতিতে বাড়ানোর অপেক্ষার সময় ব্যবহার করে অনুরোধের পুনঃপ্রচার করে। অনুরোধগুলি এখনও অসফল হলে, অনুরোধ সফল না হওয়া পর্যন্ত অনুরোধগুলির মধ্যে বিলম্ব সময়ের সাথে বৃদ্ধি পাওয়া গুরুত্বপূর্ণ।
উদাহরণ অ্যালগরিদম
একটি সূচকীয় ব্যাকঅফ অ্যালগরিদম দ্রুততার সাথে পুনরায় চেষ্টা করে, পুনঃপ্রচারের মধ্যে অপেক্ষার সময়কে সর্বোচ্চ ব্যাকঅফ সময় পর্যন্ত বাড়িয়ে দেয়। যেমন:
- Google Vault API এ একটি অনুরোধ করুন।
- অনুরোধ ব্যর্থ হলে, 1 +
random_number_millisecondsঅপেক্ষা করুন এবং অনুরোধটি পুনরায় চেষ্টা করুন। - অনুরোধ ব্যর্থ হলে, 2 +
random_number_millisecondsঅপেক্ষা করুন এবং অনুরোধটি পুনরায় চেষ্টা করুন। - অনুরোধ ব্যর্থ হলে, 4 +
random_number_millisecondsঅপেক্ষা করুন এবং অনুরোধটি পুনরায় চেষ্টা করুন। - এবং তাই,
maximum_backoffসময় পর্যন্ত। - কিছু সর্বোচ্চ সংখ্যক পুনঃপ্রচেষ্টা পর্যন্ত অপেক্ষা করা এবং পুনরায় চেষ্টা করা চালিয়ে যান, তবে পুনরায় চেষ্টার মধ্যে অপেক্ষার সময় বাড়াবেন না।
কোথায়:
- অপেক্ষার সময় হল
min(((2^n)+random_number_milliseconds), maximum_backoff), প্রতিটি পুনরাবৃত্তির (অনুরোধ) জন্যn1 দ্বারা বৃদ্ধি করা হয়েছে। -
random_number_millisecondsহল 1,000 এর থেকে কম বা সমান মিলিসেকেন্ডের একটি এলোমেলো সংখ্যা। এটি এমন ঘটনাগুলি এড়াতে সাহায্য করে যেখানে অনেক ক্লায়েন্ট কিছু পরিস্থিতির দ্বারা সিঙ্ক্রোনাইজ করা হয় এবং সিঙ্ক্রোনাইজড তরঙ্গে অনুরোধ পাঠানোর জন্য একবারে পুনরায় চেষ্টা করুন।random_number_millisecondsমান প্রতিটি পুনরায় চেষ্টা করার অনুরোধের পরে পুনরায় গণনা করা হয়। -
maximum_backoffসাধারণত 32 বা 64 সেকেন্ড। উপযুক্ত মান ব্যবহারের ক্ষেত্রে নির্ভর করে।
ক্লায়েন্ট maximum_backoff সময়ে পৌঁছে যাওয়ার পরে পুনরায় চেষ্টা চালিয়ে যেতে পারে। এই পয়েন্টের পরে পুনরায় চেষ্টা করলে ব্যাকঅফ সময় বাড়ানোর প্রয়োজন নেই। উদাহরণস্বরূপ, যদি একটি ক্লায়েন্ট সর্বোচ্চ 64 সেকেন্ডের maximum_backoff সময় ব্যবহার করে, তাহলে এই মানটিতে পৌঁছানোর পরে, ক্লায়েন্ট প্রতি 64 সেকেন্ডে পুনরায় চেষ্টা করতে পারে। কিছু সময়ে, ক্লায়েন্টদের অনির্দিষ্টকালের জন্য পুনরায় চেষ্টা করা থেকে বিরত রাখা উচিত।
পুনরায় চেষ্টা এবং পুনঃপ্রচারের সংখ্যার মধ্যে অপেক্ষার সময় আপনার ব্যবহারের ক্ষেত্রে এবং নেটওয়ার্কের অবস্থার উপর নির্ভর করে।
কোটা বৃদ্ধির জন্য অনুরোধ করুন
আপনার প্রকল্পের সম্পদ ব্যবহারের উপর নির্ভর করে, আপনি একটি কোটা সমন্বয়ের অনুরোধ করতে চাইতে পারেন। একটি পরিষেবা অ্যাকাউন্ট দ্বারা API কলগুলি একটি একক অ্যাকাউন্ট ব্যবহার করে বলে মনে করা হয়। একটি সমন্বয় করা কোটার জন্য আবেদন অনুমোদনের গ্যারান্টি দেয় না। কোটা সামঞ্জস্যের অনুরোধগুলি যা উল্লেখযোগ্যভাবে কোটার মান বৃদ্ধি করবে অনুমোদিত হতে বেশি সময় নিতে পারে।
সব প্রকল্পে একই কোটা নেই। আপনি সময়ের সাথে সাথে Google ক্লাউড ব্যবহার করার সাথে সাথে আপনার কোটার মান বাড়ানোর প্রয়োজন হতে পারে। আপনি যদি ব্যবহারে একটি উল্লেখযোগ্য আসন্ন বৃদ্ধি আশা করেন, আপনি Google ক্লাউড কনসোলে কোটা পৃষ্ঠা থেকে সক্রিয়ভাবে কোটা সমন্বয়ের জন্য অনুরোধ করতে পারেন।
আরও জানতে, নিম্নলিখিত সংস্থানগুলি দেখুন:
মূল্য নির্ধারণ
Google Workspace গ্রাহকদের জন্য কোনও অতিরিক্ত খরচ ছাড়াই Google Vault API-এর সমস্ত ব্যবহার উপলব্ধ।