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

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

addOnToken

string

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

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

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

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

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

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

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

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

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

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

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

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