Method: registrations.create

Registration를 만들어 클래스룸에서 제공된 feed에서 cloudPubSubTopic에 제공된 대상에 알림을 보내기 시작합니다.

생성된 Registration를 반환합니다. 현재는 인수와 동일하지만 expiryTime 및 id와 같은 서버 할당 필드가 채워집니다.

expiryTime 또는 id 필드에 지정된 값은 무시됩니다.

클래스룸은 cloudPubSubTopic의 유효성을 검사하고 최선의 방식으로 오류를 반환할 수 있지만, cloudPubSubTopic가 존재하고 클래스룸에 게시할 권한이 있는지 확인하는 것은 호출자의 책임입니다.

이 메서드는 다음과 같은 오류 코드를 반환할 수 있습니다.

  • 다음에 해당하는 경우 PERMISSION_DENIED
    • 인증된 사용자에게 요청된 필드에서 알림을 받을 권한이 없습니다.
    • 현재 사용자가 요청된 피드에 적절한 범위로 현재 Cloud 프로젝트에 대한 액세스 권한을 부여하지 않았습니다. 현재 이 목적으로 도메인 전체 권한 위임은 지원되지 않습니다. 요청에 적절한 범위가 있지만 부여가 없는 경우 [요청 오류][@MissingGrant 오류] 가 반환됩니다.
    • 다른 액세스 오류가 발생합니다.
  • 다음에 해당하는 경우 INVALID_ARGUMENT
    • 지정된 cloudPubsubTopic가 없거나 지정된 cloudPubsubTopic가 유효하지 않음
    • 지정된 feed가 없거나 지정된 feed가 유효하지 않습니다.
  • 다음에 해당하는 경우 NOT_FOUND
    • 지정된 feed를 찾을 수 없거나 요청하는 사용자에게 feed의 존재 여부를 확인할 권한이 없습니다.
    • 지정된 cloudPubsubTopic를 찾을 수 없거나 클래스룸에 게시할 권한이 부여되지 않았습니다.

HTTP 요청

POST https://classroom.googleapis.com/v1/registrations

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에 Registration의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 Registration의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/classroom.push-notifications

자세한 내용은 승인 가이드를 참고하세요.