Method: courses.studentGroups.studentGroupMembers.create
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée un membre de groupe d'élèves pour un groupe d'élèves.Cette méthode renvoie les codes d'erreur suivants :
PERMISSION_DENIED si l'utilisateur qui envoie la demande n'est pas autorisé à créer le groupe d'élèves ou le membre pour les erreurs d'accès.NOT_FOUND si le groupe d'élèves n'existe pas ou si l'utilisateur n'y a pas accès.ALREADY_EXISTS si le membre du groupe d'élèves existe déjà.FAILED_PRECONDITION si vous essayez d'ajouter un membre à un groupe d'élèves qui a atteint sa limite de membres.
Requête HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
courseId |
string
Obligatoire. Identifiant du cours.
|
studentGroupId |
string
Obligatoire. Identifiant du groupe d'élèves.
|
Paramètres de requête
| Paramètres |
previewVersion |
enum (PreviewVersion)
Facultatif. Version preview de l'API. Ce paramètre doit être défini pour accéder aux nouvelles fonctionnalités d'API mises à la disposition des développeurs dans le programme Preview.
|
Corps de la requête
Le corps de la requête contient une instance de StudentGroupMember.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de StudentGroupMember.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/classroom.rosters
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/08 (UTC).
[null,null,["Dernière mise à jour le 2025/08/08 (UTC)."],[],[],null,["# Method: courses.studentGroups.studentGroupMembers.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\n\u003cbr /\u003e\n\n| **Developer Preview:** Available as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), which grants early access to certain features. This feature is available in [V1_20250630_PREVIEW](https://developers.google.com/workspace/classroom/reference/rest/v1/PreviewVersion) and later. See [Access Preview APIs](https://developers.google.com/workspace/classroom/reference/preview) to learn more.\nCreates a student group member for a student group.\n\n\u003cbr /\u003e\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to create the student group or member for [access errors](/workspace/classroom/reference/Access.Errors).\n- `NOT_FOUND` if the student group does not exist or the user does not have access to the student group.\n- `ALREADY_EXISTS` if the student group member already exists.\n- `FAILED_PRECONDITION` if attempting to add a member to a student group that has reached its member limit.\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------------|---------------------------------------------------------|\n| `courseId` | `string` Required. The identifier of the course. |\n| `studentGroupId` | `string` Required. The identifier of the student group. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Optional. The preview version of the API. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Request body\n\nThe request body contains an instance of [StudentGroupMember](/workspace/classroom/reference/rest/v1/courses.studentGroups.studentGroupMembers#StudentGroupMember).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [StudentGroupMember](/workspace/classroom/reference/rest/v1/courses.studentGroups.studentGroupMembers#StudentGroupMember).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.rosters`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
