Вы можете ссылаться на курсы под другим именем, используя псевдоним курса . Псевдонимы курсов могут служить для сопоставления идентификаторов курсов Google Classroom и внешних идентификаторов курсов. Например, вы можете установить псевдоним курса, соответствующий идентификатору курса из системы информации о студентах (SIS).
Псевдоним курса имеет две формы: для всего предметного домена и для всего проекта.
Псевдонимы, используемые в масштабе всего домена, имеют префикс
d:и видны всем пользователям API Classroom. Пространство имен домена полезно для создания псевдонимов, к которым должны иметь доступ все пользователи, но которые не привязаны к какой-либо конкретной программе. Например, альтернативные варианты для курса, такого как MATH 127 и COMSCI 127, следует создавать в пространстве имен домена. Псевдонимы в пространстве имен домена могут создаваться только администраторами домена, но видны всем пользователям в домене.Псевдонимы, используемые в рамках всего проекта, имеют префикс
p:и могут быть видны и использованы только тем проектом Google Cloud, который их создал. Пространство имен проекта разработчика полезно для управления псевдонимами, специфичными для конкретного приложения. Например, приложение, использующее альтернативные идентификаторы для курсов, может создавать псевдонимы для сопоставления своего идентификатора с курсами Classroom. Псевдонимы, созданные в этом пространстве имен, привязаны к конкретному проекту Google Cloud. Любой пользователь приложения может создавать и просматривать псевдонимы в пространстве имен для проекта разработчика этого приложения.
Вместо идентификатора курса в Classroom для любой конечной точки API Classroom можно использовать псевдоним курса. Это означает, что псевдоним можно использовать для чтения и изменения информации о курсах и списках учащихся.
Используйте псевдоним для синхронизации с системами управления информацией о студентах.
Внутренний идентификатор курса в системе управления информацией о студентах (SIS) можно зарегистрировать как общедоменный псевдоним для этого курса. Таким образом, любой разработчик, интегрирующийся как с SIS, так и с Classroom, сможет использовать идентификатор SIS для взаимодействия с данными Classroom.
При создании курса из системы управления информацией об учащихся (SIS) или при связывании курса с SIS рекомендуется использовать идентификатор курса SIS в качестве псевдонима курса. При создании курса с помощью метода courses.create() псевдоним можно указать в поле id запроса. Если псевдоним уже существует, создание курса завершится ошибкой 409 ALREADY_EXISTS . Это предотвратит создание дубликатов курсов в случае проблем в программе синхронизации.
Например, если предположить, что имя системы управления информацией об учащихся (SIS) — school , а внутренний идентификатор, используемый SIS для конкретного курса, — math_101 , то можно создать псевдоним d:school_math_101 .
Добавить псевдоним для нового курса
Чтобы добавить псевдоним для нового курса, при выполнении запроса courses.create() установите course.id в значение псевдонима.
Apps Script
Java
Python
Добавить псевдоним для существующего курса
Чтобы добавить псевдоним к существующему курсу, вы можете установить поле alias и использовать метод courses.aliases.create() .
Apps Script
Java
Python
Получить псевдонимы курсов
Получить псевдонимы курса можно с помощью метода courses.aliases.list() , как показано в следующем примере: