Method: courses.studentGroups.list

Bir kurstaki grupların listesini döndürür.

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

  • Kurs mevcut değilse NOT_FOUND.

HTTP isteği

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

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

Yol parametreleri

Parametreler
courseId

string

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

Sorgu parametreleri

Parametreler
pageSize

integer

Döndürülecek maksimum öğe sayısı. Sıfır veya belirtilmemiş değer, sunucunun şu anda 75 öğe olarak ayarlanmış bir maksimum değer atayabileceğini gösterir.

Sunucu, belirtilen sonuç sayısından daha az sonuç döndürebilir.
pageToken

string

Sonraki sonuç sayfasının döndürülmesi gerektiğini belirten, önceki bir list çağrısından döndürülen nextPageToken değeri.

list isteği, bu jetonla sonuçlanan istekle başka açılardan aynı olmalıdır.
previewVersion

enum (PreviewVersion)

İsteğe bağlı. API'nin ö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 boş olmalıdır.

Yanıt gövdesi

Öğrenci grupları listelenirken verilen yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "studentGroups": [
    {
      object (StudentGroup)
    }
  ],
  "nextPageToken": string
}
Alanlar
studentGroups[]

object (StudentGroup)

Öğrenci grupları.
nextPageToken

string

Döndürülecek sonuçların sonraki sayfasını tanımlayan jeton. Boşsa başka sonuç yok demektir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

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