Вы можете ссылаться на курсы под другим именем, используя псевдоним курса . Псевдонимы курсов могут служить сопоставлением между идентификаторами курсов Google Classroom и внешними идентификаторами курсов. Например, вы можете установить псевдоним курса, соответствующий идентификатору курса из системы информации о студентах (SIS).
Псевдоним курса имеет две формы: для всего домена и для всего проекта.
Псевдонимы на уровне домена используют префикс
d:
и могут быть просмотрены любым пользователем Classroom API. Пространство имен домена полезно для создания псевдонимов, к которым необходим доступ всем пользователям, но которые не относятся к какой-либо одной программе. Например, в пространстве имен домена следует создать альтернативные списки курсов, например MATH 127 и COMSCI 127. Псевдонимы в пространстве имен домена могут создаваться только администраторами домена, но они видны всем пользователям домена.Псевдонимы всего проекта используют префикс
p:
и могут быть просмотрены и использованы только проектом Google Cloud, который их создал. Пространство имен проекта разработчика полезно для управления псевдонимами, специфичными для приложения. Например, приложение, использующее альтернативные идентификаторы курсов, может создавать псевдонимы для сопоставления своего идентификатора с курсами Класса. Псевдонимы, созданные в этом пространстве имен, привязаны к конкретному проекту 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
.
Добавить псевдоним для нового курса
Чтобы добавить псевдоним для нового курса, установите для course.id
псевдоним при выполнении courses.create()
.
Скрипт приложений
Ява
Питон
Добавить псевдоним для существующего курса
Чтобы добавить псевдоним в существующий курс, вы можете установить поле alias
и использовать courses.aliases.create()
.
Скрипт приложений
Ява
Питон
Получить псевдонимы курсов
Вы можете получить псевдонимы курса с помощью courses.aliases.list()
, как показано в следующем примере:
.СЕТЬ
Ява
Питон
Вы можете ссылаться на курсы под другим именем, используя псевдоним курса . Псевдонимы курсов могут служить сопоставлением между идентификаторами курсов Google Classroom и внешними идентификаторами курсов. Например, вы можете установить псевдоним курса, соответствующий идентификатору курса из системы информации о студентах (SIS).
Псевдоним курса имеет две формы: для всего домена и для всего проекта.
Псевдонимы на уровне домена используют префикс
d:
и могут быть просмотрены любым пользователем Classroom API. Пространство имен домена полезно для создания псевдонимов, к которым необходим доступ всем пользователям, но которые не относятся к какой-либо одной программе. Например, в пространстве имен домена следует создать альтернативные списки курсов, например MATH 127 и COMSCI 127. Псевдонимы в пространстве имен домена могут создаваться только администраторами домена, но они видны всем пользователям домена.Псевдонимы всего проекта используют префикс
p:
и могут быть просмотрены и использованы только проектом Google Cloud, который их создал. Пространство имен проекта разработчика полезно для управления псевдонимами, специфичными для приложения. Например, приложение, использующее альтернативные идентификаторы курсов, может создавать псевдонимы для сопоставления своего идентификатора с курсами Класса. Псевдонимы, созданные в этом пространстве имен, привязаны к конкретному проекту 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
.
Добавить псевдоним для нового курса
Чтобы добавить псевдоним для нового курса, установите для course.id
псевдоним при выполнении courses.create()
.
Скрипт приложений
Ява
Питон
Добавить псевдоним для существующего курса
Чтобы добавить псевдоним в существующий курс, вы можете установить поле alias
и использовать courses.aliases.create()
.
Скрипт приложений
Ява
Питон
Получить псевдонимы курсов
Вы можете получить псевдонимы курса с помощью courses.aliases.list()
, как показано в следующем примере: