Kurs Takma Adı kaynağı ile kurslara farklı bir adla başvurabilirsiniz. Kurs Takma Adları, Google Classroom ders tanımlayıcıları ile harici kurs tanımlayıcıları arasındaki eşlemedir.
Bir ÖBS'den ders oluşturduğunuzda veya bir dersi ÖBS'ye bağladığınızda, kurs takma adı olarak ÖBS'nin ders kimliğinin kullanılmasını öneririz. Classroom API, takma ad olarak kursun id
parametresini belirterek ders oluşturma sırasında bunu doğrudan yapmanıza olanak tanır. Takma ad zaten mevcutsa ders oluşturma işlemi ALREADY_EXISTS (409)
hatasıyla başarısız olur. Bu, senkronizasyon programında bir hata olması halinde yinelenen kurslar oluşturulmasını önler.
Takma adlar iki şekilde sunulur: alan genelinde ve proje genelinde.
- Alan adı genelindeki takma adlar,
d:
önekini kullanır ve Classroom API'yi kullanan herkes tarafından görülebilir. - Proje genelindeki takma adlar,
p:
ön ekini kullanır ve yalnızca bunları oluşturan uygulama (geliştirici konsolu projesi) tarafından görülüp kullanılabilir.
Takma adlar, API'de kurs tanımlayıcısı bekleyen her yerde kullanılabilir. Yani API kullanılarak bir takma ad kaydedildikten sonra bu takma ad, kursları ve öğrenci listesi bilgilerini okuyup değiştirmek için kullanılabilir.
ÖBS senkronizasyonu açısından bakıldığında, bir dersin ÖBS dahili tanımlayıcısının ders için alan genelinde takma ad olarak kaydedilebileceği anlamına gelir. Bu sayede, hem ÖBS hem de Classroom ile entegre olan tüm geliştiriciler ÖBS tanımlayıcısını kullanarak Classroom verileriyle etkileşimde bulunabilir.
Örneğin, ÖBS adının school
ve ÖBS'nin belirli bir ders için kullandığı dahili tanımlayıcının math_101
olduğunu varsayarsak d:school_math_101
olarak takma ad oluşturabilirsiniz.
Yeni bir ders için takma ad ekleme
Yeni bir kursa takma ad eklemek için, courses.create()
isteğinde bulunurken course.id
için istediğiniz takma adı belirleyin.
Apps Komut Dosyası
Java
Python
Mevcut bir ders için takma ad ekleme
Mevcut bir kursa takma ad eklemek için alias
'yi istediğiniz takma adla ayarlayabilir ve courses.aliases.create()
yöntemini kullanabilirsiniz.
Apps Komut Dosyası
Java
Python
Ders takma adlarını alma
Bir kurs için takma adları, aşağıdaki örnekte gösterildiği gibi courses.aliases.list()
yöntemini kullanarak alabilirsiniz:
.NET
Java
Python