Method: courses.courseWorkMaterials.list

מחזירה רשימה של חומרי הקורס שמגיש הבקשה רשאי לצפות בהם.

התלמידים בקורס יכולים להציג רק חומרי לימוד בקורס PUBLISHED. המורים והאדמינים של הקורסים יכולים לצפות בכל חומרי העבודה בקורס.

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

  • PERMISSION_DENIED אם המשתמש ששלח את הבקשה לא מורשה לגשת לקורס המבוקש או בגלל שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה.
  • NOT_FOUND אם הקורס המבוקש לא קיים.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
courseId

string

מזהה הקורס. המזהה יכול להיות המזהה שהוקצה ל-Classroom או alias.

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

פרמטרים
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

הגבלה על סטטוס העבודה להחזרה. מוחזרים רק חומרי עבודות שתואמים למדיניות. אם לא צוין, פריטים עם סטטוס עבודה PUBLISHED יוחזרו.
orderBy

string

סדר המיון של התוצאות (אופציונלי). רשימת שדות שמופרדים בפסיקים עם מילות מפתח אופציונליות למיון לפי כיוון. השדה הנתמך הוא updateTime. מילות המפתח הנתמכות למסלול הן asc ו-desc. אם לא מציינים שום אפשרות, updateTime desc היא התנהגות ברירת המחדל. דוגמאות: updateTime asc, updateTime
pageSize

integer

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

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

string

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

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

string

אפשרות לסנן לפי חומרי הקורסים עם לפחות חומר אחד ב-Drive שהמזהה שלו תואם למחרוזת שצוינה. אם מציינים גם את materialLink, החומר בעבודה צריך לכלול חומרים שתואמים לשני המסננים.

גוף הבקשה

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

גוף התגובה

תגובה כשרושמים את חומרי העבודה של הקורס.

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

ייצוג JSON 
{
  "courseWorkMaterial": [
    {
      object (CourseWorkMaterial)
    }
  ],
  "nextPageToken": string
}
שדות
courseWorkMaterial[]

object (CourseWorkMaterial)

קורס פריטי חומר עבודה התואמים לבקשה.
nextPageToken

string

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

היקפי הרשאות

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

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

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