Method: courses.studentGroups.studentGroupMembers.delete
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Supprime un membre d'un groupe d'élèves.Cette méthode renvoie les codes d'erreur suivants :
PERMISSION_DENIED si l'utilisateur qui en fait la demande n'est pas autorisé à supprimer le membre du groupe d'élèves demandé ou en cas d'erreur d'accès.NOT_FOUND si le membre du groupe d'élèves n'existe pas ou si l'utilisateur n'a pas accès au groupe d'élèves.
Requête HTTP
DELETE https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers/{userId}
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
courseId |
string
Obligatoire. Identifiant du cours contenant le groupe d'élèves concerné.
|
studentGroupId |
string
Obligatoire. Identifiant du groupe d'élèves contenant le membre à supprimer.
|
userId |
string
Obligatoire. Identifiant du membre du groupe d'élèves à supprimer.
|
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 doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse est un objet JSON vide.
Niveaux d'accès 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.delete\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.\nDeletes a student group member.\n\n\u003cbr /\u003e\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to delete the requested student group member or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `NOT_FOUND` if the student group member does not exist or the user does not have access to the student group.\n\n### HTTP request\n\n`DELETE https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers/{userId}`\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 containing the relevant student group. |\n| `studentGroupId` | `string` Required. The identifier of the student group containing the student group member to delete. |\n| `userId` | `string` Required. The identifier of the student group member to delete. |\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 must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\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)."]]
