Ders takma adı kullanarak derslere farklı bir adla referans verebilirsiniz. Kurs takma adları, Google Classroom kurs tanımlayıcıları ile harici kurs tanımlayıcıları arasında eşleme işlevi görebilir. Örneğin, bir öğrenci bilgi sisteminden (ÖBS) alınan ders kimliğiyle eşleşecek şekilde bir ders takma adı ayarlayabilirsiniz.
Kurs takma adının iki biçimi vardır: alan genelinde ve proje genelinde.
Alan genelindeki takma adlar
d:
ön ekini kullanır ve Classroom API'yi kullanan herkes tarafından görülebilir. Alan adlandırma alanı, tüm kullanıcıların erişmesi gereken ancak belirli bir programa özgü olmayan takma adlar oluşturmak için kullanışlıdır. Örneğin, bir dersin alternatif girişleri (ör. MATH 127 ve COMSCI 127) alan ad alanı adında oluşturulmalıdır. Alan adlandırma alanındaki takma adlar yalnızca alan yöneticileri tarafından oluşturulabilir ancak alan adındaki tüm kullanıcılar tarafından görülebilir.Proje genelindeki takma adlar
p:
ön ekiyle başlar ve yalnızca onları oluşturan Google Cloud projesi tarafından görülebilir ve kullanılabilir. Geliştirici projesi ad alanı, bir uygulamaya özgü takma adları yönetmek için kullanışlıdır. Örneğin, kurslar için alternatif tanımlayıcılar kullanan bir uygulama, tanımlayıcısını Classroom kurslarıyla eşlemek için takma adlar oluşturabilir. Bu ad alanında oluşturulan takma adlar belirli bir Google Cloud projesine bağlıdır. Bir uygulamanın tüm kullanıcıları, söz konusu uygulamanın geliştirici projesinin ad alanında takma ad oluşturabilir ve görüntüleyebilir.
Herhangi bir Classroom API uç noktası için Classroom kurs kimliğinin yerine kurs takma adı kullanılabilir. Bu, takma adların kurs ve öğrenci listesi bilgilerini okumak ve değiştirmek için kullanılabileceği anlamına gelir.
Öğrenci bilgi sistemleriyle senkronizasyon için takma ad kullanma
Bir kursun ÖBS'deki dahili tanımlayıcı, kurs için alan genelinde bir takma ad olarak kaydedilebilir. Böylece, hem ÖBS hem de Classroom ile entegrasyon yapan tüm geliştiriciler, Classroom verileriyle etkileşimde bulunmak için ÖBS tanımlayıcısını kullanabilir.
ÖBS'den kurs oluşturuyorsanız veya bir kursu ÖBS'ye bağlıyorsanız kurs takma adı olarak ÖBS'nin kurs kimliğinin kullanılması önerilir. courses.create()
yöntemini kullanarak kurs oluştururken isteğin id
alanında takma adı belirtebilirsiniz. Takma ad zaten mevcutsa kurs oluşturma işlemi 409 ALREADY_EXISTS
hatasıyla başarısız olur. Bu, senkronizasyon programında bir sorun olması durumunda kopya kursların oluşturulmasını önler.
Ö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 bir 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
alanını 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