Method: courses.announcements.modifyAssignees

حالت واگذارنده و گزینه های یک اعلامیه را اصلاح می کند.

فقط معلم دوره ای که حاوی اعلامیه است می تواند این روش را فراخوانی کند.

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

  • PERMISSION_DENIED اگر کاربر درخواست کننده اجازه دسترسی به دوره یا کار دوره درخواستی یا خطاهای دسترسی را نداشته باشد.
  • اگر درخواست نادرست باشد INVALID_ARGUMENT .
  • اگر دوره یا کار دوره درخواستی وجود نداشته باشد، NOT_FOUND .

درخواست HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{id}:modifyAssignees

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

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

مولفه های
courseId

string

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

id

string

شناسه اعلامیه

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "assigneeMode": enum (AssigneeMode),
  "modifyIndividualStudentsOptions": {
    object (ModifyIndividualStudentsOptions)
  }
}
زمینه های
assigneeMode

enum ( AssigneeMode )

حالت اعلامیه که توضیح می‌دهد آیا برای همه دانش‌آموزان قابل دسترسی است یا دانش‌آموزان خاص.

modifyIndividualStudentsOptions

object ( ModifyIndividualStudentsOptions )

تعیین کنید که دانش‌آموزان می‌توانند اعلامیه را ببینند یا نتوانند. باید فقط زمانی مشخص شود که assigneeMode INDIVIDUAL_STUDENTS باشد.

بدن پاسخگو

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

محدوده مجوز

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

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

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