Method: courses.courseWork.studentSubmissions.list

แสดงผลรายการงานที่นักเรียนส่งซึ่งผู้ขอได้รับอนุญาตให้ดู โดยพิจารณาขอบเขต OAuth ของคำขอ สามารถระบุ - เป็น courseWorkId เพื่อรวมงานที่นักเรียนส่งสำหรับรายการงานหลายรายการในหลักสูตรได้

นักเรียนในหลักสูตรจะดูได้เฉพาะงานของตนเอง ครูของหลักสูตรและผู้ดูแลระบบโดเมนสามารถดูงานที่นักเรียนส่งทั้งหมด

เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

  • PERMISSION_DENIEDหากผู้ใช้ที่ส่งคำขอไม่ได้รับอนุญาตให้เข้าถึงหลักสูตรหรืองานในหลักสูตรที่ขอ หรือเมื่อมีข้อผิดพลาดในการเข้าถึง
  • INVALID_ARGUMENT หากคำขอมีรูปแบบไม่ถูกต้อง
  • NOT_FOUND หากไม่มีหลักสูตรที่ขอ

คำขอ HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
courseId

string

ตัวระบุของหลักสูตร ตัวระบุนี้อาจเป็นตัวระบุที่ Classroom กำหนดหรือ alias ก็ได้
courseWorkId

string

ตัวระบุงานของนักเรียนที่จะขอ ค่านี้อาจเป็นสตริงลิเทอรัล "-" เพื่อของานของนักเรียนสำหรับงานทั้งหมดในหลักสูตรในหลักสูตรที่ระบุ

พารามิเตอร์การค้นหา

พารามิเตอร์
userId

string

อาร์กิวเมนต์ (ไม่บังคับ) สำหรับจำกัดงานของนักเรียนที่ส่งคืนไว้เฉพาะที่นักเรียนเป็นเจ้าของและมีตัวระบุที่ระบุ ตัวระบุอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • ตัวระบุที่เป็นตัวเลขสำหรับผู้ใช้
  • อีเมลของผู้ใช้
  • สตริง "me" ซึ่งระบุผู้ใช้ที่ส่งคำขอ
states[]

enum (SubmissionState)

สถานะการส่งที่ขอ หากระบุไว้ งานที่นักเรียนส่งกลับมาจะตรงกับสถานะการส่งที่ระบุรายการใดรายการหนึ่ง
late

enum (LateValues)

ค่าเวลาในการตอบสนองที่ขอ หากระบุไว้ งานที่นักเรียนส่งคืนจะถูกจำกัดตามค่าที่ขอ หากไม่ระบุ ระบบจะแสดงผลการส่งโดยไม่คำนึงถึงค่า late
pageSize

integer

จำนวนรายการสูงสุดที่จะแสดง 0 หรือไม่ได้ระบุ ระบุว่าเซิร์ฟเวอร์อาจกำหนดค่าสูงสุด

เซิร์ฟเวอร์อาจแสดงผลลัพธ์น้อยกว่าจำนวนที่ระบุ
pageToken

string

แสดงค่า nextPageToken จากการเรียก list ก่อนหน้านี้ ซึ่งบ่งบอกว่าระบบควรแสดงผลหน้าถัดไป

คำขอ list จะต้องเหมือนกับคำขอที่ทำให้เกิดโทเค็นนี้
previewVersion

enum (PreviewVersion)

ไม่บังคับ เวอร์ชันตัวอย่างของ API ซึ่งต้องตั้งค่าเพื่อให้เข้าถึงความสามารถของ API ใหม่ๆ ที่พร้อมใช้งานสำหรับนักพัฒนาซอฟต์แวร์ในโปรแกรมทดลองใช้

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

ตอบกลับเมื่อแสดงงานที่นักเรียนส่ง

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "studentSubmissions": [
    {
      object (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
ช่อง
studentSubmissions[]

object (StudentSubmission)

งานของนักเรียนที่ตรงกับคำขอ
nextPageToken

string

โทเค็นที่ระบุหน้าถัดไปของผลการค้นหาที่จะแสดง หากเว้นว่างไว้ จะไม่มีผลลัพธ์เพิ่มเติม

ขอบเขตการให้สิทธิ์

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์

LateValues

ข้อจำกัดเกี่ยวกับค่าที่ล่าช้าของสินค้าที่ส่งคืน

Enum
LATE_VALUES_UNSPECIFIED ไม่มีข้อจำกัดเกี่ยวกับค่าที่ส่งล่าช้า
LATE_ONLY ส่งคืนการส่งงานของนักเรียนในกรณีที่ส่งล่าช้า
NOT_LATE_ONLY ส่งคืนการส่งงานของนักเรียนในกรณีที่ส่งช้า