Method: courses.studentGroups.patch

Actualiza uno o más campos en un grupo de estudiantes.

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

  • PERMISSION_DENIED si el usuario solicitante no tiene permiso para modificar el grupo de estudiantes solicitado o por errores de acceso
  • NOT_FOUND si el grupo de estudiantes no existe o el usuario no tiene acceso a él.
  • INVALID_ARGUMENT si se especifican campos no válidos en la máscara de actualización o si no se proporciona ninguna máscara de actualización

Solicitud HTTP

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

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

string

Es obligatorio. Es el identificador del grupo de estudiantes.

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Es obligatorio. Máscara que identifica qué campos del grupo de estudiantes se deben actualizar. Este campo es obligatorio para realizar una actualización. La actualización falla si se especifican campos no válidos.

Los profesores pueden especificar los siguientes campos:

  • title

Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Opcional. Es la versión de vista previa del extremo. 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 se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia 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.