ব্যবহারের সীমা

Google Drive API একটি শেয়ার করা পরিষেবা হওয়ায়, আমরা কোটা ও সীমাবদ্ধতা প্রয়োগ করি যাতে সব ব্যবহারকারী এটি সঠিকভাবে ব্যবহার করতে পারেন এবং Google Workspace সিস্টেমের সামগ্রিক পারফর্ম্যান্স সুরক্ষিত থাকে।

কোটা ইউনিট-এর ভিত্তিতে সীমা নির্ধারণ করা হয়, এটি হল পরিমাপের একটি অ্যাবস্ট্রাক্ট ইউনিট যা Google Drive রিসোর্স ব্যবহারকে বোঝায়।

Drive API কোটা

তিন ধরনের কোটা এনফোর্স করা হয়:

  • প্রতি মিনিটে প্রতি প্রোজেক্ট: এটি হল কোটা ইউনিটের সংখ্যা যা আপনার Google Cloud প্রোজেক্ট এক মিনিটে ব্যবহার করতে পারে।

  • প্রতি মিনিটে প্রতি ব্যবহারকারী প্রতি প্রোজেক্ট: এটি হল কোটা ইউনিটের সংখ্যা যা যেকোনও একজন নির্দিষ্ট ব্যবহারকারী আপনার Cloud প্রোজেক্টে ব্যবহার করতে পারবেন। এই সীমার লক্ষ্য হল আপনার ব্যবহারকারীদের মধ্যে ব্যবহারের ন্যায্য বন্টন নিশ্চিত করতে আপনাকে সাহায্য করা।

  • প্রতিদিন প্রতি প্রোজেক্ট: চার্জ প্রযোজ্য হওয়ার আগে ২৪ ঘণ্টার মধ্যে আপনার Google Cloud প্রোজেক্ট সর্বাধিক কত বাইট ইগ্রেস করতে পারবে তা এটি নির্ধারণ করে।

নিম্নলিখিত সারণীতে এই সীমা সম্পর্কে বিস্তারিত বিবরণ দেওয়া হয়েছে:

ব্যবহারের সীমার ধরন সীমা
প্রতি প্রোজেক্টে প্রতি মিনিটে ১,০০০,০০০ কোটা ইউনিট
প্রতি মিনিটে প্রতি ব্যবহারকারী প্রতি প্রোজেক্ট ৩২৫,০০০ কোটা ইউনিট
প্রতিদিন প্রোজেক্ট পিছু ১ টিবি

আপনি কোটা অতিক্রম করলে, 403: User rate limit exceeded HTTP স্ট্যাটাস কোড রেসপন্স পাবেন। Drive ব্যাকএন্ডে অতিরিক্ত রেট লিমিট চেক করার কারণেও 429: Rate limit exceeded উত্তর জেনারেট হতে পারে। এরকম হলে, আপনাকে এক্সপোনেনশিয়াল ব্যাকঅফ অ্যালগরিদম ব্যবহার করে পরে আবার চেষ্টা করতে হবে।

দৈনিক বিলিং থ্রেশহোল্ড

এই প্রতিদিন প্রতি প্রোজেক্ট সীমা, চার্জ প্রযোজ্য হওয়ার আগে ২৪ ঘণ্টার মধ্যে আপনার Google Cloud প্রোজেক্ট ব্যবহার করতে পারে এমন কোটা ইউনিটের সর্বাধিক সংখ্যা নির্ধারণ করে।

এই থ্রেশহোল্ডের নিচে ব্যবহার করলে অতিরিক্ত চার্জ দিতে হয় না এবং আপনার Google Cloud অ্যাকাউন্টে বিল করা হয় না। বিলিং সংক্রান্ত সম্পূর্ণ বিবরণ ২০২৬ সালের শেষের দিকে শেয়ার করা হবে এবং কোনও পরিবর্তন কার্যকর হওয়ার অন্তত ৯০ দিন আগে বিজ্ঞপ্তি দেওয়া হবে।

আপনি এই দৈনিক থ্রেশহোল্ড সীমা বাড়ানোর অনুরোধ করতে পারবেন না।

নিম্নলিখিত সারণীতে সীমা সম্পর্কে বিস্তারিত বিবরণ দেওয়া হয়েছে:

থ্রেশহোল্ডের সীমার ধরন সীমা
প্রতিদিন প্রোজেক্ট পিছু ৪০০,০০০,০০০ কোটা ইউনিট

আরও তথ্যের জন্য, এজেন্ট টুল ও API-এর জন্য Google Workspace-এর স্ট্যান্ডার্ডাইজড মডেল দেখুন।

প্রতি-পদ্ধতি কোটা ইউনিট খরচ

