Registration
를 생성하여 클래스룸이 제공된 feed
에서 cloudPubSubTopic
에 제공된 대상으로 알림을 전송하도록 합니다.
생성된 Registration
를 반환합니다. 현재 이 인수는 인수와 동일하지만 expiryTime
및 id
같은 서버 할당 필드가 채워집니다.
expiryTime
또는 id
필드에 지정된 값은 무시됩니다.
클래스룸에서 최선을 다해 cloudPubSubTopic
를 검증하고 오류를 반환할 수 있지만, 이것이 존재하고 클래스룸에 게시 권한이 있는지 확인하는 것은 호출자의 책임입니다.
이 메서드는 다음과 같은 오류 코드를 반환할 수도 있습니다.
PERMISSION_DENIED
인 경우:- 인증된 사용자에게 요청된 필드에서 알림을 수신할 권한이 없는 경우
- 현재 사용자가 요청된 피드에 적절한 범위의 현재 Cloud 프로젝트에 대한 액세스 권한을 부여하지 않았습니다. 이 경우에는 현재 도메인 전체 권한 위임이 지원되지 않습니다. 요청에 적절한 범위가 있지만 권한 부여가 없으면 [요청 오류][
@MissingGrant
오류] 가 반환됩니다. - 다른 액세스 오류가 발생합니다.
INVALID_ARGUMENT
인 경우:- 지정된
cloudPubsubTopic
이 없거나 지정된cloudPubsubTopic
이(가) 유효하지 않습니다. feed
이(가) 지정되지 않았거나 지정된feed
이(가) 잘못되었습니다.
- 지정된
NOT_FOUND
인 경우:- 지정된
feed
를 찾을 수 없거나 요청하는 사용자에게 이 객체가 있는지 확인할 권한이 없는 경우 - 지정된
cloudPubsubTopic
을(를) 찾을 수 없거나 클래스룸에 게시 권한이 부여되지 않았습니다.
- 지정된
HTTP 요청
POST https://classroom.googleapis.com/v1/registrations
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 Registration
의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 Registration
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/classroom.push-notifications
자세한 내용은 승인 가이드를 참고하세요.