Method: courses.studentGroups.patch

Bir öğrenci grubundaki bir veya daha fazla alanı günceller.

Bu yöntem aşağıdaki hata kodlarını döndürür:

  • İstekte bulunan kullanıcının istenen öğrenci grubunu değiştirmesine izin verilmiyorsa veya erişim hataları için PERMISSION_DENIED.
  • NOT_FOUND Öğrenci grubu mevcut değilse veya kullanıcının öğrenci grubuna erişimi yoksa
  • Güncelleme maskesinde geçersiz alanlar belirtilmişse veya güncelleme maskesi sağlanmamışsa INVALID_ARGUMENT

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
courseId

string

Zorunlu. Kursun tanımlayıcısı.
id

string

Zorunlu. Öğrenci grubunun tanımlayıcısı.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Zorunlu. Öğrenci grubunda hangi alanların güncelleneceğini belirleyen maske. Güncelleme yapmak için bu alanın doldurulması zorunludur. Geçersiz alanlar belirtilirse güncelleme başarısız olur.

Öğretmenler aşağıdaki alanları belirtebilir:

  • title

Bu, alanların tam nitelikli adlarının virgülle ayrılmış listesidir. Örnek: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

İsteğe bağlı. Uç nokta önizleme sürümü. Önizleme Programı'nda geliştiricilerin kullanımına sunulan yeni API özelliklerine erişmek için bu ayar yapılmalıdır.

İstek içeriği

İstek metni, StudentGroup öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılıysa yanıt metni, StudentGroup öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.