Method: userProfiles.guardians.get

Muestra un tutor específico.

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

  • PERMISSION_DENIED si no hay un usuario que coincida con el studentId proporcionado, el usuario que lo solicite no podrá ver la información del tutor identificada por el studentId si los tutores no están habilitados para el dominio en cuestión o a causa de 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 ni la string literal me).
  • NOT_FOUND si el usuario que realizó la solicitud puede ver los tutores del studentId solicitado, pero no existe ningún registro Guardian para ese alumno que coincida con el guardianId proporcionado.

Solicitud HTTP

GET 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 alumno a cuyo tutor se le solicita. Uno de los siguientes:

  • el identificador numérico del usuario
  • la dirección de correo electrónico del usuario
  • el literal de string "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 de forma correcta, el cuerpo de la respuesta contiene una instancia de Guardian.

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.