Bu sayfada, Classroom API'nin yakında kullanıma sunulacak özellikleri ve geliştirici önizlemesine nasıl katılacağınızla ilgili ayrıntılı bilgiler yer alır.
Classroom API'yi önizleme
Classroom API özelliklerini önizlemek, geliştiricilere geri bildirimlerle özellik geliştirmenin şeklini etkileme ve genel kullanıma sunulmadan önce entegrasyonları herkese açık kullanıma hazır hale getirme fırsatı sunar.
Yaşam döngüsünü önizleme
Geliştiriciler, API'nin yeni ve geriye dönük uyumlu özellikler içeren sürümlerini etkinleştirebilir. Bu "önizleme sürümleri" en az 90 gün boyunca herkese açıktır. Önizleme sürümü ve özellikleri, geri bildirime tabi olarak mevcut v1 API'ye dahil edilir. Önizleme sürümleri, kullanımdan kaldırılmadan önce en az 90 gün daha kullanılabilir.
Bir önizleme sürümüyle ilgili geri bildirim, önemli değişiklikler gerektirecek kadar güçlüyse mevcut özellikleri desteklemek için yeni bir sürüm oluşturulur. Geliştiricilerin taşıma işlemini yapmasına olanak tanımak için her iki sürüm de en az 90 gün boyunca kullanılabilir. Önizleme değişikliklerinden haberdar olmak için Classroom API Developer Preview posta listesine katılın ve daha genel Classroom API güncellemeleri için duyuru listesine abone olun.
Classroom API önizlemelerine katılma
Programa katılmak için Google Workspace Geliştirici Önizleme Programı'na kaydolun. Kullanılabilir herkese açık önizleme özellikleri, Google Workspace etkin geliştirici önizlemelerinde listelenir. Gizli bir önizleme özelliğini test ediyorsanız bu özelliği herkese açık dokümanlarda göremeyebilirsiniz.
Yakında kullanıma sunulacak özellikler
Bu, beklenen API özelliklerini ve zaman çizelgelerini içeren yol haritamızdır. Bu sayfa düzenli olarak güncellenir.
Önizleme sürümü değeri, sürümün ilk önizlemesinin kullanıma sunulacağı tahmini tarihi temsil eder. Önizleme sürümlerinin nasıl kullanıldığını öğrenmek için Önizleme API'lerine erişim başlıklı makaleyi inceleyin.
| Özellik | Açıklama | Önizleme için hedef | GA için hedef | Önizleme sürümü |
|---|---|---|---|---|
| Notlandırma dönemleri | Yöneticiler ve öğretmenler adına notlandırma dönemleri oluşturma, okuma, güncelleme ve silme. | 2024'ün ilk yarısı | TBD |
V1_20240401_PREVIEW |
| Kullanıcı özellikleri | Bir kullanıcının belirli Classroom özelliklerine erişip erişemediğini kontrol edin. | 2024 4. Çeyrek | 2025 Yılı 1. Çeyrek | V1_20240930_PREVIEW |
Önceki sürümler
Yeni özellikler doğrulandıktan sonra v1 API'ye dahil edilir ve ilgili önizleme sürümü kapatılır. Geliştiricilerin, önizleme sürümü kullanımdan kaldırılmadan önce en az 90 gün içinde taşıma işlemini tamamlaması gerekir.
| Özellik | Açıklama | GA'ya dahil edildi | Hedef önizlemenin kapatılacağı tarih | Önizleme sürümü |
|---|---|---|---|---|
| Rubrikler CRUD | Öğretmenler adına sınıf değerlendirme ölçütleri oluşturma, okuma, güncelleme ve silme | 05 Aralık 2024 | 1 Nisan 2025 | V1_20231110_PREVIEW |
Taşımayla ilgili rehberlik
Bir önizleme sürümündeki özellikler v1 API'ye dahil edildikten sonra, uygulamanızın beklendiği gibi çalışmaya devam etmesini sağlamak için ilgili API çağrılarından previewVersion bağımsız değişkenini kaldırın. Örneğin, V1_20231110_PREVIEW sürümünde kullanıma sunulan notlandırma oluşturma özelliklerine erişiyorsanız API çağrılarınız aşağıdaki gibi görünebilir:
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()
v1 GA API'ye geçmek için previewVersion bağımsız değişkenini kaldırın:
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
).execute()
Özellikle belirli bir önizleme sürümü özelliğine erişmek için statik olarak oluşturulmuş bir istemci kitaplığı kullanıyorsanız ve diğer önizleme API özelliklerini kullanmıyorsanız dilinize yönelik varsayılan istemci kitaplığına geçin. Daha fazla bilgi edinmek için Önizleme API'lerine erişim başlıklı makaleyi inceleyin.
Geri bildirim
Google Workspace Geliştirici Önizleme Programı'na genel bakış sayfasındaki etkin geliştirici önizlemeleri bölümündeki bağlı IssueTracker üzerinden önizleme özellikleriyle ilgili geri bildirimlerinizi paylaşın.
Classroom API önizleme özelliklerini üretimde kullanma
Classroom API önizleme özelliklerini gerçek öğretmenler, yöneticiler veya öğrenciler de dahil olmak üzere son kullanıcılarla kullanmak istiyorsanız bu formu doldurup göndererek Google Workspace Geliştirici Önizleme Programı şartları'nda Classroom'a özel bir değişikliği kabul etmeniz gerekir: