Method: registrations.create

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 el cloudPubsubTopic especificado no es válido.
    • no se especificó ningún feed o el feed especificado no es válido.
  • 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.

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.