Method: registrations.create

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.