Fitur pratinjau & roadmap

Halaman ini berisi informasi tentang fitur mendatang untuk Classroom API dan detail tentang cara berpartisipasi dalam pratinjau developer.

Melihat pratinjau Classroom API

Dengan melihat pratinjau fitur Classroom API, developer dapat memengaruhi pengembangan fitur dengan memberikan masukan dan menyiapkan integrasi untuk penggunaan publik sebelum ketersediaan umum.

Siklus proses pratinjau

Developer dapat memilih untuk menggunakan versi API yang berisi fitur baru yang kompatibel mundur. "Versi pratinjau" ini tersedia secara publik selama minimal 90 hari. Berdasarkan masukan, versi pratinjau dan fiturnya kemudian dimasukkan ke dalam API v1 yang ada. Versi pratinjau akan tetap tersedia setidaknya 90 hari lagi sebelum dihentikan.

Jika masukan pada versi pratinjau cukup kuat untuk memerlukan perubahan yang dapat menyebabkan gangguan, versi baru akan dibuat untuk mendukung kemampuan yang ada. Kedua versi tersedia selama minimal 90 hari untuk memungkinkan migrasi developer. Bergabunglah ke milis Pratinjau Developer Classroom API untuk terus mendapatkan informasi tentang perubahan pratinjau dan berlangganan daftar pengumuman untuk mendapatkan info terbaru Classroom API yang lebih umum.

Catatan: Versi pratinjau dimaksudkan untuk bersifat sementara selama fitur divalidasi untuk ketersediaan umum di API v1. Perilaku versi pratinjau dapat berubah setelah dimatikan.

Berpartisipasi dalam pratinjau Classroom API

Untuk berpartisipasi, bergabunglah dengan Program Pratinjau Developer Google Workspace. Fitur pratinjau publik yang tersedia tercantum di pratinjau aktif developer Google Workspace. Jika Anda sedang menguji fitur pratinjau pribadi, Anda mungkin tidak melihat fitur tersebut tercantum dalam dokumentasi publik.

Fitur mendatang

Ini adalah rencana kami untuk fitur API yang diharapkan dan jadwalnya. Data ini diperbarui secara berkala.

Nilai versi pratinjau mewakili perkiraan tanggal ketersediaan pratinjau awal versi. Lihat Mengakses API pratinjau untuk mempelajari cara menggunakan versi pratinjau.

Catatan: Tanggal peta jalan adalah target, dan dapat berubah sewaktu-waktu. Demikian pula, ID versi pratinjau mungkin tidak merepresentasikan tanggal persis saat versi tersedia.

Fitur	Deskripsi	Target untuk Pratinjau	Target untuk GA	Versi Pratinjau
Kemampuan pengguna	Periksa apakah pengguna memiliki akses ke fitur Classroom tertentu.	Kuartal 4 2024	SMT 1 2025	V1_20240930_PREVIEW
Grup siswa	Mengelola grup siswa dan anggotanya atas nama administrator dan pengajar.	K3 2025	TBD	V1_20250630_PREVIEW

Versi sebelumnya

Setelah fitur baru divalidasi, fitur tersebut akan dimasukkan ke dalam v1 API dan versi pratinjau yang sesuai akan dihentikan. Developer memiliki waktu setidaknya 90 hari untuk melakukan migrasi sebelum versi pratinjau ditutup.

Penting: Panggilan API untuk mematikan versi pratinjau mungkin tidak berfungsi seperti yang diharapkan. Secara umum, panggilan API yang menentukan versi pratinjau yang tidak didukung akan otomatis merespons dengan perilaku API v1, tetapi sebaiknya Anda secara proaktif melakukan migrasi dari versi API pratinjau yang akan dihentikan untuk menghindari gangguan yang tidak terduga. Lihat panduan migrasi untuk mempelajari lebih lanjut.

Fitur	Deskripsi	Digabungkan ke GA	Target tanggal penonaktifan pratinjau	Versi Pratinjau
CRUD Rubrik	Membuat, membaca, memperbarui, dan menghapus rubrik kelas atas nama pengajar.	5 Desember 2024	1 April 2025	V1_20231110_PREVIEW
Periode Penilaian	Membuat, membaca, memperbarui, dan menghapus periode penilaian atas nama administrator dan pengajar.	8 April 2025	1 Agustus 2025	V1_20240401_PREVIEW

Panduan migrasi

Setelah fitur dari versi pratinjau dimasukkan ke dalam API v1, hapus argumen previewVersion dari panggilan API terkait untuk memastikan aplikasi Anda terus berperilaku seperti yang diharapkan. Misalnya, jika Anda mengakses kemampuan pembuatan rubrik yang diperkenalkan di versi V1_20231110_PREVIEW, panggilan API Anda mungkin terlihat sebagai berikut:

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()

Untuk bermigrasi ke API GA v1, hapus argumen previewVersion:

rubric = service.courses().courseWork().rubrics().create(
        courseId=course_id, courseWorkId=coursework_id, body=body,
        ).execute()

Jika Anda menggunakan library klien yang dibuat secara statis khusus untuk mengakses fitur versi pratinjau tertentu, dan tidak menggunakan fitur API pratinjau lainnya, beralihlah ke library klien default untuk bahasa Anda. Lihat Mengakses API pratinjau untuk mempelajari lebih lanjut.

Masukan

Sampaikan masukan Anda untuk fitur pratinjau melalui IssueTracker tertaut di bagian pratinjau developer aktif di halaman ringkasan Program Pratinjau Developer Google Workspace.

Menggunakan fitur pratinjau Classroom API dalam produksi

Jika Anda ingin menggunakan fitur pratinjau Classroom API dengan pengguna akhir, termasuk pengajar, administrator, atau siswa sungguhan, Anda harus menyetujui amendemen khusus Classroom terhadap persyaratan Program Pratinjau Developer Google Workspace dengan mengisi dan mengirimkan formulir ini: