ব্যবহারের সীমা এবং কোটা

সীমা এবং কোটা গুগলের পরিকাঠামোকে এমন একটি স্বয়ংক্রিয় প্রক্রিয়া থেকে রক্ষা করে যা ইমেল অডিট API কে অনুপযুক্ত উপায়ে ব্যবহার করে। API থেকে অতিরিক্ত অনুরোধের ফলে কোনও ক্ষতিকারক টাইপো হতে পারে, অথবা অদক্ষভাবে ডিজাইন করা সিস্টেমের ফলে অপ্রয়োজনীয় API কল করা হতে পারে। কারণ যাই হোক না কেন, একটি নির্দিষ্ট উৎস থেকে ট্র্যাফিক একটি নির্দিষ্ট স্তরে পৌঁছালে তা ব্লক করা Google Workspace সিস্টেমের সামগ্রিক স্বাস্থ্যের জন্য প্রয়োজনীয়। সীমা নিশ্চিত করতে সাহায্য করে যে একজন ডেভেলপারের পদক্ষেপ বৃহত্তর সম্প্রদায়ের উপর নেতিবাচক প্রভাব ফেলতে পারে না।

আপনার API অনুরোধ ব্যর্থ হওয়ার সম্ভাবনা কম থাকলে, আপনি একটি HTTP স্ট্যাটাস কোড প্রতিক্রিয়া পাবেন। 403 এর একটি স্ট্যাটাস কোডে ভুল ইনপুট সম্পর্কে ত্রুটির তথ্য রয়েছে এবং 503 এর একটি HTTP স্ট্যাটাস কোডে ত্রুটির তথ্য রয়েছে যা নির্দেশ করে যে কোন API কোটা অতিক্রম করা হয়েছে। এই প্রতিক্রিয়াগুলি আপনার কাস্টম অ্যাপ্লিকেশনকে এই ত্রুটিগুলি সনাক্ত করতে এবং যথাযথ ব্যবস্থা নিতে দেয়।

যদি আপনার অনুরোধগুলি একটি নির্দিষ্ট সময়ের মধ্যে সম্পন্ন করার প্রয়োজন হয়, তাহলে আপনার অনুরোধগুলি সমান্তরালভাবে পাঠান অথবা আপনার জাভা বা C# অ্যাপ্লিকেশনে একাধিক থ্রেড ব্যবহার করুন। সমান্তরাল অনুরোধের একটি উদাহরণ হল একই সাথে একজন ব্যবহারকারীর কাছ থেকে অনেকগুলি ইমেল যোগ বা অপসারণ করার পরিবর্তে বিভিন্ন ব্যবহারকারীর কাছ থেকে ছোট ছোট ব্যাচের ইমেল অনুরোধ করা। থ্রেডের ক্ষেত্রে, 10 টি থ্রেড দিয়ে শুরু করার চেষ্টা করুন, প্রতিটি ব্যবহারকারীর ইমেলের জন্য একটি থ্রেড। মনে রাখবেন, থ্রেড সুপারিশে ট্রেড-অফ রয়েছে এবং এটি সমস্ত API পরিস্থিতিতে কার্যকর নয়। যদি অনুরোধের সংখ্যা খুব বেশি হয়ে যায়, তাহলে কোটা ত্রুটি দেখা দেয়। আরেকটি ট্রেড-অফ উদাহরণ হল সর্বাধিক সামগ্রিক বার্তা আপলোড হারের জন্য ইমেল অডিট API-এর কোটা। আপলোড হার হল প্রতি ব্যবহারকারীর জন্য একটি API অনুরোধ - প্রতি সেকেন্ডে -, যত থ্রেড আপলোড অনুরোধ করছে তা কোন ব্যাপার না।

সময় ভিত্তিক সকল ত্রুটির জন্য (প্রতি থ্রেডে N সেকেন্ডের জন্য সর্বাধিক N জিনিস), বিশেষ করে 503 স্ট্যাটাস কোড ত্রুটির জন্য, আমরা সুপারিশ করি যে আপনার কোডটি ব্যতিক্রমটি ধরুন এবং একটি সূচকীয় ব্যাকঅফ অ্যালগরিদম ব্যবহার করে, ব্যর্থ কলটি পুনরায় চেষ্টা করার আগে একটি ছোট বিলম্বের জন্য অপেক্ষা করুন। একটি থ্রেডের জন্য একটি ইমেল অডিট API উদাহরণ হল 5 সেকেন্ড অপেক্ষা করা এবং ব্যর্থ কলটি পুনরায় চেষ্টা করা। যদি অনুরোধটি সফল হয়, তবে অন্যান্য থ্রেডের জন্য এই প্যাটার্নটি পুনরাবৃত্তি করুন। যদি দ্বিতীয় অনুরোধটি সফল না হয়, তবে আপনার অ্যাপ্লিকেশনটি কলটি সফল না হওয়া পর্যন্ত অনুরোধের ফ্রিকোয়েন্সি স্কেল করা উচিত। উদাহরণস্বরূপ, প্রাথমিক 5 সেকেন্ড বিলম্ব 10 সেকেন্ডে বাড়িয়ে আপনার ব্যর্থ কলটি আবার চেষ্টা করুন। এছাড়াও, পুনরায় চেষ্টা করার সীমা নির্ধারণ করুন। উদাহরণস্বরূপ, আপনার অ্যাপ্লিকেশন ব্যবহারকারীকে একটি ত্রুটি ফেরত দেওয়ার আগে বিভিন্ন বিলম্বের সময় সহ 5 থেকে 7 বার অনুরোধটি পুনরায় চেষ্টা করুন।

