Herhangi bir geliştirici Google Classroom API'ye istekte bulunabilir ancak bazı Google Classroom özellikleri yalnızca belirli kullanıcılar tarafından kullanılabilir. Her özellik için belirli bir Google Workspace for Education lisans türüne sahip olma gibi farklı şartlar olabilir. Her Google Workspace for Education lisans düzeyindeki özelliklerin ayrıntılı dökümü için sürümlerin karşılaştırması sayfasına bakın.
Uygunluk koşulları olan özellikler
Aşağıdaki Classroom API özellikleri yalnızca uygun kullanıcılar tarafından kullanılabilir:
- Classroom eklenti eklerini oluşturma ve değiştirme
- Notlandırma dönemi ayarlarını değiştirme
- Değerlendirme ölçütleri oluşturma, değiştirme ve silme
Kullanıcı özelliklerini belirleme
Classroom API'ye yapılan istekler, bağımsız kullanıcılar adına yapılır. Bu nedenle, uygunluk koşulları içeren API istekleri göndermeden önce kullanıcının uygun özelliklere sahip olup olmadığını kontrol etmeniz gerekir.
Bir kullanıcının belirli bir özelliği olup olmadığını belirlemek için checkUserCapability yöntemine bir API isteği gönderin. Kullanmayı planladığınız Classroom özelliği için uygun Capability türünü ekleyin. Her özellik için uygun Capability değerini belirtin:
| Kullanıcının... | Capability |
|---|---|
| İsteği yapmak için kullanılan OAuth istemci kimliğinin Google Cloud projesiyle ilişkili bir Classroom eklenti eki oluşturabilir veya değiştirebilir. | CREATE_ADD_ON_ATTACHMENT |
| Notlandırma dönemi ayarlarını değiştirebilir. | UPDATE_GRADING_PERIOD_SETTINGS |
| Puan anahtarı oluşturabilir, değiştirebilir veya silebilir. | CREATE_RUBRIC |
Ardından, yanıttaki allowed alanını kontrol edin. allowed true ise kullanıcı, seçilen Capability'ye erişebilir. Ardından, kullanıcı adına Capability ile ilgili API istekleri gönderebilirsiniz.