Method: registrations.create

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 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 solicita no tiene permiso para determinar si existe o no
    • no se puede encontrar el cloudPubsubTopic especificado o Classroom no tiene permiso para publicarlo.

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.