Pilih cakupan Google Classroom API

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

Mengonfigurasi OAuth 2.0 untuk otorisasi

Mengonfigurasi layar izin OAuth dan memilih cakupan untuk menentukan informasi yang ditampilkan kepada pengguna dan peninjau aplikasi, serta mendaftarkan aplikasi Anda agar dapat dipublikasikan nanti.

Cakupan Classroom API

Untuk menentukan tingkat akses yang diberikan ke aplikasi Anda, 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 akses. Cakupan adalah permintaan aplikasi Anda untuk menggunakan data Google Workspace, termasuk data Akun Google pengguna.

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

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

Classroom API mendukung cakupan berikut:

Cakupan	Arti
https://www.googleapis.com/auth/classroom.addons.teacher	Melihat, membuat, dan memperbarui lampiran project Google Cloud yang meminta item streaming di kelas yang Anda ajar di Google Classroom.
https://www.googleapis.com/auth/classroom.addons.student	Melihat dan memperbarui lampiran project Google Cloud yang meminta untuk mengalirkan item di Google Classroom.
https://www.googleapis.com/auth/classroom.announcements	Melihat dan mengelola pengumuman di Google Kelas.
https://www.googleapis.com/auth/classroom.announcements.readonly	Melihat 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 Google Kelas Anda.
https://www.googleapis.com/auth/classroom.coursework.me	Melihat, membuat, dan mengedit item tugas kursus 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 dalam kelas Google Kelas 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 bagi 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 Google Classroom Anda.
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly	Melihat wali Google Kelas Anda.
https://www.googleapis.com/auth/classroom.guardianlinks.students	Melihat dan mengelola wali siswa di kelas Google Kelas Anda.
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly	Melihat wali siswa di kelas Anda di Google Kelas.
https://www.googleapis.com/auth/classroom.profile.emails	Melihat alamat email orang-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	Menerima notifikasi tentang data Google Kelas Anda.
https://www.googleapis.com/auth/classroom.rosters	Mengelola daftar nama kelas Google Kelas Anda.
https://www.googleapis.com/auth/classroom.rosters.readonly	Melihat daftar nama kelas Google Kelas Anda.
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 bagi 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	Melihat topik di Google Classroom.