- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
รับข้อมูลเมตาสำหรับส่วนเสริมของ Classroom ในบริบทของโพสต์ที่ระบุ
เพื่อรักษาความถูกต้องของข้อมูลและโมเดลสิทธิ์ของตัวเอง ส่วนเสริมควรเรียกใช้สิ่งนี้เพื่อตรวจสอบพารามิเตอร์การค้นหาและบทบาทของผู้ใช้ที่ส่งคำขอเมื่อมีการเปิดส่วนเสริมใน iframe
เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้
PERMISSION_DENIED
สำหรับข้อผิดพลาดในการเข้าถึงINVALID_ARGUMENT
หากคำขอมีรูปแบบไม่ถูกต้องNOT_FOUND
หากไม่มีทรัพยากรที่ระบุ
คำขอ HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnContext
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
courseId |
ต้องระบุ ตัวระบุของหลักสูตร |
postId |
ไม่บังคับ เลิกใช้งานแล้ว โปรดใช้ itemId แทน |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
itemId |
ตัวระบุของประกาศ, CourseWork หรือcourseWorkMaterial ที่แนบไฟล์แนบมาด้วย ต้องกรอกช่องนี้ แต่ไม่มีเครื่องหมายให้ระบุในขณะย้ายข้อมูลจาก postId |
addOnToken |
ไม่บังคับ โทเค็นที่ให้สิทธิ์คําขอ ระบบจะส่งโทเค็นในรูปแบบพารามิเตอร์การค้นหาเมื่อมีการเปลี่ยนเส้นทางผู้ใช้จาก Classroom ไปยัง URL ของส่วนเสริม ต้องใช้โทเค็นการให้สิทธิ์เมื่อไม่ตรงกับเงื่อนไขต่อไปนี้
|
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ AddOnContext
ขอบเขตการให้สิทธิ์
ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/classroom.addons.student
https://www.googleapis.com/auth/classroom.addons.teacher
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์