নিম্নলিখিত টেবিলে ইমেল অডিট API-এর সীমা তালিকাভুক্ত করা হয়েছে:

API সীমা বিভাগ	সীমা
এনক্রিপ্ট করা মেলবক্স ফাইল, তৈরি	আকারের উপর নির্ভর করে, এনক্রিপ্ট করা মেলবক্স ফাইল তৈরি করতে সিস্টেমটি বেশ কয়েক দিন সময় নিতে পারে।
এনক্রিপ্ট করা মেলবক্স ফাইল, মুছে ফেলার সময় ত্রুটি	যখন কোনও এনক্রিপ্ট করা মেলবক্স মুছে ফেলার সময় ত্রুটি দেখা দেয়, তখন অনুরোধটিকে একটি MARKED_DELETE স্ট্যাটাস দেওয়া হয়। এই সারাংশ এবং রপ্তানি ফাইলগুলি 24 ঘন্টার মধ্যে স্বয়ংক্রিয়ভাবে Google দ্বারা আবার মুছে ফেলার জন্য নেওয়া হয় (সম্ভাব্য অবশিষ্ট ফাইলগুলি সহ)। যদি MARKED_DELETE এর স্ট্যাটাস ধারাবাহিকভাবে ফিরে আসে, তাহলে একটি সূচকীয় ব্যাক অফ কৌশল চেষ্টা করুন।

নিম্নলিখিত টেবিলে ইমেল অডিট API-এর কোটা তালিকাভুক্ত করা হয়েছে:

API কোটা বিভাগ	কোটা
ClientLogin প্রমাণীকরণ টোকেন	২৪ ঘন্টার জন্য বৈধ। ত্রুটি হল 401 token expired ।
তারিখের ফর্ম্যাট	ইমেল অডিট API ব্যবহার করার আগে সমস্ত তারিখকে সমন্বিত ইউনিভার্সাল টাইম (UTC) ফর্ম্যাটে রূপান্তর করুন। আরও তথ্যের জন্য, UTC কনভার্টার দেখুন।
এনক্রিপ্ট করা মেলবক্স ফাইল, EXPIRED সারাংশ এবং রপ্তানি ফাইল	গুগল ৩ সপ্তাহের জন্য এনক্রিপ্ট করা মেলবক্স ফাইলগুলি সংরক্ষণ করে। সেই সময়ের পরে, সেগুলি মুছে ফেলা হয়। এই সময়ের মধ্যে এই মেলবক্স ফাইলগুলি ডাউনলোড করা ডোমেন প্রশাসকের দায়িত্ব।
এনক্রিপ্ট করা মেলবক্স ফাইল, ফর্ম্যাট	এনক্রিপ্ট করা মেলবক্স ফাইলগুলি mbox ফর্ম্যাটে থাকে।
এনক্রিপ্ট করা মেলবক্স ফাইল, সর্বাধিক তৈরির অনুরোধ	ডোমেনের সকল প্রশাসকের কাছ থেকে প্রতিদিন সর্বোচ্চ ১০০টি মেলবক্স রপ্তানি তৈরির অনুরোধ করা যেতে পারে।
এনক্রিপ্ট করা মেলবক্স ফাইলের অবস্থা, পৃষ্ঠাঙ্কন	সমস্ত মেলবক্স অনুরোধের স্থিতি অনুরোধ করার সময়, প্রতিক্রিয়াগুলি প্রচুর পরিমাণে ডেটা ফেরত দিতে পারে। ইমেল অডিট API এই ডেটাগুলিকে এমন পৃষ্ঠাগুলিতে ব্যাচ করে যেখানে প্রতিটি পৃষ্ঠায় সর্বাধিক 100টি এন্ট্রি থাকে এবং একটি link rel='next' ট্যাগে একটি URI ফলাফলের পরবর্তী পৃষ্ঠার দিকে নির্দেশ করে। আপনার ক্লায়েন্ট অ্যাপ্লিকেশন তৈরি করার সময়, আপনার কোডকে এই অতিরিক্ত ফলাফলগুলি পরিচালনা করতে হবে।
ইমেল মনিটর	প্রতিদিন ইমেল মনিটরের অনুরোধের সর্বোচ্চ সংখ্যা ১৫০০। এই সীমাটি ডোমেনের জন্য এবং দিনের বেলায় যেকোনো প্রশাসকের করা সমস্ত অনুরোধ অন্তর্ভুক্ত।
পাবলিক কী	ইমেল অডিট API শুধুমাত্র একটি কী সমর্থন করে। পাবলিক কীটি GNU প্রাইভেসি গার্ড (GPG) সফটওয়্যার ব্যবহার করে। এটি PGP ফর্ম্যাটে এবং ASCII-এনকোডেড RSA এনক্রিপশন কী। পাবলিক কী আপলোড করার আগে, আপনাকে প্রথমে এটিকে একটি base64 এনকোডেড স্ট্রিংয়ে রূপান্তর করতে হবে। পাবলিক কী ফাইলটি US-ASCII অক্ষর সেট ( IANA ASCII-এর জন্য পছন্দের অক্ষর সেট নাম) সহ পড়া উচিত।
অনুসন্ধান করা হচ্ছে	searchQuery এবং includeDeleted প্যারামিটারগুলি পারস্পরিকভাবে একচেটিয়া। includeDeleted="true" থাকলে একটি অনুসন্ধান কোয়েরি সম্ভব নয়।