Method: userProfiles.guardians.delete

Exclui um responsável.

O responsável não vai mais receber notificações e não poderá ser acessado pela API.

Esse método retorna os seguintes códigos de erro:

  • PERMISSION_DENIED se nenhum usuário que corresponda ao studentId fornecido estiver visível para o usuário solicitante, se o usuário solicitante não tiver permissão para gerenciar os responsáveis do estudante identificado pelo studentId, se os responsáveis não estiverem ativados para o domínio em questão ou por outros erros de acesso.
  • INVALID_ARGUMENT se um studentId for especificado, mas o formato dele não puder ser reconhecido (ele não é um endereço de e-mail nem um studentId da API).
  • NOT_FOUND se o usuário solicitante tiver permissão para modificar os responsáveis pelo studentId solicitado, mas não houver nenhum registro de Guardian para o estudante com o guardianId fornecido.

Solicitação HTTP

DELETE https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardians/{guardianId}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
studentId

string

O estudante cujo responsável será excluído. Opções:

  • o identificador numérico do usuário
  • o endereço de e-mail do usuário
  • o literal de string "me", indicando o usuário solicitante
guardianId

string

O campo id de um Guardian.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta será um objeto JSON vazio.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/classroom.guardianlinks.students

Para mais informações, consulte o guia de autorização.