Pilih cakupan Google Classroom API

Dokumen ini berisi informasi otorisasi dan autentikasi khusus Google Classroom API. Sebelum membaca dokumen ini, pastikan Anda membaca informasi otorisasi dan autentikasi umum Google Workspace di Pelajari autentikasi dan otorisasi.

Mengonfigurasi OAuth 2.0 untuk otorisasi

Konfigurasi layar izin OAuth dan pilih cakupan untuk menentukan informasi yang ditampilkan kepada pengguna dan peninjau aplikasi, serta daftarkan aplikasi agar Anda dapat memublikasikannya nanti.

Cakupan Classroom API

Untuk menentukan tingkat akses yang diberikan ke aplikasi, Anda perlu mengidentifikasi dan mendeklarasikan cakupan otorisasi. Cakupan otorisasi adalah string URI OAuth 2.0 yang berisi nama aplikasi Google Workspace, jenis data yang diakses, dan tingkat aksesnya. Cakupan adalah permintaan aplikasi Anda untuk menangani data Google Workspace, termasuk data Akun Google pengguna.

Saat aplikasi diinstal, pengguna akan diminta untuk memvalidasi cakupan yang digunakan oleh aplikasi. Umumnya, Anda harus memilih cakupan yang paling terfokus dan menghindari permintaan cakupan yang tidak diperlukan aplikasi. Pengguna lebih mudah memberikan akses ke cakupan yang terbatas dan dijelaskan dengan jelas.

Jika aplikasi publik Anda menggunakan cakupan yang mengizinkan akses ke data pengguna tertentu, aplikasi tersebut harus menyelesaikan proses verifikasi. Jika melihat aplikasi yang belum diverifikasi di layar saat menguji aplikasi, Anda harus mengirimkan permintaan verifikasi untuk menghapusnya. Cari tahu selengkapnya tentang aplikasi yang belum diverifikasi dan dapatkan jawaban atas pertanyaan umum (FAQ) tentang verifikasi aplikasi di Pusat Bantuan.

Classroom API mendukung cakupan berikut:

Cakupan	Arti
https://www.googleapis.com/auth/classroom.announcements	Lihat dan kelola pengumuman di Google Classroom.
https://www.googleapis.com/auth/classroom.announcements.readonly	Lihat pengumuman di Google Classroom.
https://www.googleapis.com/auth/classroom.courses	Melihat, mengedit, membuat, dan menghapus kelas Google Classroom Anda secara permanen.
https://www.googleapis.com/auth/classroom.courses.readonly	Melihat kelas di Google Classroom.
https://www.googleapis.com/auth/classroom.coursework.me	Melihat, membuat, dan mengedit item tugas, termasuk tugas, pertanyaan, dan nilai.
https://www.googleapis.com/auth/classroom.coursework.me.readonly	Melihat tugas dan nilai Anda di Google Classroom.
https://www.googleapis.com/auth/classroom.coursework.students	Mengelola tugas dan nilai bagi siswa di kelas Google Classroom yang Anda ajar, serta melihat tugas dan nilai untuk kelas yang Anda kelola.
https://www.googleapis.com/auth/classroom.coursework.students.readonly	Melihat tugas dan nilai siswa di kelas Google Classroom yang Anda ajar atau kelola.
https://www.googleapis.com/auth/classroom.courseworkmaterials	Melihat, mengedit, dan membuat materi tugas kelas di Google Classroom.
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly	Melihat semua materi tugas kelas untuk kelas Google Classroom Anda.
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly	Melihat wali Google Classroom Anda.
https://www.googleapis.com/auth/classroom.guardianlinks.students	Lihat dan kelola wali siswa di kelas Google Classroom Anda.
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly	Lihat wali siswa di kelas Google Classroom Anda.
https://www.googleapis.com/auth/classroom.profile.emails	Melihat alamat email orang di kelas Anda.
https://www.googleapis.com/auth/classroom.profile.photos	Melihat foto profil orang-orang di kelas Anda.
https://www.googleapis.com/auth/classroom.push-notifications	Terima notifikasi tentang data Google Classroom Anda.
https://www.googleapis.com/auth/classroom.rosters	Mengelola daftar nama siswa kelas di Google Classroom.
https://www.googleapis.com/auth/classroom.rosters.readonly	Melihat daftar nama kelas di Google Classroom.
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly	Melihat tugas dan nilai Anda di Google Classroom.
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly	Melihat tugas dan nilai siswa di kelas Google Classroom yang Anda ajar atau kelola.
https://www.googleapis.com/auth/classroom.topics	Melihat, membuat, dan mengedit topik di Google Classroom.
https://www.googleapis.com/auth/classroom.topics.readonly	Lihat topik di Google Classroom.