Method: courses.announcements.getAddOnContext

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

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

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

คำขอ HTTP

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

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

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

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

string

ต้องระบุ ตัวระบุของหลักสูตร
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

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