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

Melihat pratinjau fitur Classroom API memberikan peluang bagi developer untuk memengaruhi bentuk pengembangan fitur dengan masukan dan memiliki integrasi yang siap digunakan oleh publik sebelum ketersediaan umum.

Siklus proses pratinjau

Developer dapat memilih untuk menggunakan versi API yang berisi fitur baru yang kompatibel dengan versi sebelumnya. "Versi pratinjau" ini tersedia secara publik minimal selama 90 hari. Bergantung pada masukan, versi pratinjau dan fiturnya kemudian akan digabungkan ke API v1 yang ada. Versi pratinjau tetap tersedia setidaknya selama 90 hari lagi sebelum dinonaktifkan.

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 tersebut tersedia minimal selama 90 hari untuk memungkinkan migrasi developer. Bergabunglah dengan 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 saat fitur divalidasi untuk ketersediaan umum di v1 API. Perilaku versi pratinjau dapat berubah setelah dinonaktifkan.

Berpartisipasi dalam pratinjau Classroom API

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

Fitur mendatang

Berikut adalah roadmap fitur API yang diharapkan dan linimasanya. Data ini diperbarui secara berkala.

Nilai versi pratinjau mewakili tanggal yang diharapkan untuk ketersediaan pratinjau awal versi. Lihat Mengakses API pratinjau untuk mempelajari cara penggunaan versi pratinjau.

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

Fitur	Deskripsi	Target untuk Pratinjau	Target untuk GA	Versi Pratinjau
Periode Penilaian	Membuat, membaca, memperbarui, dan menghapus periode penilaian atas nama administrator dan pengajar.	SMT 1 2024	TBD	V1_20240401_PREVIEW
Kemampuan pengguna	Periksa apakah pengguna memiliki akses ke fitur Classroom tertentu.	K4 2024	SMT 1 2025	V1_20240930_PREVIEW

Versi sebelumnya

Setelah fitur baru divalidasi, fitur tersebut akan digabungkan ke v1 API dan versi pratinjau yang sesuai akan dinonaktifkan. Developer memiliki waktu minimal 90 hari untuk melakukan migrasi sebelum versi pratinjau dinonaktifkan.

Penting: Panggilan API untuk menonaktifkan versi pratinjau mungkin tidak berperilaku 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 memigrasikan versi API pratinjau yang dinonaktifkan untuk menghindari gangguan yang tidak terduga. Lihat panduan migrasi untuk mempelajari lebih lanjut.

Fitur	Deskripsi	Dimasukkan ke dalam GA	Target tanggal penonaktifan pratinjau	Versi Pratinjau
CRUD Rubrik	Membuat, membaca, memperbarui, dan menghapus rubrik Classroom atas nama pengajar.	05 Des 2024	1 April 2025	V1_20231110_PREVIEW

Panduan migrasi

Setelah fitur dari versi pratinjau digabungkan ke dalam API v1, hapus argumen previewVersion dari panggilan API terkait untuk memastikan bahwa aplikasi Anda terus berperilaku seperti yang diharapkan. Misalnya, jika Anda mengakses kemampuan pembuatan rubrik yang diperkenalkan dalam versi V1_20231110_PREVIEW, panggilan API Anda mungkin terlihat seperti 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

Berikan 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 ingin menggunakan fitur pratinjau Classroom API dengan pengguna akhir, termasuk guru, administrator, atau siswa sungguhan, Anda harus menyetujui perubahan khusus Classroom pada persyaratan Program Pratinjau Developer Google Workspace dengan melengkapi dan mengirimkan formulir ini: