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

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

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

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

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

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

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

নিম্নলিখিত সারণী ইমেল অডিট API-এর জন্য কোটা তালিকাভুক্ত করে:

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