Method: registrations.create

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

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

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

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