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

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

API অনুরোধ ব্যর্থতা

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

একটি নির্দিষ্ট সময়ের মধ্যে অনুরোধগুলি সম্পূর্ণ করুন

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

সময় ভিত্তিক ত্রুটি

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

সীমা

API সীমা বিভাগ	সীমা
প্রতি সেকেন্ডে প্রশ্ন (QPS)	বিকাশকারী প্রকল্পের সীমা প্রতি সেকেন্ডে 10টি প্রশ্ন (QPS) প্রতি অ্যাকাউন্ট।

কোটা

API কোটা বিভাগ	কোটা
প্রতিদিন সর্বোচ্চ API অনুরোধ	প্রতিদিন সর্বোচ্চ API অনুরোধ 500,000।
সংরক্ষণাগার, বার্তার মেয়াদ শেষ	গ্রুপ আর্কাইভের মেয়াদ শেষ হয় না। গ্রুপটি মুছে ফেলা না হওয়া পর্যন্ত বার্তাগুলি একটি সংরক্ষণাগারে থাকে৷ ইমেল ধারণ নীতি গোষ্ঠীর সংরক্ষণাগারে থাকা বার্তাগুলিকে প্রভাবিত করে না৷
মেল বার্তা আকার	সর্বাধিক মেল বার্তার আকার হল 25MB৷ এই সীমার মধ্যে বার্তার মেটা ডেটা হেডার, বডি এবং যেকোনো সংযুক্তি অন্তর্ভুক্ত রয়েছে।

অন্যান্য ধরনের সীমা

অন্যান্য ধরনের সীমা	সীমাবদ্ধতা এবং নির্দেশিকা
বিষয়বস্তুর প্রকার বিন্যাস	একটি ইমেল বার্তা অবশ্যই আদর্শ RFC 822 পাঠ্য বিন্যাসে হতে হবে৷ স্থানান্তরিত ইমেলগুলি আপলোড করার জন্য একটি অনুরোধের বিষয়বস্তু-প্রকার বিন্যাস Content-type: message/rfc822 শিরোনাম ব্যবহার করে।
API প্রতিক্রিয়াগুলিতে ডেটা বিন্যাস	প্রতিক্রিয়ার ডেটা বিন্যাস হল জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন ( JSON )।
ডেটা অবস্থান নীতি	ডেটা ট্রান্সফার API ডেটা অবস্থান নীতিগুলিকে সমর্থন করে না যাতে চুক্তির কারণে নির্দিষ্ট ভৌগলিক বা রাজনৈতিক সীমানায় ডেটা সংরক্ষণ করা প্রয়োজন৷ আপনার অ্যাকাউন্টের জন্য ডেটা অবস্থানের প্রয়োজন হলে ডেটা ট্রান্সফার API ব্যবহার করবেন না।
সমান্তরাল বার্তা সন্নিবেশ	ডেটা ট্রান্সফার API বিভিন্ন গ্রুপ আর্কাইভে ইমেল সন্নিবেশের জন্য সমান্তরাল অনুরোধ সমর্থন করে। কিন্তু ডেটা ট্রান্সফার API একই গ্রুপ আর্কাইভে সমান্তরাল বার্তা সন্নিবেশ সমর্থন করে না। বা ব্যাচ অনুরোধগুলি API-এর এই সংস্করণে সমর্থিত নয়।
অননুমোদিত অনুরোধ	ডেটা ট্রান্সফার API কোনো অননুমোদিত অনুরোধ গ্রহণ করে না। কোনো অনুমোদন টোকেন প্রদান করা না হলে একটি অনুরোধ অননুমোদিত বলে বিবেচিত হয়।