Method: courses.studentGroups.studentGroupMembers.list

מחזירה רשימה של תלמידים בקבוצה.

השיטה הזו מחזירה את קודי השגיאה הבאים:

  • ‫NOT_FOUND אם הקורס או קבוצת התלמידים לא קיימים.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
courseId

string

חובה. המזהה של הקורס.
studentGroupId

string

חובה. המזהה של קבוצת התלמידים.

פרמטרים של שאילתה

פרמטרים
pageSize

integer

מספר הפריטים המקסימלי שיוחזרו. אם הערך הוא אפס או לא צוין, השרת יכול להקצות ערך מקסימלי.

יכול להיות שהשרת יחזיר פחות תוצאות מהמספר שצוין.
pageToken

string

הערך nextPageToken שמוחזר מקריאה קודמת של list, שמציין שצריך להחזיר את דף התוצאות הבא.

בקשת list חייבת להיות זהה לבקשה שהובילה ליצירת האסימון הזה.
previewVersion

enum (PreviewVersion)

אופציונלי. גרסת הטרום-השקה של ה-API. ההגדרה הזו נדרשת כדי לגשת ליכולות חדשות של API שזמינות למפתחים בתוכנית ה-Preview.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

תגובה כשמציגים רשימה של תלמידים בקבוצה.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "studentGroupMembers": [
    {
      object (StudentGroupMember)
    }
  ],
  "nextPageToken": string
}
שדות
studentGroupMembers[]

object (StudentGroupMember)

התלמידים שחברים בקבוצה.
nextPageToken

string

אסימון שמזהה איזה דף תוצאות להציג. אם הערך ריק, אין תוצאות נוספות.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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

מידע נוסף זמין במדריך ההרשאות.