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.