Crea un Registration
, lo que hace que Classroom comience a enviar notificaciones desde la feed
proporcionada al destino proporcionado en cloudPubSubTopic
.
Devuelve el Registration
creado. Actualmente, esto será lo mismo que el argumento, pero con los campos asignados por el servidor, como la hora de expiryTime
y la id
.
Tenga en cuenta que se ignorará cualquier valor especificado para los campos expiryTime
o id
.
Si bien Classroom puede validar cloudPubSubTopic
y devolver errores en la medida de lo posible, es responsabilidad de la persona que llama asegurarse de que exista y de que Classroom tenga permiso para publicarlo.
Este método puede devolver los siguientes códigos de error:
-
PERMISSION_DENIED
si:- el usuario autenticado no tiene permiso para recibir notificaciones del campo solicitado; o
- el usuario actual no ha otorgado acceso al proyecto de Cloud actual con el alcance adecuado para el feed solicitado. Tenga en cuenta que la delegación de autoridad en todo el dominio no se admite actualmente para este propósito. Si la solicitud tiene el alcance adecuado, pero no existe ninguna concesión, se devuelve un [Errores de solicitud][Error de
@MissingGrant
]. - se encuentra otro error de acceso .
-
INVALID_ARGUMENT
si:- no se especifica
cloudPubsubTopic
o elcloudPubsubTopic
especificado no es válido; o - no se especifica ningún
feed
o elfeed
especificado no es válido.
- no se especifica
-
NOT_FOUND
si:- no se puede localizar el
feed
especificado, o el usuario solicitante no tiene permiso para determinar si existe o no; o - no se puede ubicar el
cloudPubsubTopic
especificado o Classroom no tiene permiso para publicar en él.
- no se puede localizar el
Solicitud HTTP
POST https://classroom.googleapis.com/v1/registrations
La URL usa la sintaxis de transcodificación de gRPC .
cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Registration
.
Cuerpo de respuesta
Si tiene éxito, el cuerpo de la respuesta contiene una instancia de Registration
recién creada.
Ámbitos de autorización
Requiere el siguiente alcance de OAuth:
-
https://www.googleapis.com/auth/classroom.push-notifications
Para obtener más información, consulte la Descripción general de OAuth 2.0 .