Method: courses.courseWorkMaterials.getAddOnContext

• คำขอ HTTP
• พารามิเตอร์เส้นทาง
• พารามิเตอร์การค้นหา
• เนื้อความของคำขอ
• เนื้อหาการตอบกลับ
• ขอบเขตการให้สิทธิ์

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

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

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

• PERMISSION_DENIED เพื่อดูข้อผิดพลาดในการเข้าถึง
• INVALID_ARGUMENT หากคำขอมีรูปแบบไม่ถูกต้อง
• NOT_FOUND หากหนึ่งในทรัพยากรที่ระบุไม่มีอยู่

คำขอ HTTP

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

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

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

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

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

พารามิเตอร์
postId (deprecated)	string ไม่บังคับ เลิกใช้งานแล้ว โปรดใช้ itemId แทน
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

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