מחזירה רשימה של חומרים שקשורים לעבודת קורס שהמגיש רשאי לראות.
תלמידי הקורס יכולים לראות רק חומר לימוד אחד (PUBLISHED
) בקורס. מורים בקורס ומנהלי דומיינים יכולים לראות את כל חומרי העבודה בקורס.
השיטה הזו מחזירה את קודי השגיאה הבאים:
PERMISSION_DENIED
אם המשתמש ששלח את הבקשה לא מורשה לגשת לקורס המבוקש או אם יש שגיאות גישה.INVALID_ARGUMENT
אם הבקשה בפורמט שגוי.NOT_FOUND
אם הקורס המבוקש לא קיים.
בקשת HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
courseId |
מזהה הקורס. המזהה הזה יכול להיות המזהה שהוקצה על ידי Classroom או |
פרמטרים של שאילתה
פרמטרים | |
---|---|
courseWorkMaterialStates[] |
הגבלה על סטטוס העבודה להחזרה. מוחזר רק חומר לימוד שתואם לקורס. אם לא צוין אחרת, יוחזרו פריטים עם סטטוס עבודה של |
orderBy |
סדר מיון אופציונלי לתוצאות. רשימת שדות שמופרדים בפסיקים עם מילת מפתח אופציונלית לכיוון מיון. השדה הנתמך הוא |
pageSize |
מספר הפריטים המקסימלי שיוחזרו. הערך 'אפס' או 'לא מוגדר' מציין שהשרת עשוי להקצות מקסימום. השרת עשוי להחזיר פחות ממספר התוצאות שצוין. |
pageToken |
הערך של הבקשה של |
materialLink |
סינון אופציונלי של חומרי עבודה בקורס, עם לפחות קישור אחד שכתובת ה-URL שלו תואמת חלקית למחרוזת שסופקה. |
materialDriveId |
סינון אופציונלי של חומרי עבודה בקורס, עם לפחות חומר אחד ב-Drive שהמזהה שלו תואם למחרוזת שסופקה. אם ציינת גם |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תשובה בזמן הצגת חומר העבודה בקורס.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"courseWorkMaterial": [
{
object ( |
שדות | |
---|---|
courseWorkMaterial[] |
פריטי חומרי לימוד שתואמים לבקשה. |
nextPageToken |
אסימון המזהה את דף התוצאות הבא שיש להחזיר. אם השדה ריק, אין תוצאות נוספות. |
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/classroom.courseworkmaterials
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
מידע נוסף זמין במדריך להרשאות.