- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ลองใช้งาน
แสดงรายการประกาศที่ผู้ขอได้รับอนุญาตให้ดู
นักเรียนในหลักสูตรจะดูประกาศได้ PUBLISHED
รายการเท่านั้น ครูของหลักสูตรและผู้ดูแลระบบโดเมนสามารถดูประกาศทั้งหมด
เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้
PERMISSION_DENIED
หากผู้ใช้ที่ส่งคำขอไม่ได้รับอนุญาตให้เข้าถึงหลักสูตรที่ขอหรือข้อผิดพลาดในการเข้าถึงINVALID_ARGUMENT
หากคำขอมีรูปแบบไม่ถูกต้องNOT_FOUND
หากไม่มีหลักสูตรที่ขอ
คำขอ HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
courseId |
ตัวระบุของหลักสูตร ตัวระบุนี้อาจเป็นตัวระบุที่ Classroom กำหนดหรือ |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
announcementStates[] |
การจำกัด |
orderBy |
ลำดับการจัดเรียง (ไม่บังคับ) สำหรับผลลัพธ์ รายการฟิลด์ที่คั่นด้วยคอมมาซึ่งมีคีย์เวิร์ดตัวเลือกทิศทางการจัดเรียง ฟิลด์ที่รองรับคือ |
pageSize |
จำนวนรายการสูงสุดที่จะแสดง 0 หรือไม่ได้ระบุ ระบุว่าเซิร์ฟเวอร์อาจกำหนดค่าสูงสุด เซิร์ฟเวอร์อาจแสดงผลลัพธ์น้อยกว่าจำนวนที่ระบุ |
pageToken |
แสดงค่า คำขอ |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
ตอบกลับเมื่อแสดงรายการงานของหลักสูตร
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"announcements": [
{
object ( |
ช่อง | |
---|---|
announcements[] |
รายการประกาศที่ตรงกับคำขอ |
nextPageToken |
โทเค็นที่ระบุหน้าถัดไปของผลการค้นหาที่จะแสดง หากเว้นว่างไว้ จะไม่มีผลลัพธ์เพิ่มเติม |
ขอบเขตการให้สิทธิ์
ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/classroom.announcements
https://www.googleapis.com/auth/classroom.announcements.readonly
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์