Zajęcia możesz oznaczać inną nazwą, używając aliasu zajęć. Aliasy kursów mogą służyć do mapowania identyfikatorów kursów w Google Classroom i identyfikatorów kursów zewnętrznych. Możesz na przykład ustawić alias zajęć, który będzie pasował do identyfikatora zajęć z systemu informacji o uczniach.
Alias kursu może mieć 2 formy: w całej domenie i w całym projekcie.
Aliasy w całej domenie używają prefiksu
d:
i mogą być widoczne dla każdego, kto korzysta z interfejsu Classroom API. Nazwa domeny jest przydatna do tworzenia aliasów, do których wszyscy użytkownicy muszą mieć dostęp, ale które nie są specyficzne dla żadnego programu. Na przykład alternatywne listy kursów, takie jak MATH 127 i COMSCI 127, powinny być tworzone w przestrzeni nazw domeny. Aliasy w przestrzeni nazw domeny mogą tworzyć tylko administratorzy domeny, ale są one widoczne dla wszystkich użytkowników w domenie.Aliasy ogólne projektu mają prefiks
p:
i mogą być widoczne oraz używane tylko przez projekt Google Cloud, który je utworzył. Przestrzeń nazw projektu dewelopera jest przydatna do zarządzania aliasami konkretnymi dla danej aplikacji. Na przykład aplikacja, która używa alternatywnych identyfikatorów zajęć, może utworzyć aliasy, aby zmapować swój identyfikator z zajęciami w Classroom. Aliasy utworzone w tej przestrzeni nazw są powiązane z konkretnym projektem Google Cloud. Każdy użytkownik aplikacji może tworzyć i wyświetlać aliasy w przestrzeni nazw projektu dewelopera tej aplikacji.
Zamiast identyfikatora zajęć w Classroom można użyć aliasu zajęć w dowolnym punkcie końcowym interfejsu Classroom API. Oznacza to, że alias może służyć do odczytu i modyfikacji informacji o kursach i listach.
Używanie aliasu do synchronizacji z systemami informacji o uczniach
Identyfikator wewnętrzny kursu w systemie informacji o uczniach może być zarejestrowany jako alias kursu w całej domenie. Dzięki temu każdy deweloper, który integruje się z systemem informacji o uczniach i Classroom, może używać identyfikatora systemu informacji o uczniach do interakcji z danymi Classroom.
Jeśli tworzysz kurs na podstawie systemu informacji o uczniach (SIS) lub łączysz kurs z systemem SIS, zalecamy użycie identyfikatora kursu systemu SIS jako aliasu kursu. Podczas tworzenia kursu za pomocą metody courses.create()
możesz podać alias w polu id
żądania. Jeśli alias już istnieje, utworzenie kursu zakończy się niepowodzeniem z błędem 409 ALREADY_EXISTS
. Zapobiega to tworzeniu zduplikowanych kursów, jeśli wystąpi problem z synchronizacją.
Jeśli na przykład nazwa systemu informacji o uczniach to school
, a identyfikator wewnętrzny używany przez system informacji o uczniach dla danego kursu to math_101
, możesz utworzyć alias d:school_math_101
.
Dodawanie aliasu dla nowego kursu
Aby dodać alias nowego kursu, ustaw course.id
na alias podczas wysyłania żądania courses.create()
.
Google Apps Script
Java
Python
Dodawanie aliasu do istniejącego kursu
Aby dodać alias do istniejącego kursu, możesz ustawić pole alias
i użyć metody courses.aliases.create()
.
Google Apps Script
Java
Python
Pobieranie aliasów kursów
Aliasy kursu możesz pobrać za pomocą metody courses.aliases.list()
, jak pokazano w tym przykładzie:
.NET
Java
Python