REST Resource: invitations

Ressource: Invitation

Invitation à rejoindre un cours.

Représentation JSON
{
  "id": string,
  "userId": string,
  "courseId": string,
  "role": enum (CourseRole)
}
Champs
id

string

Identifiant attribué par Classroom.

En lecture seule.

userId

string

Identifiant de l'utilisateur invité.

Lorsqu'il est spécifié en tant que paramètre d'une requête, cet identifiant peut être défini sur l'un des éléments suivants:

  • l'identifiant numérique de l'utilisateur
  • L'adresse e-mail de l'utilisateur
  • Le littéral de chaîne "me", indiquant l'utilisateur demandeur
courseId

string

Identifiant du cours auquel inviter l'utilisateur.

role

enum (CourseRole)

Rôle à inviter l'utilisateur. Ne doit pas être COURSE_ROLE_UNSPECIFIED.

CourseRole

Rôles pouvant être attribués à un utilisateur.

Enums
COURSE_ROLE_UNSPECIFIED Aucun rôle dans le cours.
STUDENT Étudiant(e) du cours.
TEACHER Enseignante du cours
OWNER Propriétaire du cours.

Méthodes

accept

Accepte une invitation, la supprime et ajoute l'utilisateur invité aux enseignants ou aux élèves (le cas échéant) du cours spécifié.

create

Crée une invitation.

delete

Supprime une invitation.

get

Renvoie une invitation.

list

Renvoie une liste des invitations que l'utilisateur à l'origine de la demande est autorisé à consulter, limitées à celles qui correspondent à la requête de liste.