Method: registrations.create
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Cria um Registration, fazendo com que o Google Sala de Aula comece a enviar notificações do feed fornecido para o destino informado em cloudPubSubTopic.
Retorna o Registration criado. No momento, isso é igual ao argumento, mas com os campos atribuídos pelo servidor preenchidos, como expiryTime e id.
Qualquer valor especificado para os campos expiryTime ou id será ignorado.
Embora o Google Sala de Aula possa validar o cloudPubSubTopic e retornar erros da melhor forma possível, é responsabilidade do autor da chamada garantir que ele exista e que o Google Sala de Aula tenha permissão para publicar nele.
Esse método pode retornar os seguintes códigos de erro:
PERMISSION_DENIED se:
- o usuário autenticado não tem permissão para receber notificações do campo solicitado; ou
- o usuário atual não concedeu acesso ao projeto do Cloud com o escopo adequado para o feed solicitado. No momento, a delegação de autoridade em todo o domínio não é compatível com essa finalidade. Se a solicitação tiver o escopo adequado, mas não houver uma concessão, um [Erros de solicitação][
@MissingGrant error] será retornado.
- outro erro de acesso é encontrado.
INVALID_ARGUMENT se:
- nenhum
cloudPubsubTopic foi especificado ou o cloudPubsubTopic especificado não é válido;
- nenhum
feed foi especificado ou o feed especificado não é válido.
NOT_FOUND se:
- o
feed especificado não pode ser localizado ou o usuário solicitante não tem permissão para determinar se ele existe ou não; ou
- o
cloudPubsubTopic especificado não pode ser localizado ou o Google Sala de Aula não recebeu permissão para publicar nele.
Solicitação HTTP
POST https://classroom.googleapis.com/v1/registrations
O URL usa a sintaxe de transcodificação gRPC.
Corpo da solicitação
O corpo da solicitação contém uma instância de Registration.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Registration.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/classroom.push-notifications
Para mais informações, consulte o guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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)."]]
