Method: courses.courseWorkMaterials.patch

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

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

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

درخواست HTTP

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

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

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

مولفه های
courseId

string

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

id

string

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

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

مولفه های
updateMask

string ( FieldMask format)

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

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

  • title
  • description
  • state
  • scheduledTime
  • topicId

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

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

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

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