Method: registrations.create

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

Devuelve el Registration creado. Actualmente, será igual 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 el cloudPubSubTopic y mostrar errores de la mejor manera posible, es responsabilidad del llamador 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 si ocurre lo siguiente:
  • 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 fin. Si la solicitud tiene el alcance adecuado, pero no existe una concesión, se muestra un [Request Errors][@MissingGrant error].
  • se produce otro error de acceso.
• INVALID_ARGUMENT si ocurre lo siguiente:
  • No se especifica cloudPubsubTopic o el cloudPubsubTopic especificado no es válido.
  • No se especifica feed o el feed especificado no es válido.
• NOT_FOUND si ocurre lo siguiente:
  • No se puede encontrar el feed especificado o el usuario solicitante no tiene permiso para determinar si existe o no.
  • No se puede encontrar el cloudPubsubTopic especificado o Classroom no tiene permiso para publicarlo.