Bu belgede, Google Classroom API'ye özel yetkilendirme ve kimlik doğrulama bilgileri yer almaktadır. Bu dokümanı okumadan önce Kimlik doğrulama ve yetkilendirme hakkında bilgi edinme başlıklı makalede Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgilerini okuyun.
Yetkilendirme için OAuth 2.0'ı yapılandırma
Kullanıcılara ve uygulama incelemecilerine hangi bilgilerin gösterileceğini tanımlamak için OAuth kullanıcı rızası ekranını yapılandırın ve kapsamları seçin. Ardından, uygulamanızı daha sonra yayınlayabilmek için kaydedin.
Classroom API kapsamları
Uygulamanıza verilen erişim düzeyini tanımlamak için yetkilendirme kapsamlarını tanımlamanız ve beyan etmeniz gerekir. Yetkilendirme kapsamı, Google Workspace uygulamasının adını, eriştiği veri türünü ve erişim düzeyini içeren bir OAuth 2.0 URI dizesidir. Kapsamlar, uygulamanızın kullanıcıların Google Hesabı verileri de dahil olmak üzere Google Workspace verileriyle çalışma istekleridir.
Uygulamanız yüklendiğinde kullanıcıdan uygulama tarafından kullanılan kapsamları doğrulaması istenir. Genel olarak, mümkün olan en dar kapsamı seçmeli ve uygulamanızın gerektirmediği kapsamları istemekten kaçınmalısınız. Kullanıcılar, sınırlı ve açıkça açıklanan kapsamlara daha kolay erişim izni verir.
Classroom API aşağıdaki kapsamları destekler:
| Kapsamlar | Anlamı |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher
|
Google Classroom'da ders verdiğiniz sınıflardaki öğeleri yayınlamak için istek gönderen Google Cloud projesinin eklerine erişebilir, ek oluşturabilir ve ekleri güncelleyebilirsiniz. |
https://www.googleapis.com/auth/classroom.addons.student
|
İstekte bulunan Google Cloud projesinin Google Classroom'da öğe yayınlamak için kullandığı ekleri görme ve güncelleme |
https://www.googleapis.com/auth/classroom.announcements
|
Google Classroom'daki duyuruları görüntüleyip yönetebilirsiniz. |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
Google Classroom'da duyuruları görüntüleyin. |
https://www.googleapis.com/auth/classroom.courses
|
Google Classroom sınıflarınızı görme, düzenleme, oluşturma ve kalıcı olarak silme |
https://www.googleapis.com/auth/classroom.courses.readonly
|
Google Classroom sınıflarınızı görüntüleyin. |
https://www.googleapis.com/auth/classroom.coursework.me
|
Ödev, soru ve not gibi sınıf çalışması öğelerini görme, oluşturma ve düzenleme |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Google Classroom'da sınıf çalışmalarınızı ve notlarınızı görüntüleyin. |
https://www.googleapis.com/auth/classroom.coursework.students
|
Ders verdiğiniz Google Classroom sınıflarındaki öğrencilerin sınıf çalışmalarını ve notlarını yönetme ve yönettiğiniz sınıfların sınıf çalışmalarını ve notlarını görüntüleme |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Ders verdiğiniz veya yönettiğiniz Google Classroom sınıflarındaki öğrencilerin sınıf çalışmalarını ve notlarını görüntüleme |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Google Classroom'da sınıf çalışması materyallerini görme, düzenleme ve oluşturma |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
Google Classroom sınıflarınızla ilgili tüm sınıf çalışması materyallerini görme |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
Google Classroom koruyucularınızı görüntüleyin. |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Google Classroom sınıflarınızdaki öğrencilerin koruyucularını görüntüleyebilir ve yönetebilirsiniz. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Google Classroom sınıflarınızdaki öğrencilerin koruyucularını görüntüleyin. |
https://www.googleapis.com/auth/classroom.profile.emails
|
Sınıflarınızdaki kişilerin e-posta adreslerini görüntüleyin. |
https://www.googleapis.com/auth/classroom.profile.photos
|
Sınıflarınızdaki kişilerin profil fotoğraflarını görüntüleyin. |
https://www.googleapis.com/auth/classroom.push-notifications
|
Google Classroom verilerinizle ilgili bildirimler alma |
https://www.googleapis.com/auth/classroom.rosters
|
Google Classroom sınıflarınızdaki katılımcı listesini yönetebilirsiniz. |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Google Classroom sınıflarınızdaki katılımcı listesini görüntüleyin. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Google Classroom'da sınıf çalışmalarınızı ve notlarınızı görüntüleyin. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Ders verdiğiniz veya yönettiğiniz Google Classroom sınıflarındaki öğrencilerin sınıf çalışmalarını ve notlarını görüntüleme |
https://www.googleapis.com/auth/classroom.topics
|
Google Classroom'da konuları inceleyin, oluşturun ve düzenleyin. |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Google Classroom'da konuları görüntüleyin. |