Kurs Takma Adı kaynağı ile kurslara farklı bir adla referans verebilirsiniz. Ders takma adları, Google Classroom ders tanımlayıcıları ile harici ders tanımlayıcıları arasında bir eşlemedir.
Bir ÖBS'den kurs oluşturduğunuzda veya bir kursu ÖBS'ye bağladığınızda kurs takma adı olarak ÖBS'nin courseID değerinin kullanılmasını öneririz. Classroom API, kurs için id
parametresini takma ad olarak belirterek bu işlemi doğrudan kurs oluşturma işlemi sırasında yapmanıza olanak tanır. Takma ad zaten mevcutsa kurs oluşturma işlemi ALREADY_EXISTS (409)
hatasıyla başarısız olur. Bu, senkronizasyon programında bir hata olması durumunda yinelenen kursların oluşturulmasını önler.
Takma adlar iki şekilde kullanılabilir: alan genelinde ve proje genelinde.
- Alan genelindeki takma adlar
d:
önekini kullanır ve Classroom API'yi kullanan herkes tarafından görülebilir. - Proje genelindeki takma adlar
p:
ön ekiyle başlar ve yalnızca bunları oluşturan uygulama (Developers Console projesi) tarafından görülebilir ve kullanılabilir.
Takma adlar, API'de kurs tanımlayıcısı beklenen her yerde kullanılabilir. Bu, API kullanılarak kaydedilen bir takma ad, kurs ve liste bilgilerini okumak ve değiştirmek için kullanılabileceği anlamına gelir.
ÖBS senkronizasyonu açısından bu, bir kursun ÖBS'deki dahili tanımlayıcısının, kurs için alan genelinde bir takma ad olarak kaydedilebileceği anlamına gelir. Böylece, hem ÖBS hem de Classroom ile entegrasyon yapan tüm geliştiriciler, Classroom verileriyle etkileşime geçmek için ÖBS tanımlayıcısını kullanabilir.
Örneğin, ÖBS adının school
ve ÖBS'nin belirli bir kurs için kullandığı dahili tanımlayıcının math_101
olduğunu varsayarsak d:school_math_101
olarak bir takma ad oluşturabilirsiniz.
Yeni bir kurs için takma ad ekleme
Yeni bir kurs için takma ad eklemek istiyorsanız courses.create()
isteğini gönderirken course.id
değerini istediğiniz takma ada ayarlayın.
Apps Komut Dosyası
Java
Python
Mevcut bir kurs için takma ad ekleme
Takma adı mevcut bir kursa eklemek için alias
değerini istediğiniz takma ad olarak ayarlayabilir ve courses.aliases.create()
yöntemini kullanabilirsiniz.
Apps Komut Dosyası
Java
Python
Kurs takma adlarını alma
Aşağıdaki örnekte gösterildiği gibi courses.aliases.list()
yöntemini kullanarak bir dersin takma adlarını alabilirsiniz:
.NET
Java
Python