Method: courses.courseWork.list

ส่งคืนรายการงานของหลักสูตรที่ผู้ขอได้รับอนุญาตให้ดู

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

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

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

คำขอ HTTP

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

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

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

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

string

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

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

พารามิเตอร์
courseWorkStates[]

enum (CourseWorkState)

การจำกัดสถานะงานที่จะส่งคืน ระบบจะแสดงเฉพาะ CourseWork ที่ตรงกับที่ระบุเท่านั้น หากไม่ระบุ ระบบจะส่งคืนสินค้าที่มีสถานะงานเป็น PUBLISHED
orderBy

string

ลำดับการจัดเรียง (ไม่บังคับ) สำหรับผลลัพธ์ รายการฟิลด์ที่คั่นด้วยคอมมาซึ่งมีคีย์เวิร์ดตัวเลือกทิศทางการจัดเรียง ช่องที่รองรับคือ updateTime และ dueDate คีย์เวิร์ดเส้นทางที่รองรับคือ asc และ desc หากไม่ได้ระบุไว้ ระบบจะใช้ updateTime desc เป็นลักษณะการทำงานเริ่มต้น ตัวอย่าง: dueDate asc,updateTime desc, updateTime,dueDate desc
pageSize

integer

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

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

string

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

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

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

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

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

ตอบกลับเมื่อแสดงรายการงานของหลักสูตร

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

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

object (CourseWork)

รายการงานในหลักสูตรที่ตรงกับคำขอ
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

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