Method: courses.studentGroups.create

Crea un grupo de estudiantes para un curso.

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

  • PERMISSION_DENIED si el usuario solicitante no tiene permiso para crear el grupo de estudiantes o por errores de acceso
  • NOT_FOUND si el curso no existe o el usuario solicitante no tiene acceso a él.
  • FAILED_PRECONDITION si la creación del grupo de estudiantes excedería la cantidad máxima de grupos de estudiantes por curso.

Solicitud HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups

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.

Parámetros de consulta

Parámetros
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 contiene una instancia de StudentGroup.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de StudentGroup.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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