Google Classroom API, yazılım geliştiricilerin, yöneticilerin ve okul yöneticilerinin Google Classroom kaynaklarını yönetmesi için bir programlama arayüzü sağlar. Classroom kurslarını ve içeriklerini oluşturan, alan ve değiştiren yazılımlar geliştirebilirsiniz.
Tipik kullanım alanlarından bazıları şunlardır:
- Kursları, öğrenci listelerini ve velileri yönetme
- Ödev, duyuru ve ders materyali ekleme
- Not verme ve notlandırma ayarlarını değiştirme
- Analiz için veri oluşturma
- Dışarıdan bir sağlayıcının içeriğini veya araçlarını Classroom'da keşfedilebilir ve erişilebilir hale getirme
Classroom API benim için doğru çözüm mü?
Google, Classroom ile etkileşim kurmanıza yardımcı olacak çeşitli ürünler sunar. Aşağıda, sık karşılaşılan bazı senaryolar ve ihtiyaçlarınıza en uygun olabilecek ürünlerle ilgili öneriler verilmiştir.
Google Classroom kaynaklarını değiştirme
| Senaryo | Önerilen çözümler |
|---|---|
| Çok sayıda kurs, kullanıcı veya diğer Classroom kaynaklarını düzenli olarak yönetmek istiyorum. Kod yazma ve yazılım altyapısını yönetme konusunda kendimi rahat hissediyorum. | Classroom API'yi kullanan uygulamalar yazın. |
| Ara sıra az miktarda Classroom kaynağı yönetmek istiyorum. Az sayıda kod satırı yazmayı ve bu kodların çok fazla kaynak tüketmemesini sağlıyorum. | Classroom API'yi Google Apps Komut Dosyası ile kullanın. |
| Bazen Classroom kaynaklarında değişiklik yapmak istiyorum. Terminal komutlarıyla rahatça çalışabiliyorum. | Google Apps Manager'ı kullanın. |
| Classroom'daki etkinliklerle ilgili ayrıntıları içeren çok sayıda rapor istiyorum. | BigQuery Veri Aktarım Hizmeti'ni kullanın. |
| Kullanıcılarımın etkinliğiyle ilgili bir inceleme yapmak istiyorum. | Yönetici Konsolu'nda rapor oluşturun veya Raporlar API'sini kullanın. |
Google Classroom ile entegrasyon
| Senaryo | Önerilen çözümler |
|---|---|
| Öğretmenlerin ve öğrencilerin Classroom'da içeriklerimi görüp başlatmasını istiyorum. | Classroom eklentisi oluşturun. |
| Öğretmenlerin web sitemde veya uygulamamda Classroom'a içerik yerleştiren bir düğmeyi tıklamasını istiyorum. | Classroom eklentisi oluşturun ve programlı olarak ek oluşturun. |
| Öğretmenlerin, web sitemdeki veya uygulamamdaki bir düğmeyi tıklayarak Classroom'daki içeriğime bağlantı oluşturmasını istiyorum. | Classroom API'yi kullanarak ders ödevi oluşturun veya Classroom'da Paylaş düğmelerini yerleştirin. |
| Classroom öğretmenlerinin, Öğrenci Bilgi Sistemimdeki bilgileri senkronize etmesini veya içe aktarmasını istiyorum. | ÖBS için OneRoster'u uygulayın veya Classroom API'yi kullanarak kaynaklar oluşturup bunlara erişin. |
Başlarken
Yeni geliştiricilerin yeni bir projeye başlamadan önce aşağıdakileri yapmaları önerilir:
- Classroom API yapısı ile ilgili kılavuzumuzu okuyun.
- Notlar, kullanıcı türleri, kullanıcı uygunluğu ve yönetici işlemleri hakkında bilgi edinin. Bu kılavuzlarda, Google Classroom ve Classroom API'ye özgü kavramlar açıklanmaktadır.
- Classroom API isteklerinin işleyiş şeklini öğrenin.
Geliştirmeye başlamak için önkoşul adımlarını tamamladığınızdan emin olun. İhtiyaçlarınıza uygun Classroom API kapsamlarını seçin, ardından ortamınızı kurun ve aşağıdaki hızlı başlangıç kılavuzlarından birini uygulayarak istek göndermeye başlayın:
Google API Gezgini ile deneme yapma
Canlı verilerde çağrı yöntemlerini denemek için Google API'leri Gezgini'ni kullanmayı deneyin. Başlamak için kod yazmanız gerekmez ancak API Gezgini'ni kullanarak gerçekleştirdiğiniz işlemlerin mevcut verileri değiştirebileceğini unutmayın.
Yöntemleri çağırmaya başlamanın bir yolu courses.list() yöntemini çağırmaktır. Bu yöntem için istek parametresi gerekmez. Diğer API çağrıları için istek parametresi olarak kullanmak üzere döndürülen kurs listesinden bir id alabilirsiniz. Kursunuz yoksa courses.create() yöntemini kullanarak kurs oluşturabilirsiniz.
Classroom API referansını da inceleyebilirsiniz.