Method: courses.studentGroups.studentGroupMembers.list

Devuelve una lista de los estudiantes de un grupo.

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

  • NOT_FOUND si el curso o el grupo de estudiantes no existen.

Solicitud HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers

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

Parámetros de ruta de acceso

Parámetros
courseId

string

Es obligatorio. Es el identificador del curso.
studentGroupId

string

Es obligatorio. Es el identificador del grupo de estudiantes.

Parámetros de consulta

Parámetros
pageSize

integer

Es la cantidad máxima de elementos que se devolverán. El valor cero o no especificado indica que el servidor puede asignar un máximo.

Es posible que el servidor devuelva menos resultados de los que se especificaron.
pageToken

string

Valor de nextPageToken que se devolvió de una llamada list anterior, lo que indica que se debe devolver la página siguiente de resultados.

La solicitud list debe ser idéntica a la que generó este token.
previewVersion

enum (PreviewVersion)

Opcional. Es la versión preliminar de la API. Se debe configurar para acceder a las nuevas capacidades de la API que se ponen a disposición de los desarrolladores en el Programa de versión preliminar.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la respuesta cuando se enumeran los estudiantes de un grupo.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "studentGroupMembers": [
    {
      object (StudentGroupMember)
    }
  ],
  "nextPageToken": string
}
Campos
studentGroupMembers[]

object (StudentGroupMember)

Son los miembros del grupo de estudiantes.
nextPageToken

string

Es un token que identifica la siguiente página de resultados que se devolverá. Si está vacío, no hay más resultados disponibles.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.rosters.readonly

Para obtener más información, consulta la Guía de autorización.