Method: registrations.create

• Solicitação HTTP
• Corpo da solicitação
• Corpo da resposta
• Escopos de autorização

Cria um Registration, fazendo com que o Google Sala de Aula comece a enviar notificações do feed informado para o destino informado no cloudPubSubTopic.

Retorna o Registration criado. No momento, ele é igual ao argumento, mas com campos atribuídos pelo servidor, como expiryTime e id, preenchidos.

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 existe 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 atual do Cloud com o escopo apropriado para o feed solicitado. No momento, a delegação de autoridade em todo o domínio não está disponível para essa finalidade. Se a solicitação tiver o escopo apropriado, mas não existir nenhuma concessão, a mensagem [Erros de solicitação][@MissingGrant erro] será retornada.
  • outro erro de acesso for encontrado.
• INVALID_ARGUMENT se:
  • nenhum cloudPubsubTopic for especificado ou o cloudPubsubTopic especificado não for válido; ou
  • 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.

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.