Method: registrations.create

Crea un Registration, lo que hace que Classroom comience a enviar notificaciones desde el feed proporcionado al destino proporcionado en cloudPubSubTopic.

Muestra el Registration creado. Actualmente, será lo 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 la cloudPubSubTopic y mostrar errores según el criterio del mejor esfuerzo, es responsabilidad de la persona que llama asegurarse de que exista y de que Classroom tenga permiso para publicar en ella.

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. Ten en cuenta que, por el momento, no se admite la delegación de autoridad en todo el dominio para este propósito. Si la solicitud tiene el alcance adecuado, pero no existe un otorgamiento, se muestra [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 encontrar el feed especificado o el usuario que realiza la solicitud no tiene permiso para determinar si existe o no.
    • no se puede ubicar la cloudPubsubTopic especificada, o bien Classroom no tiene permiso para publicar en ella.

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.