Crea un Registration
, lo que hace que Classroom comience a enviar notificaciones de la feed
proporcionada al destino proporcionado en cloudPubSubTopic
.
Muestra el Registration
creado. Por el momento, este será el mismo que el argumento, pero con campos asignados por el servidor, como expiryTime
y id
.
Ten en cuenta que se ignorará cualquier valor especificado para los campos expiryTime
o id
.
Si bien Classroom puede validar los cloudPubSubTopic
y mostrar errores de la mejor manera posible, es responsabilidad del emisor asegurarse de que exista y de que Classroom tenga permiso para publicarlo.
Este método puede mostrar los siguientes códigos de error:
PERMISSION_DENIED
en los siguientes casos:- El usuario autenticado no tiene permiso para recibir notificaciones del campo solicitado.
- El usuario actual no otorgó acceso al proyecto de Cloud actual con el permiso adecuado para el feed solicitado. Tenga en cuenta que, por el momento, no se admite la delegación de autoridad de todo el dominio. Si la solicitud tiene el alcance adecuado, pero no existe ningún otorgamiento, se mostrará un error [Request errors][
@MissingGrant
error]. - otro error de acceso.
INVALID_ARGUMENT
en los siguientes casos:- No se especificó ningún
cloudPubsubTopic
o elcloudPubsubTopic
especificado no es válido. - no se especificó ningún
feed
o elfeed
especificado no es válido.
- No se especificó ningún
NOT_FOUND
en los siguientes casos:- no se puede ubicar el
feed
especificado o el usuario que lo solicitó no tiene permiso para determinar si existe o no - no se puede encontrar el
cloudPubsubTopic
especificado o Classroom no tiene permiso para publicar en él.
- no se puede ubicar el
Solicitud HTTP
POST https://classroom.googleapis.com/v1/registrations
La URL usa la sintaxis de la transcodificación gRPC.
Cuerpo de la solicitud
El cuerpo de la solicitud incluye una instancia de Registration
.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Registration
.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/classroom.push-notifications
Para obtener más información, consulta la Guía de autorización.