Method: userProfiles.guardians.delete

Borra a un tutor.

El tutor ya no recibirá notificaciones y ya no se podrá acceder a él a través de la API.

Este método muestra los siguientes códigos de error:

  • PERMISSION_DENIED si el usuario solicitante no puede ver a ningún usuario que coincida con el studentId proporcionado, si no tiene permiso para administrar a los tutores del estudiante identificado por el studentId, si los tutores no están habilitados para el dominio en cuestión o por otros errores de acceso.
  • INVALID_ARGUMENT si se especifica un studentId, pero no se puede reconocer su formato (no es una dirección de correo electrónico ni un studentId de la API).
  • NOT_FOUND si el usuario solicitante tiene permiso para modificar los tutores del studentId solicitado, pero no existe ningún registro Guardian para ese estudiante con el guardianId proporcionado.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
studentId

string

El estudiante cuyo tutor se borrará. Uno de los siguientes:

  • el identificador numérico del usuario
  • la dirección de correo electrónico del usuario
  • el literal de cadena "me", que indica el usuario solicitante
guardianId

string

El campo id de un Guardian

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta es un objeto JSON vacío.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Guía de autorización.