Los complementos de Google Classroom ya están en fase de disponibilidad general para desarrolladores. Consulta la
documentación sobre complementos para obtener más información.
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 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.
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 contiene 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.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[],[],null,["# Method: registrations.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nCreates a `Registration`, causing Classroom to start sending notifications from the provided `feed` to the destination provided in `cloudPubSubTopic`.\n\nReturns the created `Registration`. Currently, this will be the same as the argument, but with server-assigned fields such as `expiryTime` and `id` filled in.\n\nNote that any value specified for the `expiryTime` or `id` fields will be ignored.\n\nWhile Classroom may validate the `cloudPubSubTopic` and return errors on a best effort basis, it is the caller's responsibility to ensure that it exists and that Classroom has permission to publish to it.\n\nThis method may return the following error codes:\n\n- `PERMISSION_DENIED` if:\n - the authenticated user does not have permission to receive notifications from the requested field; or\n - the current user has not granted access to the current Cloud project with the appropriate scope for the requested feed. Note that domain-wide delegation of authority is not currently supported for this purpose. If the request has the appropriate scope, but no grant exists, a \\[Request Errors\\]\\[`@MissingGrant` error\\] is returned.\n - another [access error](/workspace/classroom/reference/Access.Errors) is encountered.\n- `INVALID_ARGUMENT` if:\n - no `cloudPubsubTopic` is specified, or the specified `cloudPubsubTopic` is not valid; or\n - no `feed` is specified, or the specified `feed` is not valid.\n- `NOT_FOUND` if:\n - the specified `feed` cannot be located, or the requesting user does not have permission to determine whether or not it exists; or\n - the specified `cloudPubsubTopic` cannot be located, or Classroom has not been granted permission to publish to it.\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/registrations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains an instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.push-notifications`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
