REST Resource: registrations

Ressource: Enregistrement

Instruction à Classroom d'envoyer des notifications depuis le feed à la destination indiquée.

Représentation JSON 
{
  "registrationId": string,
  "feed": {
    object (Feed)
  },
  "expiryTime": string,

  // Union field destination can be only one of the following:
  "cloudPubsubTopic": {
    object (CloudPubsubTopic)
  }
  // End of list of possible types for union field destination.
}
Champs
registrationId

string

Identifiant unique généré par le serveur pour cet élément Registration.

Lecture seule.
feed

object (Feed)

Spécification de la classe de notifications que Classroom doit envoyer à la destination.
expiryTime

string (Timestamp format)

Date à laquelle l'Registration est valide.

Il s'agit d'un champ en lecture seule attribué par le serveur.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
Champ d'union destination. Où envoyer les notifications destination ne peut être qu'un des éléments suivants :
cloudPubsubTopic

object (CloudPubsubTopic)

Le sujet Cloud Pub/Sub auquel les notifications doivent être envoyées.

Flux

Classe de notifications qu'une application peut s'inscrire pour recevoir. Par exemple: "Toutes les modifications de la liste de joueurs pour un domaine".

Représentation JSON 
{
  "feedType": enum (FeedType),

  // Union field info can be only one of the following:
  "courseRosterChangesInfo": {
    object (CourseRosterChangesInfo)
  },
  "courseWorkChangesInfo": {
    object (CourseWorkChangesInfo)
  }
  // End of list of possible types for union field info.
}
Champs
feedType

enum (FeedType)

Type de flux.
Champ d'union info. Paramètres supplémentaires concernant le flux. info ne peut être qu'un des éléments suivants :
courseRosterChangesInfo

object (CourseRosterChangesInfo)

Informations sur un Feed avec un feedType de COURSE_ROSTER_CHANGES. Ce champ doit être spécifié si feedType est COURSE_ROSTER_CHANGES.
courseWorkChangesInfo

object (CourseWorkChangesInfo)

Informations sur un Feed avec un feedType de COURSE_WORK_CHANGES. Ce champ doit être spécifié si feedType est COURSE_WORK_CHANGES.

FeedType

Type de flux à partir duquel une application peut s'inscrire pour recevoir des notifications.

Enums
FEED_TYPE_UNSPECIFIED Ne doit jamais être renvoyé ni fourni.
DOMAIN_ROSTER_CHANGES

Toutes les modifications apportées à la liste des participants pour un domaine donné.

Des notifications sont générées chaque fois qu'un utilisateur rejoint ou quitte un cours.

Aucune notification n'est générée lorsqu'une invitation est créée ou supprimée, mais une notification est générée lorsqu'un utilisateur rejoint un cours en acceptant une invitation.
COURSE_ROSTER_CHANGES

Toutes les modifications apportées à la liste des participants d'un cours donné.

Des notifications sont générées chaque fois qu'un utilisateur rejoint ou quitte un cours.

Aucune notification n'est générée lorsqu'une invitation est créée ou supprimée, mais une notification est générée lorsqu'un utilisateur rejoint un cours en acceptant une invitation.
COURSE_WORK_CHANGES

Toutes les activités de travail du cours pour un cours donné.

Des notifications sont générées lorsqu'un objet CourseWork ou StudentSubmission est créé ou modifié. Aucune notification n'est générée lorsqu'un objet "StudentSubmission" est créé en lien avec la création ou la modification de son objet parent "CourseWork" (mais une notification est générée pour la création ou la modification de cet objet "CourseWork").

CourseRosterChangesInfo

Informations sur un Feed avec un feedType de COURSE_ROSTER_CHANGES.

Représentation JSON 
{
  "courseId": string
}
Champs
courseId

string

courseId du cours pour lequel vous souhaitez vous abonner aux modifications de la liste des participants.

CourseWorkChangesInfo

Informations sur un Feed avec un feedType de COURSE_WORK_CHANGES.

Représentation JSON 
{
  "courseId": string
}
Champs
courseId

string

courseId du cours auquel vous souhaitez vous abonner pour recevoir des notifications de modifications.

CloudPubsubTopic

Référence à un sujet Cloud Pub/Sub.

Pour s'inscrire aux notifications, le propriétaire du sujet doit accorder à classroom-notifications@system.gserviceaccount.com l'autorisation projects.topics.publish.

Représentation JSON 
{
  "topicName": string
}
Champs
topicName

string

Champ name d'un sujet Cloud Pub/Sub.

Méthodes

create

 Crée un Registration, ce qui permet à Classroom de commencer à envoyer des notifications à partir du feed fourni vers la destination indiquée dans cloudPubSubTopic.

delete

 Supprime un Registration, ce qui empêche Classroom d'envoyer des notifications pour ce Registration.