প্রতিটি অনুরোধে ব্যবহৃত কোটা ইউনিটের সংখ্যা, কল করা পদ্ধতির উপর নির্ভর করে পরিবর্তিত হয়, যেমনটি নিম্নলিখিত সারণীতে বর্ণনা করা হয়েছে:

Read পদ্ধতি (৫টি কোটা ইউনিট)

পদ্ধতি
drive.about.get
drive.accessproposals.get
drive.apps.get
drive.approvals.get
drive.changes.get
drive.children.get
drive.comments.get
drive.drives.get
drive.files.get (without alt=media)
drive.parents.get
drive.permissions.get
drive.properties.get
drive.replies.get
drive.revisions.get (without alt=media)
drive.teamdrives.get

পদ্ধতির তালিকা (১০০ কোটা ইউনিট)

পদ্ধতি
drive.accessproposals.list
drive.apps.list
drive.changes.list, drive.changes.watch
drive.children.list
drive.comments.list
drive.drives.list
drive.files.list, drive.files.watch
drive.parents.list
drive.permissions.list
drive.properties.list
drive.replies.list
drive.revisions.list
drive.teamdrives.list

পদ্ধতি এডিট করা (৫০ কোটা ইউনিট)

পদ্ধতি
drive.approvals.decline
drive.children.delete, drive.children.insert
drive.comments.create, drive.comments.delete, drive.comments.insert, drive.comments.patch, drive.comments.update
drive.drives.create, drive.drives.delete, drive.drives.hide, drive.drives.insert, drive.drives.unhide, drive.drives.update
drive.files.copy, drive.files.create, drive.files.delete, drive.files.emptyTrash, drive.files.insert, drive.files.modifyLabels, drive.files.patch, drive.files.touch, drive.files.trash, drive.files.untrash, drive.files.update
drive.parents.delete, drive.parents.insert
drive.permissions.create, drive.permissions.delete, drive.permissions.insert, drive.permissions.patch, drive.permissions.update
drive.properties.delete, drive.properties.insert, drive.properties.patch, drive.properties.update
drive.replies.create, drive.replies.delete, drive.replies.insert, drive.replies.patch, drive.replies.update
drive.revisions.delete, drive.revisions.patch, drive.revisions.update
drive.teamdrives.create, drive.teamdrives.delete, drive.teamdrives.insert, drive.teamdrives.update

ডাউনলোড পদ্ধতি (২০০ কোটা ইউনিট)

পদ্ধতি
drive.files.download, drive.files.export, drive.files.get (with alt=media)
drive.revisions.get (with alt=media)

অন্যান্য পদ্ধতি (৫টি কোটা ইউনিট)

পদ্ধতি
drive.changes.getStartPageToken
drive.channels.stop
drive.files.generateCseToken, drive.files.generateIds, drive.files.listLabels
drive.operations.get
drive.permissions.getIdForEmail

অতিরিক্ত বাধ্যবাধকতা

Drive API-এর সাথে কাজ করার সময় নিম্নলিখিত সীমাবদ্ধতাগুলি এনফোর্স করা হয়:

  • Google Workspace ব্যবহারকারীরা 'আমার ড্রাইভ' এবং সব শেয়ার্ড ড্রাইভের মধ্যে প্রতিদিন শুধুমাত্র ৭৫০ জিবি আপলোড করতে পারবেন; এই সীমা কপির ক্ষেত্রেও প্রযোজ্য।

  • যেসব ব্যবহারকারী ৭৫০ জিবি সীমায় পৌঁছে গেছেন অথবা ৭৫০ জিবির চেয়ে বড় ফাইল আপলোড করেছেন, তারা ২৪ ঘণ্টা না হওয়া পর্যন্ত অতিরিক্ত ফাইল আপলোড বা কপি করতে পারবেন না।

  • ব্যবহারকারীরা সর্বাধিক ৫ টিবি সাইজের ফাইল আপলোড করতে পারবেন; শুধুমাত্র প্রথম ফাইলটি যা সীমা অতিক্রম করে, আপলোড করা সম্পূর্ণ করে। ব্যবহারকারীরা সর্বাধিক ৭৫০ জিবি সাইজের ফাইল কপি করতে পারবেন।

  • কোনও বিজ্ঞপ্তি চ্যানেল খোলার সময় নির্দিষ্ট করা ঠিকানায় পাঠানো বিজ্ঞপ্তি আপনার কোটার সীমার মধ্যে গণনা করা হয় না। তবে, changes.watch, channels.stop এবং files.watch মেথডে করা কল আপনার কোটার মধ্যে ধরা হয়।

  • প্রতি মিনিটের কোটার মধ্যে থাকলে, আপনি প্রতিদিন যতবার খুশি অনুরোধ করতে পারেন।

  • আপনার Google Workspace অ্যাকাউন্টের ধরনের উপর নির্ভর করে, অতিরিক্ত Drive স্টোরেজ সীমা আছে।

