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 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 ve değiştirme
- Notlandırma dönemi ayarlarını değiştirme
- Notlandırmalar oluşturma, değiştirme ve silme.
Kullanıcı özelliklerini belirleme
Classroom API'ye gönderilen istekler bireysel 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 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 |
|---|---|
| İsteği göndermek için kullanılan OAuth istemci kimliğinin Google Cloud projesiyle ilişkili bir Classroom eklentisi 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.