Anda dapat merujuk kursus dengan nama yang berbeda dengan resource Alias Kursus. Alias Kursus adalah pemetaan antara ID kursus Google Classroom dan ID kursus eksternal.
Sebaiknya setiap kali Anda membuat kursus dari SIS atau menautkan kursus ke SIS, courseID SIS digunakan sebagai alias kursus. Classroom API
memungkinkan Anda melakukannya secara langsung dalam pembuatan kursus dengan menentukan parameter id
kursus tersebut sebagai alias. Jika alias sudah ada, pembuatan kursus akan gagal dengan error ALREADY_EXISTS (409)
. Hal ini akan mencegah pembuatan kursus duplikat
jika ada bug dalam program sinkronisasi.
Alias hadir dalam dua ragam: seluruh domain dan seluruh project.
- Alias seluruh domain menggunakan awalan
d:
dan dapat dilihat oleh siapa saja menggunakan Classroom API. - Alias seluruh project menggunakan awalan
p:
dan hanya dapat dilihat serta digunakan oleh aplikasi (project konsol developer) yang membuatnya.
Alias dapat digunakan di mana saja dalam API yang mengharapkan ID kursus. Artinya, setelah alias didaftarkan menggunakan API, alias tersebut dapat digunakan untuk membaca dan mengubah kursus dan informasi daftar nama siswa.
Dari perspektif sinkronisasi SIS, ini berarti ID internal SIS untuk kursus dapat didaftarkan sebagai alias seluruh domain untuk kursus tersebut. Dengan demikian, developer yang terintegrasi dengan SIS dan Classroom cukup menggunakan ID SIS untuk berinteraksi dengan data Classroom.
Misalnya, jika kami menganggap 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
.
Tambahkan alias untuk kursus baru
Untuk menambahkan alias untuk kursus baru, tetapkan course.id
ke alias yang diinginkan 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 alias
ke nama alias yang diinginkan
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 ditunjukkan pada
contoh berikut:
.NET
Java
Python