সময়-ভিত্তিক কোটা সংক্রান্ত সমস্যার সমাধান করা

সময়-ভিত্তিক সব সমস্যার (X মিনিটে সর্বাধিক N অনুরোধ) জন্য, আমরা সাজেস্ট করি যে আপনার কোড যেন ব্যতিক্রমটি ধরে এবং আপনার ডিভাইস যাতে অতিরিক্ত লোড জেনারেট না করে তা নিশ্চিত করতে ট্রাঙ্কেট করা এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করে।

এক্সপোনেনশিয়াল ব্যাকঅফ হল নেটওয়ার্ক অ্যাপ্লিকেশনের জন্য স্ট্যান্ডার্ড এরর হ্যান্ডলিং স্ট্র্যাটেজি। একটি এক্সপোনেনশিয়াল ব্যাকঅফ অ্যালগরিদম, অনুরোধের মধ্যে এক্সপোনেনশিয়ালি ক্রমবর্ধমান অপেক্ষার সময় ব্যবহার করে অনুরোধের চেষ্টা করে, যা সর্বাধিক ব্যাকঅফ সময় পর্যন্ত চলে। অনুরোধ এখনও সম্পূর্ণ না হলে, অনুরোধ সম্পূর্ণ না হওয়া পর্যন্ত অনুরোধের মধ্যে বিলম্বের সময় বাড়ানো গুরুত্বপূর্ণ।

উদাহরণ অ্যালগরিদম

এক্সপোনেনশিয়াল ব্যাকঅফ অ্যালগরিদম এক্সপোনেনশিয়ালভাবে অনুরোধের পুনরাবৃত্তি করে, সর্বাধিক ব্যাকঅফ সময় পর্যন্ত পুনরাবৃত্তির মধ্যে অপেক্ষার সময় বাড়ায়। যেমন:

  1. Google Drive API-তে অনুরোধ করুন।
  2. অনুরোধটি ব্যর্থ হলে, ১ + random_number_milliseconds অপেক্ষা করুন এবং অনুরোধটি আবার চেষ্টা করুন।
  3. অনুরোধটি ব্যর্থ হলে, ২ + random_number_milliseconds অপেক্ষা করুন এবং অনুরোধটি আবার চেষ্টা করুন।
  4. অনুরোধটি ব্যর্থ হলে, 4 + random_number_milliseconds অপেক্ষা করুন এবং অনুরোধটি আবার চেষ্টা করুন।
  5. এবং এইভাবে maximum_backoff বার পর্যন্ত।
  6. সর্বাধিক যতবার চেষ্টা করা যায় ততবার অপেক্ষা ও চেষ্টা করা চালিয়ে যান, তবে চেষ্টা করার মধ্যে অপেক্ষার সময় বাড়িয়ে দেবেন না।

কোথায়:

  • অপেক্ষার সময় হল min(((2^n)+random_number_milliseconds), maximum_backoff), প্রতিটি ইটারেশনের (অনুরোধ) জন্য n ১ করে বাড়ানো হয়।
  • random_number_milliseconds হল ১,০০০-এর থেকে কম বা সমান মিলি সেকেন্ডের একটি র‍্যান্ডম সংখ্যা। এটি এমন পরিস্থিতি এড়াতে সাহায্য করে যেখানে অনেক ক্লায়েন্ট কোনও পরিস্থিতির কারণে সিঙ্ক্রোনাইজ হয় এবং সবাই একসাথে আবার চেষ্টা করে, সিঙ্ক্রোনাইজড তরঙ্গে অনুরোধ পাঠায়। প্রতিটি অনুরোধ আবার করার পরে random_number_milliseconds-এর ভ্যালু আবার গণনা করা হয়।
  • maximum_backoff সাধারণত ৩২ বা ৬৪ সেকেন্ডের হয়। ব্যবহারের উপর নির্ভর করে উপযুক্ত ভ্যালু নির্ধারণ করা হয়।

maximum_backoff বার চেষ্টা করার পরেও ক্লায়েন্ট আবার চেষ্টা করা চালিয়ে যেতে পারে। এই পয়েন্টের পরে আবার চেষ্টা করার জন্য ব্যাকঅফ টাইম বাড়ানো চালিয়ে যাওয়ার প্রয়োজন নেই। যেমন, কোনও ক্লায়েন্ট যদি ৬৪ সেকেন্ডের maximum_backoff সময় ব্যবহার করে, তাহলে এই ভ্যালুতে পৌঁছানোর পরে, ক্লায়েন্ট প্রতি ৬৪ সেকেন্ড অন্তর আবার চেষ্টা করতে পারবে। কোনও এক সময়, ক্লায়েন্টদের অনির্দিষ্টকাল ধরে আবার চেষ্টা করা থেকে বিরত রাখতে হবে।

