افزونه های Google Classroom اکنون به طور کلی در دسترس توسعه دهندگان هستند! لطفاً برای اطلاعات بیشتر به
اسناد افزونه ها مراجعه کنید.
محدودیت های استفاده
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
سهمیه بر روی میانگین متحرک 60 ثانیه ای بررسی می شود که امکان افزایش استفاده را فراهم می کند . به طور پیش‌فرض، Classroom API مشمول محدودیت‌های جدول زیر است:
| محدود کنید | استاندارد سهمیه |
|---|
| پرس و جو در روز به ازای هر مشتری | 4,000,000 (میانگین 46 QPS) |
| پرس و جو در دقیقه به ازای هر مشتری | 3000 (50 QPS) |
| پرس و جو در دقیقه برای هر کاربر | 1200 (20 QPS) |
QPS مجاز ممکن است بسته به تعدادی از عوامل عملیاتی افزایش یا کاهش یابد.
اگر نیاز به درخواست بیشتر از محدودیت های اعمال شده برای پروژه خود دارید:
- ابتدا، مطمئن شوید که به خطاهای قابل امتحان مجدد (مانند خطای
RESOURCE_EXHAUSTED که زمانی که یک درخواست از حد شما فراتر می‌رود، بازگردانده می‌شود) با امتحان مجدد درخواست، ترجیحاً با استفاده از عقب‌نشینی نمایی، پاسخ دهید. - اگر در نظرسنجی برای تغییرات در نقطه پایانی که در آن ارائه شده است، به جای آن از اعلان‌های فشار استفاده کنید.
- اگر هنوز نیاز به درخواست بیشتر از محدودیت های تعیین شده برای پروژه خود دارید، دستورالعمل های مربوط به درخواست محدودیت های بالاتر را در زیر ببینید.
برای مشاهده یا تغییر محدودیت‌های استفاده برای پروژه خود، یا درخواست افزایش سهمیه، موارد زیر را انجام دهید:
- اگر قبلاً یک حساب صورتحساب برای پروژه خود ندارید، آن را ایجاد کنید.
- از صفحه Enabled APIs کتابخانه API در کنسول API دیدن کنید و یک API را از لیست انتخاب کنید.
- برای مشاهده و تغییر تنظیمات مربوط به سهمیه، سهمیه ها را انتخاب کنید. برای مشاهده آمار استفاده، استفاده را انتخاب کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-30 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-30 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Usage Limits\n\nQuota is checked on a **60-second moving average** , which **allows for spikes in\nusage**. By default, the Classroom API is subject to the limits in the following\ntable:\n\n| Limit | Quota Standard |\n|-------------------------------|-------------------------|\n| Queries per day per client | 4,000,000 (Avg. 46 QPS) |\n| Queries per minute per client | 3,000 (50 QPS) |\n| Queries per minute per user | 1,200 (20 QPS) |\n\nThe permitted QPS may be increased or decreased depending on a number of\noperational factors.\n\nIf you need to make more requests than the limits applied to your project:\n\n1. First, ensure that you respond to retryable errors (such as the `RESOURCE_EXHAUSTED` error that is returned when a request exceeds your limits) by retrying the request, preferably using exponential backoff.\n2. If you are polling for changes on an endpoint where this is offered, consider using [push notifications](/workspace/classroom/guides/push-notifications) instead.\n3. If you still need to make more requests than the limits assigned to your project, see below for instructions on requesting higher limits.\n\nTo view or change usage limits for your project, or to request an increase to\nyour quota, do the following:\n\n1. If you don't already have a [billing account](//cloud.google.com/billing/docs/how-to/manage-billing-account) for your project, then create one.\n2. [Visit the Enabled APIs page of the\n API library](https://console.cloud.google.com/apis/enabled) in the API Console, and select an API from the list.\n3. To view and change quota-related settings, select **Quotas** . To view usage statistics, select **Usage**."]]
