Add-on Google Classroom kini tersedia secara umum untuk developer. Lihat
dokumentasi add-on untuk informasi selengkapnya.
Method: courses.announcements.modifyAssignees
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mengubah mode dan opsi penerima tugas pengumuman.
Hanya pengajar kursus yang berisi pengumuman yang dapat memanggil metode ini.
Metode ini menampilkan kode error berikut:
PERMISSION_DENIED
jika pengguna yang meminta tidak diizinkan mengakses kursus atau tugas kursus yang diminta atau untuk error akses.
INVALID_ARGUMENT
jika format permintaan salah.
NOT_FOUND
jika kursus atau tugas kursus yang diminta tidak ada.
FAILED_PRECONDITION
untuk kesalahan permintaan berikut:
Permintaan HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{id}:modifyAssignees
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter |
courseId |
string
ID kursus. ID ini dapat berupa ID yang ditetapkan Classroom atau alias .
|
id |
string
ID pengumuman.
|
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Kolom |
assigneeMode |
enum (AssigneeMode )
Mode pengumuman yang menjelaskan apakah pengumuman dapat diakses oleh semua siswa atau siswa tertentu.
|
modifyIndividualStudentsOptions |
object (ModifyIndividualStudentsOptions )
Tetapkan siswa yang dapat atau tidak dapat melihat pengumuman. Hanya boleh ditentukan jika assigneeMode adalah INDIVIDUAL_STUDENTS .
|
Isi respons
Jika berhasil, isi respons memuat instance Announcement
.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/classroom.announcements
Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-26 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-26 UTC."],[],[],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nModifies assignee mode and options of an announcement.\n\nOnly a teacher of the course that contains the announcement may call this method.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or course work or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course or course work does not exist.\n- `FAILED_PRECONDITION` for the following [request error](/workspace/classroom/reference/Request.Errors):\n - EmptyAssignees\n\nHTTP request\n\n`POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{id}:modifyAssignees`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course. This identifier can be either the Classroom-assigned identifier or an [alias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias). |\n| `id` | `string` Identifier of the announcement. |\n\nRequest body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"assigneeMode\": enum (/workspace/classroom/reference/rest/v1/AssigneeMode), \"modifyIndividualStudentsOptions\": { object (/workspace/classroom/reference/rest/v1/ModifyIndividualStudentsOptions) } } ``` |\n\n| Fields ||\n|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `assigneeMode` | `enum (`[AssigneeMode](/workspace/classroom/reference/rest/v1/AssigneeMode)`)` Mode of the announcement describing whether it is accessible by all students or specified individual students. |\n| `modifyIndividualStudentsOptions` | `object (`[ModifyIndividualStudentsOptions](/workspace/classroom/reference/rest/v1/ModifyIndividualStudentsOptions)`)` Set which students can view or cannot view the announcement. Must be specified only when `assigneeMode` is `INDIVIDUAL_STUDENTS`. |\n\nResponse body\n\nIf successful, the response body contains an instance of [Announcement](/workspace/classroom/reference/rest/v1/courses.announcements#Announcement).\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.announcements`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]