আবার চেষ্টা করার মধ্যে অপেক্ষার সময় এবং কতবার চেষ্টা করা হবে তা আপনার ব্যবহারের ক্ষেত্র এবং নেটওয়ার্কের অবস্থার উপর নির্ভর করে।

দাম

Google Drive API-এর সব স্ট্যান্ডার্ড ব্যবহার কোনও অতিরিক্ত খরচ ছাড়াই উপলভ্য। কোটা অনুরোধের সীমা অতিক্রম করলে, ২০২৬ সালের শেষের দিকে আপনার Google Cloud বিলিং অ্যাকাউন্টে চার্জ করা হবে। আরও তথ্যের জন্য, এজেন্ট টুল ও API-এর জন্য Google Workspace-এর স্ট্যান্ডার্ডাইজড মডেল দেখুন।

কোটা বাড়ানোর অনুরোধ করা

আপনার প্রোজেক্টের রিসোর্স ব্যবহারের উপর নির্ভর করে, আপনি কোটা অ্যাডজাস্ট করার অনুরোধ করতে পারেন। কোনও পরিষেবা অ্যাকাউন্টের মাধ্যমে API কল করা হলে, তা একটি অ্যাকাউন্ট ব্যবহার করছে বলে ধরে নেওয়া হয়। অ্যাডজাস্ট করা কোটার জন্য আবেদন করলেই যে অনুমোদন পাওয়া যাবে, এমন কোনও গ্যারেন্টি নেই। কোটা অ্যাডজাস্টমেন্টের অনুরোধ যা কোটার মান উল্লেখযোগ্যভাবে বৃদ্ধি করবে তা অনুমোদিত হতে বেশি সময় লাগতে পারে।

সব প্রোজেক্টের কোটা এক নয়। সময়ের সাথে সাথে আপনি Google Cloud-এর ব্যবহার যত বাড়াবেন, আপনার কোটার ভ্যালুও তত বাড়াতে হতে পারে। আপনি যদি আশা করেন যে, আগামী দিনে ব্যবহার উল্লেখযোগ্যভাবে বৃদ্ধি পাবে, তাহলে আপনি Google Cloud কনসোলের কোটা ও সিস্টেমের সীমা পৃষ্ঠা থেকে কোটা অ্যাডজাস্ট করার অনুরোধ করতে পারেন।

আরও জানতে, নিম্নলিখিত রিসোর্স দেখুন:

Drive MCP সার্ভার কোটা

Drive MCP সার্ভার কোয়েরি খরচ বরাদ্দকরণ মেট্রিক ব্যবহার করে। নিম্নলিখিত সারণীতে প্রতিটি Drive MCP সার্ভার পদ্ধতির জন্য কোয়েরি খরচ বিভাগ অনুসারে বিস্তারিতভাবে দেওয়া আছে:

Drive MCP কোটা

দুই ধরনের কোটা এনফোর্স করা হয়:

  • প্রতি মিনিটে প্রতি প্রোজেক্টে: এটি হল এক মিনিটের জন্য আপনার Google Cloud প্রোজেক্টে কোয়েরির খরচ।

  • প্রতি মিনিটে প্রতি ব্যবহারকারী প্রতি প্রোজেক্ট: এটি হল আপনার Google Cloud প্রোজেক্টের জন্য এক মিনিটের কোয়েরি খরচ যা কোনও নির্দিষ্ট ব্যবহারকারী ব্যবহার করতে পারবেন।

নিচের সারণীতে এই কোটা সম্পর্কে বিস্তারিত বিবরণ দেওয়া হয়েছে:

ব্যবহারের সীমার ধরন সীমা
প্রতি প্রোজেক্টে প্রতি মিনিটে ৩২৫,০০০
প্রতি মিনিটে প্রতি ব্যবহারকারী প্রতি প্রোজেক্ট ১,০০০,০০০

Drive MCP টুলসেট কোটা

নিম্নলিখিত সারণীতে প্রতিটি drivemcp.googleapis.com টুলসেটের জন্য কোয়েরির খরচ বিস্তারিতভাবে দেওয়া হয়েছে:

এন্ডপয়েন্ট টুল কোয়েরির খরচ

/mcp/v1

copy_file

50

create_file

50

download_file_content

200

get_file_metadata

5

get_file_permissions

5

list_recent_files

100

read_file_content

200

search_files

100

আরও তথ্যের জন্য, Drive MCP API রেফারেন্স দেখুন।