Method: courses.announcements.getAddOnContext

รับข้อมูลเมตาสำหรับส่วนเสริมของ Classroom ในบริบทของโพสต์ที่ต้องการ

ส่วนเสริมควรเรียกใช้เพื่อตรวจสอบพารามิเตอร์การค้นหาและบทบาทของผู้ใช้ที่ส่งคำขอทุกครั้งที่เปิดส่วนเสริมใน iframe เพื่อรักษาความสมบูรณ์ของข้อมูลและโมเดลสิทธิ์

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

คำขอ HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnContext

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

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

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

string

ต้องระบุ ตัวระบุของหลักสูตร
itemId

string

ตัวระบุของ Announcement, CourseWork หรือ CourseWorkMaterial ของไฟล์แนบ ต้องระบุข้อมูลในช่องนี้ แต่จะไม่มีการทําเครื่องหมายขณะที่เราย้ายข้อมูลจาก postId

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

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

string

ไม่บังคับ โทเค็นที่ให้สิทธิ์คำขอ

ระบบจะส่งโทเค็นเป็นพารามิเตอร์การค้นหาเมื่อระบบเปลี่ยนเส้นทางผู้ใช้จาก Classroom ไปยัง URL ของส่วนเสริม

ต้องระบุโทเค็นการให้สิทธิ์เมื่อไม่ใช่เงื่อนไขต่อไปนี้

  • ส่วนเสริมมีไฟล์แนบในโพสต์
  • โปรเจ็กต์นักพัฒนาซอฟต์แวร์ที่ออกคำขอเป็นโปรเจ็กต์เดียวกับที่สร้างโพสต์
attachmentId

string

ไม่บังคับ ตัวระบุของไฟล์แนบ ต้องระบุช่องนี้สำหรับคำขอทั้งหมด ยกเว้นเมื่อผู้ใช้อยู่ใน iframe การค้นพบไฟล์แนบ

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

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ AddOnContext

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

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

  • https://www.googleapis.com/auth/classroom.addons.student
  • https://www.googleapis.com/auth/classroom.addons.teacher

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