- คำขอ 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 ของส่วนเสริม ต้องระบุโทเค็นการให้สิทธิ์เมื่อไม่ใช่เงื่อนไขต่อไปนี้
|
attachmentId |
ไม่บังคับ ตัวระบุของไฟล์แนบ ต้องระบุช่องนี้สำหรับคำขอทั้งหมด ยกเว้นเมื่อผู้ใช้อยู่ใน iframe การค้นพบไฟล์แนบ |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ AddOnContext
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้
https://www.googleapis.com/auth/classroom.addons.student
https://www.googleapis.com/auth/classroom.addons.teacher
สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์