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

หน้านี้มีข้อมูลเกี่ยวกับฟีเจอร์ที่กำลังจะเปิดตัวสำหรับ 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 เวอร์ชันตัวอย่างเพื่อดูวิธีใช้เวอร์ชันตัวอย่าง

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

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

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

เมื่อรวมฟีเจอร์จากเวอร์ชันแสดงตัวอย่างเข้ากับ 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 กับผู้ใช้ปลายทาง ซึ่งรวมถึงครู ผู้ดูแลระบบ หรือนักเรียน/นักศึกษาจริง คุณต้องยอมรับ การแก้ไขข้อกำหนดของโปรแกรม Google Workspace Developer Preview Program สำหรับ Google Workspace โดยเฉพาะ โดยกรอกและส่งแบบฟอร์มนี้