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.
ÖBS'den ders oluşturduğunuzda veya bir ÖBS'ye ders bağladığınızda, ders takma adı olarak ÖBS'nin kurs kimliğinin 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 ders oluşturma işlemi ALREADY_EXISTS (409)
hatası vererek başarısız olur. Bu, senkronizasyon programında bir hata olması durumunda yinelenen kursların oluşturulmasını önler.
Takma adların iki biçimi vardır: 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:
önekini 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ı gerektiren herhangi bir 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. Bu şekilde, 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 ders 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 derse eklemek için alias
öğesini istediğiniz takma ada 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