Tüm geliştiriciler Google Classroom API'ye istek gönderebilir ancak bazı Google Classroom özellikleri yalnızca belirli kullanıcılar tarafından kullanılabilir. Her özelliğin belirli bir Google Workspace for Education lisans türüne sahip olmak gibi farklı koşulları olabilir. Her bir Google Workspace for Education lisans düzeyindeki özelliklerin ayrıntılı dökümünü görmek için sürüm karşılaştırma sayfasına göz atın.
Uygunluk koşulları olan özellikler
Aşağıdaki Classroom API özellikleri yalnızca uygun kullanıcılar tarafından kullanılabilir:
- Classroom eklentisi ekleri oluşturma
- Notlandırma dönemi ayarlarını değiştirme
- Ölçütler oluşturma, güncelleme ve silme
Kullanıcı özelliklerini belirleme
Classroom API'ye yapılan istekler, kullanıcılar adına gönderilir. 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 yetkiye sahip olup olmadığını belirlemek için checkUserCapability yöntemine API isteği gönderin. Kullanmak istediğiniz 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 |
|---|---|
| İstekte bulunan Google Cloud projesinin sahip olduğu bir Classroom eklentisine erişimi olmalıdır. | CREATE_ADD_ON_ATTACHMENT |
| Notlandırma dönemi ayarlarını değiştirebilir | UPDATE_GRADING_PERIOD_SETTINGS |
| Puan anahtarı oluşturabilir veya değiştirebilir | 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.