Method: userProfiles.guardianInvitations.get

Devuelve una invitación específica para el tutor.

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

  • PERMISSION_DENIED si el usuario solicitante no tiene permiso para ver las invitaciones de los tutores para el estudiante identificado por 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, ni la cadena literal me).
  • NOT_FOUND si Classroom no puede encontrar ningún registro del estudiante determinado o invitationId. También se puede mostrar si el estudiante existe, pero el usuario solicitante no tiene acceso para verlo.

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 estudiante cuya invitación para el tutor se solicita.
invitationId

string

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

Alcances de autorización

Se necesita uno de los siguientes permisos 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.