Bu sayfada, Classroom API'nin yeni özellikleri ve geliştirici önizlemesine nasıl katılacağınız hakkında bilgiler yer almaktadır.
Classroom API'yi önizleme
Classroom API özelliklerinin önizlemesi, geliştiricilere geri bildirimlerle özellik geliştirmenin şeklini etkileme ve genel kullanıma sunulmadan önce herkese açık kullanıma hazır entegrasyonlar oluşturma fırsatı sunar.
Yaşam döngüsünü önizleme
Geliştiriciler, yeni ve geriye dönük uyumlu özellikler içeren API sürümlerini etkinleştirebilir. Bu "önizleme sürümleri" en az 90 gündür herkese açık olarak kullanılabilir. Geri bildirimlere bağlı olarak, önizleme sürümü ve özellikleri mevcut v1 API'ye dahil edilir. Önizleme sürümleri, kapatılmadan önce en az 90 gün daha kullanılabilir.
Bir önizleme sürümüyle ilgili geri bildirimler, önemli değişiklikler yapılmasını gerektirecek kadar güçlü olursa mevcut özellikleri desteklemek için yeni bir sürüm oluşturulur. Geliştiricilerin geçiş yapabilmesi 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 katılın. Kullanılabilen genel önizleme özellikleri, Google Workspace etkin geliştirici önizlemelerinde listelenir. Özel önizleme özelliğini test ediyorsanız bu özelliği herhangi bir herkese açık dokümanda listelenmiş olarak görmeyebilirsiniz.
Yakında kullanıma sunulacak özellikler
Bu, beklenen API özelliklerinin ve zaman çizelgelerinin yol haritasıdır. Periyodik olarak güncellenir.
Önizleme sürümü değeri, sürümün ilk önizleme kullanılabilirliği için beklenen tarihi gösterir. Önizleme sürümlerinin nasıl kullanıldığını öğrenmek için Önizleme API'lerine erişme başlıklı makaleyi inceleyin.
| Özellik | Açıklama | Önizleme Hedefi | GA için hedef | Önizleme sürümü |
|---|---|---|---|---|
| Kullanıcı özellikleri | Kullanıcının belirli Classroom özelliklerine erişimi olup olmadığını kontrol edin. | 2024 4. Çeyrek | 2025'in 1. yarısı | V1_20240930_PREVIEW |
| Öğrenci grupları | Yöneticiler ve öğretmenler adına öğrenci gruplarını ve üyelerini yönetme | 2025 3. Çeyrek | Henüz belli değil | Henüz belli değil |
Ö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ştiriciler, önizleme sürümü kapatılmadan önce geçiş yapmak için en az 90 gün süreye sahiptir.
| Özellik | Açıklama | GA'ya dahil edildi | Hedef önizleme kapatma tarihi | Önizleme sürümü |
|---|---|---|---|---|
| Rubrics CRUD | Öğretmenler adına sınıf derecelendirme ölçekleri oluşturma, okuma, güncelleme ve silme. | 2024 Dec 05 | 1 Nisan 2025 | V1_20231110_PREVIEW |
| Notlandırma dönemleri | Yöneticiler ve öğretmenler adına notlandırma dönemleri oluşturma, okuma, güncelleme ve silme. | 2025 Apr 8 | 2025 Ağu 1 | V1_20240401_PREVIEW |
Taşıma rehberi
Ö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 derecelendirme anahtarı 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çiş yapmak 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()
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 diliniz için varsayılan istemci kitaplığına geçin. Daha fazla bilgi için Önizleme API'lerine erişme başlıklı makaleyi inceleyin.
Geri bildirim
Önizleme özellikleriyle ilgili geri bildiriminizi, Google Workspace Geliştirici Önizleme Programı'na genel bakış sayfasının Etkin geliştirici önizlemeleri bölümündeki bağlantılı IssueTracker üzerinden 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 birlikte 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: