Method: userProfiles.guardianInvitations.get

Muestra una invitación de tutor específica.

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

  • PERMISSION_DENIED si el usuario que realiza la solicitud no tiene permiso para ver las invitaciones de los tutores del alumno identificado por studentId, si los tutores no están habilitados para el dominio en cuestión ni para 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 Classroom no encuentra ningún registro del alumno o invitationId. También se puede mostrar si el alumno 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

Es el ID del alumno cuya invitación se solicitó con el 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.

Alcances de la 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 descripción general de OAuth 2.0.