Method: courses.posts.getAddOnContext

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

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

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

คำขอ HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnContext

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

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

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

string

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

postId
(deprecated)

string

ไม่บังคับ เลิกใช้งานแล้ว โปรดใช้ itemId แทน

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

พารามิเตอร์
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

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