REST Resource: registrations

Kaynak: Kayıt

Classroom'a, feed adresinden sağlanan hedefe bildirim göndermesi için verilen talimat.

JSON gösterimi
{
  "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.
}
Alanlar
registrationId

string

Bu Registration için sunucu tarafından oluşturulan benzersiz bir tanımlayıcıdır.

Salt okunur.

feed

object (Feed)

Classroom'un hedefe göndermesi gereken bildirim sınıfı için spesifikasyon.

expiryTime

string (Timestamp format)

Registration'ün geçerli olduğu zaman.

Bu, sunucu tarafından atanan salt okunur bir alandır.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Birlik alanı destination. Bildirimlerin gönderileceği hedef. destination yalnızca aşağıdakilerden biri olabilir:
cloudPubsubTopic

object (CloudPubsubTopic)

Bildirimlerin gönderileceği Cloud Pub/Sub konusu.

Feed

Bir uygulamanın kaydolarak alabileceği bildirim sınıfı. Örneğin: "bir alan için tüm liste değişiklikleri".

JSON gösterimi
{
  "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.
}
Alanlar
feedType

enum (FeedType)

Feed'in türü.

Birlik alanı info. Feed ile ilgili ek parametreler. info yalnızca aşağıdakilerden biri olabilir:
courseRosterChangesInfo

object (CourseRosterChangesInfo)

COURSE_ROSTER_CHANGES feedType değerine sahip bir Feed hakkında bilgi. feedType COURSE_ROSTER_CHANGES ise bu alan belirtilmelidir.

courseWorkChangesInfo

object (CourseWorkChangesInfo)

COURSE_WORK_CHANGES feedType değerine sahip bir Feed hakkında bilgi. feedType COURSE_WORK_CHANGES ise bu alan belirtilmelidir.

FeedType

Bir uygulamanın bildirim almak için kaydolabileceği feed türü.

Sıralamalar
FEED_TYPE_UNSPECIFIED Asla iade edilmemeli veya sağlanmamalıdır.
DOMAIN_ROSTER_CHANGES

Belirli bir alan için tüm liste değişiklikleri.

Bir kullanıcı bir kursa katıldığında veya kurstan ayrıldığında bildirim oluşturulur.

Davet oluşturulduğunda veya silindiğinde bildirim oluşturulmaz ancak kullanıcı bir daveti kabul ederek kursa katıldığında bildirim oluşturulur.

COURSE_ROSTER_CHANGES

Belirli bir kurstaki tüm liste değişiklikleri.

Bir kullanıcı bir kursa katıldığında veya kurstan ayrıldığında bildirim oluşturulur.

Davet oluşturulduğunda veya silindiğinde bildirim oluşturulmaz ancak kullanıcı bir daveti kabul ederek kursa katıldığında bildirim oluşturulur.

COURSE_WORK_CHANGES

Belirli bir kurstaki tüm sınıf çalışması etkinlikleri.

CourseWork veya StudentSubmission nesnesi oluşturulduğunda ya da değiştirildiğinde bildirim oluşturulur. Bir StudentSubmission nesnesi, üst öğesi olan CourseWork nesnesinin oluşturulması veya değiştirilmesiyle bağlantılı olarak oluşturulduğunda bildirim oluşturulmaz (ancak söz konusu CourseWork nesnesinin oluşturulması veya değiştirilmesiyle ilgili bildirim oluşturulur).

CourseRosterChangesInfo

COURSE_ROSTER_CHANGES feedType değerine sahip bir Feed hakkında bilgi.

JSON gösterimi
{
  "courseId": string
}
Alanlar
courseId

string

Liste değişikliklerine abone olmak için kullanılacak dersin courseId.

CourseWorkChangesInfo

COURSE_WORK_CHANGES feedType değerine sahip bir Feed hakkında bilgi.

JSON gösterimi
{
  "courseId": string
}
Alanlar
courseId

string

Abone olunacak kursun, iş değişikliklerine göre courseId.

CloudPubsubTopic

Cloud Pub/Sub konusuna referans.

Bildirimlere kaydolmak için konu sahibinin classroom-notifications@system.gserviceaccount.com'ye projects.topics.publish izni vermesi gerekir.

JSON gösterimi
{
  "topicName": string
}
Alanlar
topicName

string

Cloud Pub/Sub konusunun name alanı.

Yöntemler

create

Bir Registration oluşturur ve Classroom'ın, sağlanan feed adresinden cloudPubSubTopic adresine bildirim göndermeye başlamasına neden olur.

delete

Bir Registration silindiğinde Classroom bu Registration için bildirim göndermeyi durdurur.