Method: courses.courseWork.getAddOnContext

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

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

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

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

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

คำขอ HTTP

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

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

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

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

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

พารามิเตอร์
postId (deprecated)	string ไม่บังคับ เลิกใช้งานแล้ว โปรดใช้ itemId แทน
addOnToken	string ไม่บังคับ โทเค็นที่ให้สิทธิ์คําขอ ระบบจะส่งโทเค็นในรูปแบบพารามิเตอร์การค้นหาเมื่อมีการเปลี่ยนเส้นทางผู้ใช้จาก Classroom ไปยัง URL ของส่วนเสริม ต้องใช้โทเค็นการให้สิทธิ์เมื่อไม่ตรงกับเงื่อนไขต่อไปนี้ ส่วนเสริมมีไฟล์แนบในโพสต์ โปรเจ็กต์นักพัฒนาซอฟต์แวร์ที่ส่งคําขอเป็นโปรเจ็กต์เดียวกับที่สร้างโพสต์

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

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

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

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

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

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

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

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