Method: courses.courseWork.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'un devoir.
Seul un enseignant du cours contenant le devoir 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}/courseWork/{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 du devoir.
|
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 du devoir indiquant s'il sera attribué à tous les élèves ou à des élèves spécifiques.
|
modifyIndividualStudentsOptions |
object (ModifyIndividualStudentsOptions)
Définissez les élèves auxquels le cours est attribué ou non. 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 CourseWork.
Niveaux d'accès des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/classroom.coursework.students
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 a coursework.\n\nOnly a teacher of the course that contains the coursework 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}/courseWork/{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 coursework. |\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 coursework describing whether it will be assigned to all students or specified individual students. |\n| `modifyIndividualStudentsOptions` | `object (`[ModifyIndividualStudentsOptions](/workspace/classroom/reference/rest/v1/ModifyIndividualStudentsOptions)`)` Set which students are assigned or not assigned to the coursework. Must be specified only when `assigneeMode` is `INDIVIDUAL_STUDENTS`. |\n\nResponse body\n\nIf successful, the response body contains an instance of [CourseWork](/workspace/classroom/reference/rest/v1/courses.courseWork#CourseWork).\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.coursework.students`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
