Możesz odwoływać się do kursów pod inną nazwą za pomocą zasobu aliasu kursu. Aliasy zajęć to mapowanie identyfikatorów zajęć w Google Classroom i zewnętrznych identyfikatorów zajęć.
Zalecamy, aby za każdym razem, gdy tworzysz kurs w systemie informacji o uczniach lub łączysz kurs z systemem informacji o uczniach, używać identyfikatora kursu z systemu informacji o uczniach jako aliasu kursu. Interfejs Classroom API umożliwia to bezpośrednio podczas tworzenia kursu przez podanie parametru id
kursu jako aliasu. Jeśli alias już istnieje, utworzenie kursu zakończy się niepowodzeniem z błędem ALREADY_EXISTS (409)
. Zapobiegnie to tworzeniu zduplikowanych kursów, jeśli w programie synchronizacji wystąpi błąd.
Istnieją 2 rodzaje aliasów: w całej domenie i w całym projekcie.
- Przydomenowe aliasy używają prefiksu
d:
i mogą być widoczne dla każdego, kto korzysta z interfejsu API Classroom. - Aliasy ogólne w projekcie mają prefiks
p:
i mogą być widoczne oraz używane tylko przez aplikację (projekt w Konsoli programistów), która je utworzyła.
Aliasów można używać w dowolnym miejscu interfejsu API, w którym wymagany jest identyfikator kursu. Oznacza to, że po zarejestrowaniu aliasu za pomocą interfejsu API można go używać do odczytywania i modyfikowania informacji o kursach i wymaganiach.
Z punktu widzenia synchronizacji z systemem SIS wewnętrzny identyfikator kursu w systemie SIS 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 po prostu używać identyfikatora systemu informacji o uczniach do interakcji z danymi Classroom.
Jeśli na przykład nazwa systemu informacji o szkole to school
, a identyfikator wewnętrzny używany przez system informacji o szkole dla konkretnego kursu to math_101
, możesz utworzyć alias d:school_math_101
.
Dodawanie aliasu nowego kursu
Aby dodać alias dla nowego kursu, ustaw parametr course.id
na żądany 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ć wartość parametru alias
na żądaną nazwę aliasu 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