Crée une invitation. Il ne peut exister qu'une seule invitation à la fois par utilisateur et par cours. Supprimez l'invitation, puis recréez-la pour effectuer 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 pasFAILED_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 avec des autorisations plus importantes.
- pour les erreurs de requête suivantes :
- IneligibleOwner
ALREADY_EXISTS
si une invitation existe déjà pour l'utilisateur et le cours spécifiés.
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 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 relatif aux autorisations.