หน้านี้มีข้อมูลเกี่ยวกับฟีเจอร์ที่จะเปิดตัวสำหรับ 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 เวอร์ชันตัวอย่าง
| ฟีเจอร์ | คำอธิบาย | เป้าหมายสำหรับการเปิดตัวเวอร์ชันตัวอย่าง | เป้าหมายสำหรับการเปิดตัวอย่างเป็นทางการ | เวอร์ชันตัวอย่าง |
|---|---|---|---|---|
| ความสามารถของผู้ใช้ | ตรวจสอบว่าผู้ใช้มีสิทธิ์เข้าถึงฟีเจอร์บางอย่างของ Classroom หรือไม่ | ไตรมาสที่ 4 ปี 2024 | ครึ่งแรกของปี 2025 | V1_20240930_PREVIEW |
| เป้าหมายการเรียนรู้ | กำหนดมาตรฐานการเรียนรู้ในหลักสูตร และเป้าหมายการเรียนรู้ในงานของชั้นเรียนและเกณฑ์การให้คะแนน | ไตรมาสที่ 3 ปี 2026 | ไตรมาสที่ 4 ปี 2026 | V1_20260316_PREVIEW |
เวอร์ชันก่อนหน้า
เมื่อมีการตรวจสอบฟีเจอร์ใหม่แล้ว ระบบจะรวมฟีเจอร์ดังกล่าวเข้ากับ API v1 และปิดตัวลงเวอร์ชันตัวอย่างที่เกี่ยวข้อง นักพัฒนาแอปจะมีเวลาอย่างน้อย 90 วันในการย้ายข้อมูลก่อนที่เวอร์ชันตัวอย่างจะปิดตัวลง
| ฟีเจอร์ | คำอธิบาย | รวมเข้ากับเวอร์ชันที่เปิดตัวอย่างเป็นทางการแล้ว | วันที่ปิดตัวลงของเวอร์ชันตัวอย่างตามเป้าหมาย | เวอร์ชันตัวอย่าง |
|---|---|---|---|---|
| CRUD ของเกณฑ์การให้คะแนน | สร้าง อ่าน อัปเดต และลบเกณฑ์การให้คะแนนของ Classroom ในนามของครู | 5 ธ.ค. 2024 | 1 เม.ย. 2025 | V1_20231110_PREVIEW |
| ระยะเวลาการให้คะแนน | สร้าง อ่าน อัปเดต และลบระยะเวลาการให้คะแนนในนามของผู้ดูแลระบบและครู | 8 เม.ย. 2025 | 1 ส.ค. 2025 | V1_20240401_PREVIEW |
| กลุ่มนักเรียนนักศึกษา | จัดการกลุ่มนักเรียนนักศึกษาและสมาชิกในนามของผู้ดูแลระบบและครู | 26 ม.ค. 2026 | 1 มิ.ย. 2026 | V1_20250630_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