ผู้ใช้ของคุณใช้ Classroom กับ Google Meet ใช่หรือไม่ โปรดดูคู่มือเริ่มต้นฉบับย่อสําหรับ Apps Script ซึ่งครอบคลุมวิธีตรวจสอบการเข้าร่วมของนักเรียนในหลักสูตร Google Meet

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

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

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

string

ค่า nextPageToken ที่ส่งคืนจากการเรียก list ก่อนหน้า ซึ่งบ่งบอกว่าหน้าผลลัพธ์ถัดไปควรปรากฏขึ้น

คําขอ list ต้องเหมือนกับคําขอที่ทําให้เกิดโทเค็นนี้

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

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

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

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

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

การแสดง 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

โปรดดูข้อมูลเพิ่มเติมที่หัวข้อภาพรวม OAuth 2.0

ค่าล่าช้า

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

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