Method: courses.update

یک دوره را به‌روزرسانی می‌کند.

نکته: برخلاف سایر فیلدها، اگر levels از درخواست حذف شود، پاک نمی‌شود. متد courses.update فقط در صورتی levels تغییر می‌دهد که صریحاً ارائه شده باشد؛ در غیر این صورت، مقدار موجود حفظ می‌شود. از متد courses.patch برای پاک کردن فیلد levels استفاده کنید.

این متد کدهای خطای زیر را برمی‌گرداند:

  • اگر کاربر درخواست‌کننده مجاز به تغییر دوره درخواستی نباشد یا خطاهای دسترسی رخ دهد، PERMISSION_DENIED .
  • اگر هیچ دوره‌ای با شناسه درخواستی وجود نداشته باشد، NOT_FOUND .
  • FAILED_PRECONDITION برای خطاهای درخواست زیر:
    • دورهغیرقابل اصلاح
    • عنوان دورهCannotContainUrl

درخواست HTTP

PUT https://classroom.googleapis.com/v1/courses/{id}

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
id

string

شناسه دوره برای به‌روزرسانی. این شناسه می‌تواند شناسه اختصاص داده شده توسط کلاس درس یا یک alias باشد.

پارامترهای پرس و جو

پارامترها
previewVersion

enum ( PreviewVersion )

اختیاری. نسخه پیش‌نمایش API. این گزینه باید تنظیم شود تا بتوان به قابلیت‌های جدید API که در برنامه پیش‌نمایش در اختیار توسعه‌دهندگان قرار گرفته است، دسترسی پیدا کرد.

درخواست بدنه

بدنه درخواست شامل نمونه‌ای از Course است.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از Course است.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/classroom.courses

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.