Method: courses.courseWorkMaterials.list

แสดงผลรายการสื่อการเรียนการสอนของหลักสูตรที่ผู้ขอมีสิทธิ์ดู

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

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

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

คำขอ HTTP

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

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

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

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

string

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

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

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

enum (CourseWorkMaterialState)

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

string

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

integer

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

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

string

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

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

string

การกรองที่ไม่บังคับสำหรับสื่อการบ้านที่มีสื่อในไดรฟ์อย่างน้อย 1 รายการซึ่งมีรหัสตรงกับสตริงที่ระบุ หากมีการระบุ materialLink ด้วย สื่อในงานของหลักสูตรต้องมีสื่อที่ตรงกับทั้ง 2 ตัวกรอง
previewVersion

enum (PreviewVersion)

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

เนื้อความของคำขอ

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

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

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

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

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

object (CourseWorkMaterial)

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

string

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

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

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

  • https://www.googleapis.com/auth/classroom.courseworkmaterials
  • https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

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