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 ตัวระบุของ 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

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