Crea un Registration
, lo que hace que Classroom comience a enviar notificaciones del feed
proporcionado al destino proporcionado en cloudPubSubTopic
.
Muestra el Registration
creado. Actualmente, será el mismo que el argumento, pero con los campos asignados por el servidor, como expiryTime
y id
, completados.
Ten en cuenta que se ignorará cualquier valor especificado para los campos expiryTime
o id
.
Si bien Classroom puede validar cloudPubSubTopic
y mostrar errores en función del mejor esfuerzo, es responsabilidad del emisor garantizar que exista y 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 actual de Cloud con el permiso adecuado para el feed solicitado. Tenga en cuenta que, por el momento, no se admite la delegación de autoridad en todo el dominio. Si la solicitud tiene el alcance adecuado, pero no existe una concesión, se muestra un error [Request Errors][
@MissingGrant
]. - se encuentra 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 solicita no tiene permiso para determinar si existe o no - no se puede encontrar el
cloudPubsubTopic
especificado o Classroom no tiene permiso para publicarlo.
- 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 descripción general de OAuth 2.0.