Method: courses.courseWork.addOnAttachments.studentSubmissions.list

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

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

  • PERMISSION_DENIED לשגיאות גישה.
  • ‫INVALID_ARGUMENT אם הבקשה לא תקינה.
  • ‫NOT_FOUND אם אחד מהמשאבים שזוהו לא קיים.

בקשת HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions

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

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

פרמטרים
courseId

string

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

string

חובה. המזהה של CourseWork שאליו הקובץ מצורף.
attachmentId

string

חובה. מזהה הקובץ המצורף של התוסף.

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

פרמטרים
pageSize

integer

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

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

string

אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של studentSubmissions.list. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו ל-studentSubmissions.list חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.

גוף הבקשה

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

גוף התשובה

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

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

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

object (AddOnAttachmentStudentSubmission)

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

string

טוקן שאפשר לשלוח כ-pageToken כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

היקפי הרשאות

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

  • https://www.googleapis.com/auth/classroom.addons.student
  • https://www.googleapis.com/auth/classroom.addons.teacher

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.