- Zasób: rejestracja
- Plik danych
- FeedType
- CourseRosterChangesInfo
- CourseWorkChangesInfo
- CloudPubsubTopic
- Metody
Zasób: rejestracja
Instrukcja wysyłania do Classroom powiadomień z urządzenia feed
do wskazanego miejsca docelowego.
Zapis JSON |
---|
{ "registrationId": string, "feed": { object ( |
Pola | |
---|---|
registrationId |
Wygenerowany przez serwer unikalny identyfikator elementu Tylko do odczytu. |
feed |
Specyfikacja klasy powiadomień, które Classroom ma dostarczać do miejsca docelowego. |
expiryTime |
Czas, do którego obowiązuje zasada To pole jest tylko do odczytu przypisane przez serwer. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
Pole sumy destination . Dokąd mają być wysyłane powiadomienia. destination może mieć tylko jedną z tych wartości: |
|
cloudPubsubTopic |
Temat Cloud Pub/Sub, do którego mają być wysyłane powiadomienia. |
Kanał
Klasa powiadomień, które aplikacja może zarejestrować, aby je otrzymywać. Na przykład: „wszystkie zmiany na liście uczniów w domenie”.
Zapis JSON |
---|
{ "feedType": enum ( |
Pola | |
---|---|
feedType |
Typ pliku danych. |
Pole sumy info . Dodatkowe parametry pliku danych. info może mieć tylko jedną z tych wartości: |
|
courseRosterChangesInfo |
Informacje o: |
courseWorkChangesInfo |
Informacje o: |
FeedType
Rodzaj kanału, z którego aplikacja może zarejestrować powiadomienia.
Wartości w polu enum | |
---|---|
FEED_TYPE_UNSPECIFIED |
Nigdy nie należy go zwracać ani podawać. |
DOMAIN_ROSTER_CHANGES |
Wszystkie zmiany listy uczniów w danej domenie. Powiadomienia będą wysyłane za każdym razem, gdy użytkownik dołączy do zajęć lub go opuści. Po utworzeniu lub usunięciu zaproszenia nie będą generowane żadne powiadomienia, ale gdy użytkownik dołączy do zajęć przez zaakceptowanie zaproszenia. |
COURSE_ROSTER_CHANGES |
Wszystkie zmiany w liście uczniów dotyczące konkretnych zajęć. Powiadomienia będą wysyłane za każdym razem, gdy użytkownik dołączy do zajęć lub go opuści. Po utworzeniu lub usunięciu zaproszenia nie będą generowane żadne powiadomienia, ale gdy użytkownik dołączy do zajęć przez zaakceptowanie zaproszenia. |
COURSE_WORK_CHANGES |
Wszystkie zadania związane z konkretnym kursem. Powiadomienia będą generowane po utworzeniu lub zmodyfikowaniu obiektu CourseWork lub StudentSubmission. Nie zostanie wygenerowane żadne powiadomienie, gdy zostanie utworzony obiekt StudentSubmission związany z utworzeniem lub modyfikacją nadrzędnego obiektu CourseWork (ale zostanie wygenerowane powiadomienie o utworzeniu lub modyfikacji obiektu CourseWork). |
CourseRosterChangesInfo
Informacje o: Feed
z feedType
o wartości COURSE_ROSTER_CHANGES
.
Zapis JSON |
---|
{ "courseId": string } |
Pola | |
---|---|
courseId |
|
CourseWorkChangesInfo
Informacje o: Feed
z feedType
o wartości COURSE_WORK_CHANGES
.
Zapis JSON |
---|
{ "courseId": string } |
Pola | |
---|---|
courseId |
|
CloudPubsubTopic
Odwołanie do tematu Cloud Pub/Sub.
Aby można było zarejestrować się w celu otrzymywania powiadomień, właściciel tematu musi przyznać użytkownikowi classroom-notifications@system.gserviceaccount.com
uprawnienie projects.topics.publish
.
Zapis JSON |
---|
{ "topicName": string } |
Pola | |
---|---|
topicName |
Pole |
Metody |
|
---|---|
|
Tworzy Registration , przez co Classroom zaczyna wysyłać powiadomienia z podanego feed do miejsca docelowego w cloudPubSubTopic . |
|
Usuwa Registration , przez co Classroom przestanie wysyłać powiadomienia dotyczące tego urządzenia (Registration ). |