Bu belgede, Google Classroom API'ye özel yetkilendirme ve kimlik doğrulama bilgileri yer almaktadır. Bu belgeyi okumadan önce Kimlik doğrulama ve yetkilendirme hakkında bilgi başlıklı makalede Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgilerini okuduğunuzdan emin olun.
Yetkilendirme için OAuth 2.0'ı yapılandırma
Kullanıcılara ve uygulama inceleyicilerine hangi bilgilerin gösterileceğini tanımlamak için OAuth izin ekranını yapılandırın ve kapsamları seçin. Ayrıca, 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ı belirleyip beyan etmeniz gerekir. Yetkilendirme kapsamı, Google Workspace uygulama 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ışmak için yaptığı isteklerdir.
Uygulamanız yüklendiğinde, kullanıcıdan uygulama tarafından kullanılan kapsamları doğrulaması istenir. Genellikle, 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 net bir şekilde açıklanmış 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 yayınlarda, istekte bulunan Google Cloud projesinin eklerini görme, oluşturma ve güncelleme |
https://www.googleapis.com/auth/classroom.addons.student
|
İstek gönderen Google Cloud projesinin, Google Classroom'daki yayın öğelerine eklerini görme ve güncelleme |
https://www.googleapis.com/auth/classroom.announcements
|
Google Classroom'daki duyuruları görüntüleme ve yönetme |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
Google Classroom'daki duyuruları görüntüleme |
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'daki sınıf çalışmalarınızı ve notlarınızı görüntüleme |
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, 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'daki 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üleme |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Google Classroom sınıflarınızdaki öğrencilerin velilerini görüntüleme ve yönetme |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Google Classroom sınıflarınızdaki öğrencilerin velilerini görüntüleme |
https://www.googleapis.com/auth/classroom.profile.emails
|
Sınıflarınızdaki kişilerin e-posta adreslerini görüntüleme |
https://www.googleapis.com/auth/classroom.profile.photos
|
Sınıflarınızdaki kişilerin profil fotoğraflarını görüntüleme |
https://www.googleapis.com/auth/classroom.push-notifications
|
Google Classroom verileriniz hakkında bildirimler alma |
https://www.googleapis.com/auth/classroom.rosters
|
Google Classroom sınıflarınızdaki katılımcı listesini yönetme |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Google Classroom sınıflarınızdaki katılımcı listesini görüntüleme |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Google Classroom'daki sınıf çalışmalarınızı ve notlarınızı görüntüleme |
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üleme |