- Ressource: Registrierung
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Feed
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FeedType
- CourseRosterChangesInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- CourseWorkChangesInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- CloudPubsubTopic
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Methoden
Ressource: Registrierung
Eine Anleitung für Classroom, wie Benachrichtigungen von der feed
an das angegebene Ziel gesendet werden.
JSON-Darstellung |
---|
{ "registrationId": string, "feed": { object ( |
Felder | |
---|---|
registrationId |
Eine vom Server generierte eindeutige Kennung für diese Schreibgeschützt. |
feed |
Spezifikation für den Kurs der Benachrichtigungen, die Classroom an das Ziel senden soll. |
expiryTime |
Der Zeitpunkt, bis zu dem die Dieses schreibgeschützte Feld wird vom Server zugewiesen. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
Union-Feld destination . An wen Benachrichtigungen gesendet werden sollen Für destination ist nur einer der folgenden Werte zulässig: |
|
cloudPubsubTopic |
Das Cloud Pub/Sub-Thema, an das Benachrichtigungen gesendet werden sollen. |
Feed
Eine Klasse von Benachrichtigungen, die eine Anwendung für den Empfang registrieren kann. Beispiel: „Alle Teilnehmerlistenänderungen für eine Domain“.
JSON-Darstellung |
---|
{ "feedType": enum ( |
Felder | |
---|---|
feedType |
Der Typ des Feeds. |
Union-Feld info . Zusätzliche Parameter für den Feed. Für info ist nur einer der folgenden Werte zulässig: |
|
courseRosterChangesInfo |
Informationen zu |
courseWorkChangesInfo |
Informationen zu |
FeedType
Ein Feedtyp, den eine App für Benachrichtigungen registrieren kann.
Enums | |
---|---|
FEED_TYPE_UNSPECIFIED |
Sollte nie zurückgegeben oder bereitgestellt werden. |
DOMAIN_ROSTER_CHANGES |
Alle Änderungen der Teilnehmerliste für eine bestimmte Domain. Benachrichtigungen werden generiert, wenn ein Nutzer einem Kurs beitritt oder ihn verlässt. Es werden keine Benachrichtigungen generiert, wenn eine Einladung erstellt oder gelöscht wird. Benachrichtigungen werden jedoch generiert, wenn ein Nutzer eine Einladung annimmt und einem Kurs beitritt. |
COURSE_ROSTER_CHANGES |
Alle Teilnehmerlisten für einen bestimmten Kurs werden geändert. Benachrichtigungen werden generiert, wenn ein Nutzer einem Kurs beitritt oder ihn verlässt. Es werden keine Benachrichtigungen generiert, wenn eine Einladung erstellt oder gelöscht wird. Benachrichtigungen werden jedoch generiert, wenn ein Nutzer eine Einladung annimmt und einem Kurs beitritt. |
COURSE_WORK_CHANGES |
Alle Kursaktivitäten für einen bestimmten Kurs. Benachrichtigungen werden generiert, wenn ein CourseWork- oder StudentSubmission-Objekt erstellt oder geändert wird. Es wird keine Benachrichtigung generiert, wenn ein StudentSubmission-Objekt in Verbindung mit der Erstellung oder Änderung des übergeordneten CourseWork-Objekts erstellt wird. Es wird jedoch eine Benachrichtigung für die Erstellung oder Änderung dieses KursWork-Objekts generiert. |
CourseRosterChangesInfo
Informationen zu Feed
mit einem feedType
von COURSE_ROSTER_CHANGES
.
JSON-Darstellung |
---|
{ "courseId": string } |
Felder | |
---|---|
courseId |
Die |
CourseWorkChangesInfo
Informationen zu Feed
mit einem feedType
von COURSE_WORK_CHANGES
.
JSON-Darstellung |
---|
{ "courseId": string } |
Felder | |
---|---|
courseId |
Die |
CloudPubsubTopic
Ein Verweis auf ein Cloud Pub/Sub-Thema.
Um sich für Benachrichtigungen zu registrieren, muss der Inhaber des Themas classroom-notifications@system.gserviceaccount.com
die Berechtigung projects.topics.publish
erteilen.
JSON-Darstellung |
---|
{ "topicName": string } |
Felder | |
---|---|
topicName |
Das Feld |
Methoden |
|
---|---|
|
Erstellt eine Registration , wodurch Classroom beginnt, Benachrichtigungen von der angegebenen feed an das in cloudPubSubTopic angegebene Ziel zu senden. |
|
Ein Registration wird gelöscht. Classroom sendet dann keine Benachrichtigungen mehr für diese Registration . |