REST Resource: registrations

리소스: 등록

feed에서 제공된 대상으로 알림을 보내도록 클래스룸에 안내합니다.

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.
}
필드
registrationId

string

Registration의 서버에서 생성된 고유 식별자입니다.

읽기 전용입니다.

feed

object (Feed)

클래스룸에서 대상에 전송해야 하는 알림 클래스의 사양입니다.

expiryTime

string (Timestamp format)

Registration가 적용되는 시간입니다.

서버에서 할당한 읽기 전용 입력란입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

통합 필드 destination. 알림을 전송할 위치입니다. destination은 다음 중 하나여야 합니다.
cloudPubsubTopic

object (CloudPubsubTopic)

알림을 받을 Cloud Pub/Sub 주제입니다.

피드

애플리케이션이 수신하도록 등록할 수 있는 알림 클래스. 예: '도메인의 모든 출석부 변경사항'.

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.
}
필드
feedType

enum (FeedType)

피드 유형입니다.

통합 필드 info. 피드에 대한 추가 매개변수입니다. info은 다음 중 하나여야 합니다.
courseRosterChangesInfo

object (CourseRosterChangesInfo)

feedTypeCOURSE_ROSTER_CHANGESFeed에 관한 정보입니다. feedTypeCOURSE_ROSTER_CHANGES이면 이 필드를 지정해야 합니다.

courseWorkChangesInfo

object (CourseWorkChangesInfo)

feedTypeCOURSE_WORK_CHANGESFeed에 관한 정보입니다. feedTypeCOURSE_WORK_CHANGES이면 이 필드를 지정해야 합니다.

FeedType

애플리케이션이 알림을 위해 등록할 수 있는 피드 유형입니다.

열거형
FEED_TYPE_UNSPECIFIED 반환되거나 제공되어서는 안 됩니다.
DOMAIN_ROSTER_CHANGES

특정 도메인의 모든 출석부 변경사항입니다.

사용자가 강의에 참여하거나 강의에서 나갈 때마다 알림이 생성됩니다.

초대를 만들거나 삭제할 때는 알림이 생성되지 않지만, 사용자가 초대를 수락하여 강의에 참여하면 알림이 생성됩니다.

COURSE_ROSTER_CHANGES

특정 과정의 모든 출석부 변경사항입니다.

사용자가 강의에 참여하거나 강의에서 나갈 때마다 알림이 생성됩니다.

초대를 만들거나 삭제할 때는 알림이 생성되지 않지만, 사용자가 초대를 수락하여 강의에 참여하면 알림이 생성됩니다.

COURSE_WORK_CHANGES

특정 코스의 모든 코스 활동 활동입니다.

CourseWork 또는 StudentSubmission 객체가 생성되거나 수정되면 알림이 생성됩니다. 상위 CourseWork 객체의 생성이나 수정과 관련하여 StudentSubmission 객체를 생성할 때 알림이 생성되지 않습니다. 하지만 해당 CourseWork 객체의 생성이나 수정에 관한 알림은 생성됩니다.

CourseRosterChangesInfo

feedTypeCOURSE_ROSTER_CHANGESFeed에 관한 정보입니다.

JSON 표현
{
  "courseId": string
}
필드
courseId

string

출석부 변경을 구독할 과정의 courseId입니다.

CourseWorkChangesInfo

feedTypeCOURSE_WORK_CHANGESFeed에 관한 정보입니다.

JSON 표현
{
  "courseId": string
}
필드
courseId

string

과제를 구독할 과정의 courseId입니다.

CloudPubsubTopic

Cloud Pub/Sub 주제에 대한 참조입니다.

알림을 등록하려면 주제 소유자가 classroom-notifications@system.gserviceaccount.comprojects.topics.publish 권한을 부여해야 합니다.

JSON 표현
{
  "topicName": string
}
필드
topicName

string

Cloud Pub/Sub 주제name 필드입니다.

방법

create

Registration를 생성하여 클래스룸이 제공된 feed에서 cloudPubSubTopic에 제공된 대상으로 알림을 전송하도록 합니다.

delete

Registration을(를) 삭제하여 클래스룸에서 해당 Registration에 대한 알림 전송을 중지합니다.