ตัวอย่างฟีเจอร์และแผนกลยุทธ์

หน้านี้มีข้อมูลเกี่ยวกับฟีเจอร์ที่กำลังจะมีให้บริการสำหรับ Classroom API และรายละเอียดเกี่ยวกับวิธีเข้าร่วมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์

ทดลองใช้ Classroom API

การแสดงตัวอย่างฟีเจอร์ Classroom API เปิดโอกาสให้นักพัฒนาแอปได้มีส่วนร่วมในการพัฒนาฟีเจอร์ด้วยความคิดเห็น รวมถึงเตรียมการผสานรวมให้พร้อมใช้งานแบบสาธารณะก่อนเปิดตัวเวอร์ชันสำหรับผู้ใช้ทั่วไป

วงจรการแสดงตัวอย่าง

นักพัฒนาแอปสามารถเลือกใช้ API เวอร์ชันที่มีฟีเจอร์ใหม่ซึ่งเข้ากันได้แบบย้อนหลัง "เวอร์ชันตัวอย่าง" เหล่านี้จะพร้อมให้บริการแก่สาธารณะอย่างน้อย 90 วัน จากนั้นเราจะรวมเวอร์ชันตัวอย่างและฟีเจอร์ต่างๆ ไว้ใน API เวอร์ชัน 1 ที่มีอยู่ โดยขึ้นอยู่กับความคิดเห็นที่ได้รับ เวอร์ชันตัวอย่างจะยังใช้งานได้อีกอย่างน้อย 90 วันก่อนที่จะปิดให้บริการ

หากความคิดเห็นเกี่ยวกับเวอร์ชันตัวอย่างมีมากพอที่จะต้องมีการเปลี่ยนแปลงที่ทำให้เกิดข้อจำกัด ระบบจะสร้างเวอร์ชันใหม่เพื่อรองรับความสามารถที่มีอยู่ โดยทั้ง 2 เวอร์ชันจะพร้อมใช้งานอย่างน้อย 90 วันเพื่อให้นักพัฒนาแอปย้ายข้อมูลได้ สมัครรับอีเมลจากเวอร์ชันตัวอย่างสำหรับนักพัฒนาแอป Classroom API เพื่อติดตามข่าวสารเกี่ยวกับการเปลี่ยนแปลงในเวอร์ชันตัวอย่าง และสมัครรับอีเมลประกาศเพื่อรับข้อมูลอัปเดตทั่วไปเกี่ยวกับ Classroom API

เข้าร่วมการทดลองใช้ Classroom API

หากต้องการเข้าร่วม โปรดเข้าร่วมโปรแกรมทดลองใช้สำหรับนักพัฒนาซอฟต์แวร์ของ Google Workspace ฟีเจอร์เวอร์ชันตัวอย่างแบบสาธารณะที่พร้อมใช้งานจะแสดงอยู่ในเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์เวอร์ชันที่ใช้งานอยู่ของ Google Workspace หากคุณกำลังทดสอบฟีเจอร์เวอร์ชันตัวอย่างแบบส่วนตัว คุณอาจไม่เห็นฟีเจอร์ดังกล่าวในเอกสารประกอบสาธารณะ

ฟีเจอร์ที่กำลังจะเปิดตัว

แผนพัฒนาฟีเจอร์ API ที่คาดไว้และลําดับเวลามีดังนี้ ซึ่งมีการอัปเดตเป็นระยะ

ค่าเวอร์ชันตัวอย่างแสดงวันที่ที่คาดว่าเวอร์ชันจะพร้อมใช้งานเวอร์ชันตัวอย่างครั้งแรก ดูเข้าถึง Preview API เพื่อดูวิธีใช้เวอร์ชันตัวอย่าง

ฟีเจอร์ คำอธิบาย เป้าหมายสําหรับการแสดงตัวอย่าง เป้าหมายสําหรับ GA Preview Version
ระยะเวลาการให้คะแนน สร้าง อ่าน อัปเดต และลบระยะเวลาการให้คะแนนในนามของผู้ดูแลระบบและครู ครึ่งแรกของปี 2024 TBD V1_20240401_PREVIEW
ความสามารถของผู้ใช้ ตรวจสอบว่าผู้ใช้มีสิทธิ์เข้าถึงฟีเจอร์บางอย่างของ Classroom หรือไม่ ไตรมาส 4 ปี 2024 2025 ครึ่งปีแรก V1_20240930_PREVIEW

ฉบับก่อนหน้า

เมื่อตรวจสอบฟีเจอร์ใหม่แล้ว ระบบจะรวมฟีเจอร์ดังกล่าวไว้ใน v1 API และปิดเวอร์ชันตัวอย่างที่เกี่ยวข้อง นักพัฒนาแอปมีเวลาอย่างน้อย 90 วันในการย้ายข้อมูลก่อนที่เวอร์ชันตัวอย่างจะปิดให้บริการ

ฟีเจอร์ คำอธิบาย รวมอยู่ใน GA วันที่ปิดใช้เวอร์ชันตัวอย่างเป้าหมาย Preview Version
Rubrics CRUD สร้าง อ่าน อัปเดต และลบเกณฑ์ของ Classroom ในนามของครู 5 ธ.ค. 2024 1 เม.ย. 2025 V1_20231110_PREVIEW

คำแนะนำในการย้ายข้อมูล

เมื่อรวมฟีเจอร์จากเวอร์ชันตัวอย่างไว้ใน API เวอร์ชัน 1 แล้ว ให้นําอาร์กิวเมนต์ 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()

หากต้องการย้ายข้อมูลไปยัง GA API v1 ให้นําอาร์กิวเมนต์ 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 โดยกรอกและส่งแบบฟอร์มนี้