Method: courses.announcements.modifyAssignees
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Modifie le mode et les options d'attribution d'une annonce.
Seul un enseignant du cours contenant l'annonce peut appeler cette méthode.
Cette méthode renvoie les codes d'erreur suivants :
PERMISSION_DENIED si l'utilisateur qui envoie la demande n'est pas autorisé à accéder au cours ou au devoir demandé, ou en cas d'erreur d'accès.INVALID_ARGUMENT si la requête est mal formulée.NOT_FOUND si le cours ou le devoir demandé n'existe pas.FAILED_PRECONDITION pour l'erreur de requête suivante :
Requête HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{id}:modifyAssignees
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
courseId |
string
Identifiant du cours. Cet identifiant peut être celui attribué par Classroom ou un alias.
|
id |
string
Identifiant de l'annonce.
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Champs |
assigneeMode |
enum (AssigneeMode)
Mode de l'annonce indiquant si elle est accessible à tous les élèves ou à certains élèves.
|
modifyIndividualStudentsOptions |
object (ModifyIndividualStudentsOptions)
Définissez les élèves qui peuvent ou ne peuvent pas voir l'annonce. Doit être spécifié uniquement lorsque assigneeMode est défini sur INDIVIDUAL_STUDENTS.
|
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de Announcement.
Niveaux d'accès des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/classroom.announcements
Pour en savoir plus, consultez le guide d'autorisation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/26 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
