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 ส่งคืน StudentSubmissions ที่มีค่า late เป็นจริง
NOT_LATE_ONLY ส่งคืน StudentSubmissions ที่มีค่าเป็นเท็จ