Method: userProfiles.guardianInvitations.get

Devuelve una invitación de guardián específica.

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

  • PERMISSION_DENIED si el usuario solicitante no tiene permiso para ver las invitaciones de tutor para el estudiante identificado por el studentId de estudiante, 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 de estudiante, pero no se puede reconocer su formato (no es una dirección de correo electrónico, ni un studentId de estudiante de la API, ni la cadena literal me ).
  • NOT_FOUND si Classroom no puede encontrar ningún registro del estudiante o el ID de invitationId dados. 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 transcodificación de gRPC .

Parámetros de ruta

Parámetros
studentId

string

El DNI del alumno cuya invitación de tutor se solicita.

invitationId

string

El campo de id de la GuardianInvitation que se solicita.

cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de respuesta

Si tiene éxito, el cuerpo de la respuesta contiene una instancia de GuardianInvitation .

Ámbitos de autorización

Requiere uno de los siguientes ámbitos 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, consulte la Descripción general de OAuth 2.0 .