Method: userProfiles.guardianInvitations.get

Devuelve una invitación específica para tutores.

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

  • PERMISSION_DENIED si el usuario solicitante no puede ver las invitaciones para tutores del estudiante identificado por studentId, si los tutores no están habilitados para el dominio en cuestión o si existen otros errores de acceso.
  • INVALID_ARGUMENT si se especifica una studentId, pero no se puede reconocer su formato (no es una dirección de correo electrónico, ni una studentId de la API ni la string literal me).
  • NOT_FOUND si Classroom no puede encontrar ningún registro del alumno determinado o invitationId. También se puede devolver si el estudiante existe, pero el usuario solicitante no tiene acceso para ver a ese estudiante.

Solicitud HTTP

GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations/{invitationId}

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

Parámetros de ruta de acceso

Parámetros
studentId

string

El ID del alumno a la que se le solicita la invitación como tutor.
invitationId

string

El campo id del GuardianInvitation que se solicita.

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 GuardianInvitation.

Permisos de autorización

Se necesita uno de los siguientes alcances de OAuth:

  • 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 guía de autorización.