Method: invitations.create

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 :
      • IneligibleOwner
  • 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.