Method: courses.courseWork.patch

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

برای اطلاع از جزئیات مربوط به اینکه کدام فیلدها ممکن است به روز شوند و چه کسی ممکن است آنها را تغییر دهد، به google.classroom.v1.CourseWork مراجعه کنید.

این درخواست باید توسط پروژه Developer Console از شناسه مشتری OAuth که برای ایجاد مورد کار دوره مربوطه استفاده می‌شود، انجام شود.

این روش کدهای خطای زیر را برمی گرداند:

  • PERMISSION_DENIED اگر پروژه برنامه‌نویس درخواست‌کننده کار دوره مربوطه را ایجاد نکرده باشد، اگر کاربر اجازه نداشته باشد اصلاحات درخواستی را در ارسال دانشجو انجام دهد، یا برای خطاهای دسترسی .
  • اگر درخواست نادرست باشد INVALID_ARGUMENT .
  • اگر کار دوره درخواستی قبلاً حذف شده باشد، FAILED_PRECONDITION .
  • اگر دوره یا کار دوره درخواستی وجود نداشته باشد، NOT_FOUND .

درخواست HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}

URL از دستور GRPC Transcoding استفاده می کند.

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

مولفه های
courseId

string

شناسه دوره این شناسه می تواند شناسه اختصاص داده شده توسط Classroom یا alias باشد.

id

string

شناسه کار دوره.

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

مولفه های
updateMask

string ( FieldMask format)

ماسکی که مشخص می کند کدام فیلدها در دوره کار می کنند تا به روز شوند. این فیلد برای انجام به روز رسانی لازم است. اگر فیلدهای نامعتبر مشخص شوند، به روز رسانی انجام نمی شود. اگر یک فیلد از مقادیر خالی پشتیبانی می کند، می توان آن را با مشخص کردن آن در ماسک به روز رسانی و نه در شی CourseWork پاک کرد. اگر فیلدی که مقادیر خالی را پشتیبانی نمی کند در ماسک به روز رسانی گنجانده شود و در شی CourseWork تنظیم نشده باشد، یک خطای INVALID_ARGUMENT برگردانده می شود.

فیلدهای زیر ممکن است توسط معلمان مشخص شود:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId در V1_20240401_PREVIEW و نسخه های جدیدتر موجود است.

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

previewVersion

enum ( PreviewVersion )

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

درخواست بدن

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

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از CourseWork است.

محدوده مجوز

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

  • https://www.googleapis.com/auth/classroom.coursework.students

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