หน้านี้มีข้อมูลเกี่ยวกับฟีเจอร์ที่กำลังจะเปิดตัวสำหรับ Classroom API และรายละเอียดเกี่ยวกับวิธีเข้าร่วมการแสดงตัวอย่างสำหรับนักพัฒนาแอป
ดูตัวอย่าง Classroom API
การทดลองใช้ฟีเจอร์ Classroom API ช่วยให้นักพัฒนาแอปมีโอกาส ในการกำหนดรูปแบบการพัฒนาฟีเจอร์ด้วยความคิดเห็น และเตรียมการผสานรวมให้พร้อมใช้งาน ต่อสาธารณะก่อนที่จะพร้อมใช้งานสำหรับผู้ใช้ทั่วไป
วงจรการใช้งานเวอร์ชันตัวอย่าง
นักพัฒนาแอปสามารถเลือกใช้ API เวอร์ชันที่มีฟีเจอร์ใหม่ที่เข้ากันได้แบบย้อนหลัง "เวอร์ชันตัวอย่าง" เหล่านี้จะพร้อมใช้งานแบบสาธารณะ เป็นเวลาอย่างน้อย 90 วัน จากความคิดเห็น เราจะรวมเวอร์ชันแสดงตัวอย่างและฟีเจอร์ต่างๆ เข้ากับ API v1 ที่มีอยู่ เวอร์ชันตัวอย่างจะยังคงพร้อมใช้งานอีกอย่างน้อย 90 วันก่อนที่จะปิดตัวลง
หากความคิดเห็นเกี่ยวกับเวอร์ชันตัวอย่างมีมากพอที่จะต้องทำการเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้อง เราจะสร้างเวอร์ชันใหม่เพื่อรองรับความสามารถที่มีอยู่ ทั้ง 2 เวอร์ชันจะพร้อมใช้งานอย่างน้อย 90 วันเพื่อให้ผู้พัฒนาแอปย้ายข้อมูลได้ เข้าร่วมรายชื่ออีเมลเวอร์ชันตัวอย่างสำหรับนักพัฒนาแอป Classroom API เพื่อรับข้อมูล เกี่ยวกับการเปลี่ยนแปลงในเวอร์ชันตัวอย่าง และสมัครรับรายชื่ออีเมลประกาศเพื่อรับข้อมูลอัปเดตทั่วไปเพิ่มเติมเกี่ยวกับ Classroom API
เข้าร่วมการทดลองใช้ Classroom API
หากต้องการเข้าร่วม ให้เข้าร่วมโปรแกรมเวอร์ชันทดลองสำหรับนักพัฒนาซอฟต์แวร์ของ Google Workspace ฟีเจอร์เวอร์ชันตัวอย่างแบบสาธารณะที่พร้อมใช้งานจะแสดงอยู่ในเวอร์ชันตัวอย่างสำหรับนักพัฒนาแอปที่ใช้งานอยู่ของ Google Workspace หากคุณกำลังทดสอบฟีเจอร์เวอร์ชันตัวอย่างแบบส่วนตัว คุณอาจไม่เห็นฟีเจอร์ดังกล่าวแสดงอยู่ในเอกสารประกอบแบบสาธารณะ
ฟีเจอร์ที่จะเพิ่มใหม่เร็วๆ นี้
นี่คือแผนกลยุทธ์ของเราเกี่ยวกับฟีเจอร์ API ที่คาดการณ์ไว้และไทม์ไลน์ของฟีเจอร์เหล่านั้น โดยจะมีการอัปเดตเป็นระยะ
ค่าเวอร์ชันตัวอย่างแสดงถึงวันที่คาดการณ์ที่เวอร์ชันจะพร้อมใช้งานในตัวอย่าง ครั้งแรก ดูเข้าถึง API เวอร์ชันตัวอย่างเพื่อดูวิธีใช้เวอร์ชันตัวอย่าง
ฟีเจอร์ | คำอธิบาย | เป้าหมายสำหรับการแสดงตัวอย่าง | เป้าหมายสำหรับ GA | Preview Version |
---|---|---|---|---|
ความสามารถของผู้ใช้ | ตรวจสอบว่าผู้ใช้มีสิทธิ์เข้าถึงฟีเจอร์บางอย่างของ Classroom หรือไม่ | ไตรมาสที่ 4 ปี 2024 | 2025 ครึ่งปีแรก | V1_20240930_PREVIEW |
กลุ่มนักเรียน | จัดการกลุ่มนักเรียนและสมาชิกในกลุ่มในนามของผู้ดูแลระบบและครู | ไตรมาสที่ 3 ปี 2025 | จะแจ้งภายหลัง | V1_20250630_PREVIEW |
ฉบับก่อนหน้า
เมื่อตรวจสอบฟีเจอร์ใหม่แล้ว ระบบจะรวมฟีเจอร์ดังกล่าวไว้ใน API v1 และ ปิดเวอร์ชันตัวอย่างที่เกี่ยวข้อง นักพัฒนาแอปจะมีเวลาอย่างน้อย 90 วัน ในการย้ายข้อมูลก่อนที่เวอร์ชันตัวอย่างจะปิดตัวลง
ฟีเจอร์ | คำอธิบาย | รวมเข้ากับ GA | วันที่ปิดตัวอย่างที่กำหนด | Preview Version |
---|---|---|---|---|
CRUD ของเกณฑ์การให้คะแนน | สร้าง อ่าน อัปเดต และลบรูบริกของ Classroom ในนามของครู | 2024 Dec 05 | 2025 เม.ย. 1 | V1_20231110_PREVIEW |
ระยะเวลาการให้คะแนน | สร้าง อ่าน อัปเดต และลบช่วงการให้คะแนนในนามของผู้ดูแลระบบและครู | 2025 Apr 8 | 1 ส.ค. 2025 | V1_20240401_PREVIEW |
คำแนะนำในการย้ายข้อมูล
เมื่อรวมฟีเจอร์จากเวอร์ชันแสดงตัวอย่างเข้ากับ API v1 แล้ว ให้นำอาร์กิวเมนต์ previewVersion
ออกจากการเรียก API ที่เกี่ยวข้องเพื่อให้แน่ใจว่าแอปพลิเคชันจะยังคงทำงานได้ตามที่คาดไว้ ตัวอย่างเช่น หากคุณเข้าถึงความสามารถในการสร้างรูบริกที่เปิดตัวในV1_20231110_PREVIEW
เวอร์ชัน
การเรียก API อาจมีลักษณะดังนี้
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
# Specify the preview version. Rubrics CRUD capabilities are
# supported in V1_20231110_PREVIEW and later.
previewVersion="V1_20231110_PREVIEW"
).execute()
หากต้องการย้ายข้อมูลไปยัง API v1 GA ให้นำอาร์กิวเมนต์ previewVersion
ออก
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
).execute()
หากคุณใช้ไลบรารีของไคลเอ็นต์ที่สร้างแบบคงที่เพื่อเข้าถึงฟีเจอร์เวอร์ชันตัวอย่างที่เฉพาะเจาะจง และไม่ได้ใช้ฟีเจอร์ API เวอร์ชันตัวอย่างอื่นๆ ให้เปลี่ยนไปใช้ไลบรารีของไคลเอ็นต์เริ่มต้นสำหรับภาษาของคุณ ดูข้อมูลเพิ่มเติมได้ที่เข้าถึง API เวอร์ชันตัวอย่าง
ความคิดเห็น
แชร์ความคิดเห็นเกี่ยวกับฟีเจอร์เวอร์ชันตัวอย่างผ่าน IssueTracker ที่ลิงก์ไว้ในส่วนเวอร์ชันตัวอย่างสำหรับนักพัฒนาแอปที่ใช้งานอยู่ของ หน้าภาพรวมโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาแอป Google Workspace
ใช้ฟีเจอร์เวอร์ชันตัวอย่างของ Classroom API ในการใช้งานจริง
หากต้องการใช้ฟีเจอร์เวอร์ชันตัวอย่างของ Classroom API กับผู้ใช้ปลายทาง ซึ่งรวมถึงครู ผู้ดูแลระบบ หรือนักเรียน/นักศึกษาจริง คุณต้องยอมรับ การแก้ไขเฉพาะ Classroom ใน Google Workspace ข้อกำหนดของโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาแอปของ Google Workspace โดยกรอกและ ส่งแบบฟอร์มนี้