Method: invitations.create

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 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 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.