Anda dapat merujuk kursus dengan nama lain menggunakan alias kursus. Alias kursus dapat berfungsi sebagai pemetaan antara ID kursus Google Classroom dan ID kursus eksternal. Misalnya, Anda dapat menetapkan alias kursus agar cocok dengan ID kursus dari Sistem Informasi Siswa (SIS).
Alias kursus memiliki dua bentuk: tingkat domain dan tingkat project.
Alias tingkat domain menggunakan awalan
d:
dan dapat dilihat oleh siapa pun yang menggunakan Classroom API. Namespace domain berguna untuk membuat alias yang perlu diakses semua pengguna, tetapi tidak spesifik untuk program tertentu. Misalnya, listingan alternatif untuk kursus, seperti MATH 127 dan COMSCI 127, harus dibuat di namespace domain. Alias di namespace domain hanya dapat dibuat oleh administrator domain, tetapi dapat dilihat oleh semua pengguna di domain.Alias di seluruh project menggunakan awalan
p:
dan hanya dapat dilihat dan digunakan oleh project Google Cloud yang membuatnya. Namespace project developer berguna untuk mengelola alias khusus untuk aplikasi. Misalnya, aplikasi yang menggunakan ID alternatif untuk kursus dapat membuat alias untuk memetakan ID-nya ke kursus Classroom. Alias yang dibuat di namespace ini terikat ke project Google Cloud tertentu. Setiap pengguna aplikasi dapat membuat dan melihat alias di namespace untuk project developer aplikasi tersebut.
Alias kursus dapat digunakan sebagai pengganti ID kursus Classroom untuk endpoint Classroom API apa pun. Artinya, alias dapat digunakan untuk membaca dan mengubah informasi kursus dan daftar nama siswa.
Menggunakan alias untuk sinkronisasi dengan Sistem Informasi Siswa
ID internal SIS untuk kursus dapat didaftarkan sebagai alias di seluruh domain untuk kursus tersebut. Dengan begitu, setiap developer yang terintegrasi dengan SIS dan Classroom dapat menggunakan ID SIS untuk berinteraksi dengan data Classroom.
Jika Anda membuat kursus dari SIS atau menautkan kursus ke SIS, sebaiknya ID kursus SIS digunakan sebagai alias kursus. Saat membuat kursus menggunakan metode courses.create()
, Anda dapat menentukan alias di kolom id
permintaan. Jika alias sudah ada, pembuatan kursus
akan gagal dengan error 409 ALREADY_EXISTS
. Hal ini mencegah pembuatan
kursus duplikat jika ada masalah dalam program sinkronisasi.
Misalnya, jika kita mengasumsikan nama SIS adalah school
dan ID internal
yang digunakan oleh SIS untuk kursus tertentu adalah math_101
, Anda dapat membuat alias
sebagai d:school_math_101
.
Menambahkan alias untuk kursus baru
Untuk menambahkan alias untuk kursus baru, tetapkan course.id
ke alias saat
membuat permintaan courses.create()
.
Apps Script
Java
Python
Menambahkan alias untuk kursus yang ada
Untuk menambahkan alias pada kursus yang sudah ada, Anda dapat menetapkan kolom alias
dan menggunakan metode courses.aliases.create()
.
Apps Script
Java
Python
Mengambil alias kursus
Anda dapat mengambil alias untuk kursus menggunakan metode
courses.aliases.list()
, seperti yang ditunjukkan dalam contoh
berikut:
.NET
Java
Python