REST Resource: registrations

Ressource : Registration

Instruction envoyée à Classroom pour envoyer des notifications depuis le feed vers la destination fournie.

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

Lecture seule.
feed

object (Feed)

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

string (Timestamp format)

Heure jusqu'à laquelle le Registration est effectif.

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 utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) 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ù les notifications doivent être envoyées. destination ne peut être qu'un des éléments suivants :
cloudPubsubTopic

object (CloudPubsubTopic)

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

Flux

Classe de notifications auxquelles une application peut s'inscrire pour les recevoir. Par exemple : "toutes les modifications apportées à la liste d'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 défini sur 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 défini sur COURSE_WORK_CHANGES.

FeedType

Type de flux pour lequel 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 membres d'un domaine spécifique.

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 des notifications sont générées lorsqu'un utilisateur rejoint un cours en acceptant une invitation.
COURSE_ROSTER_CHANGES

Toutes les modifications apportées à la liste des élèves d'un cours spécifique.

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 des notifications sont générées lorsqu'un utilisateur rejoint un cours en acceptant une invitation.
COURSE_WORK_CHANGES

Toutes les activités de cours pour un cours spécifique.

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 CourseWork parent (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 s'abonner aux modifications de la liste.

CourseWorkChangesInfo

Informations sur un Feed avec un feedType de COURSE_WORK_CHANGES.

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

string

courseId du cours pour lequel s'abonner aux modifications des devoirs.

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.