Method: invitations.create
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée une invitation. Une seule invitation peut exister à la fois pour un utilisateur et un cours. Supprimez une invitation et recréez-la pour apporter des modifications.
Cette méthode renvoie les codes d'erreur suivants:
PERMISSION_DENIED si l'utilisateur à l'origine de la demande n'est pas autorisé à créer des invitations pour ce cours ou en cas d'erreurs d'accès.NOT_FOUND si le cours ou l'utilisateur n'existe pas.FAILED_PRECONDITION :
- si le compte de l'utilisateur demandé est désactivé.
- si l'utilisateur dispose déjà de ce rôle ou d'un rôle disposant d'autorisations plus élevées.
- pour les erreurs de requête suivantes :
ALREADY_EXISTS si une invitation pour l'utilisateur et le cours spécifiés existe déjà.
Requête HTTP
POST https://classroom.googleapis.com/v1/invitations
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient une instance de Invitation.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Invitation.
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/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[],[],null,["# Method: invitations.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an invitation. Only one invitation for a user and course may exist at a time. Delete and re-create an invitation to make changes.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to create invitations for this course or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `NOT_FOUND` if the course or the user does not exist.\n- `FAILED_PRECONDITION`:\n - if the requested user's account is disabled.\n - if the user already has this role or a role with greater permissions.\n - for the following [request errors](/workspace/classroom/reference/Request.Errors):\n - IneligibleOwner\n- `ALREADY_EXISTS` if an invitation for the specified user and course already exists.\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/invitations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains an instance of [Invitation](/workspace/classroom/reference/rest/v1/invitations#Invitation).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Invitation](/workspace/classroom/reference/rest/v1/invitations#Invitation).\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)."]]
