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_DENIEDsi 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_FOUNDsi 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 :
- IneligibleOwner
ALREADY_EXISTSsi 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.