Method: courses.studentGroups.patch

Обновляет одно или несколько полей в группе студентов.

Этот метод возвращает следующие коды ошибок:

  • PERMISSION_DENIED если запрашивающему пользователю не разрешено изменять запрашиваемую группу студентов или если возникают ошибки доступа .
  • Если группа студентов не существует или пользователь не имеет доступа к этой группе, NOT_FOUND
  • INVALID_ARGUMENT , если в маске обновления указаны недопустимые поля или если маска обновления не предоставлена.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
courseId

string

Обязательно. Идентификатор курса.

id

string

Обязательно. Идентификатор студенческой группы.

Параметры запроса

Параметры
updateMask

string ( FieldMask format)

Обязательное поле. Маска, указывающая, какие поля в группе студентов следует обновить. Это поле обязательно для обновления. Обновление завершится неудачей, если указаны недопустимые поля.

Учителя могут указать следующие поля:

  • title

Это список полных имен полей, разделенных запятыми. Пример: "user.displayName,photo" .

previewVersion

enum ( PreviewVersion )

Необязательно. Предварительная версия конечной точки. Необходимо указать это для доступа к новым возможностям API, предоставляемым разработчикам в рамках программы предварительного просмотра.

Текст запроса

В теле запроса содержится экземпляр класса StudentGroup .

Ответный текст

В случае успеха тело ответа будет содержать экземпляр класса StudentGroup .

Области полномочий

Требуется следующая область действия OAuth:

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

Для получения более подробной информации см. руководство по авторизации .