Você pode referenciar cursos por um nome diferente com um recurso de alias do curso. Os aliases de curso são um mapeamento entre os identificadores de curso do Google Sala de Aula e os identificadores externos.
Recomendamos que o cursoID do SIA seja usado como alias do curso sempre que você criar ou vincular um curso a um SIA. Com a API Classroom,
você pode fazer isso diretamente na criação do curso, especificando o parâmetro id
do
curso como o alias. Se o alias já existir, a criação do curso vai falhar
com um erro ALREADY_EXISTS (409)
. Isso evita a criação de cursos duplicados
se houver um bug no programa de sincronização.
Há dois tipos de aliases: em todo o domínio e em todo o projeto.
- Os aliases em todo o domínio usam um prefixo
d:
e podem ser vistos por qualquer pessoa que use a API Classroom. - Os aliases do projeto inteiro usam um prefixo
p:
e só podem ser vistos e usados pelo aplicativo (projeto do console do desenvolvedor) que os criou.
Os aliases podem ser usados em qualquer lugar da API que precise de um identificador de curso. Isso significa que, depois que um alias é registrado usando a API, ele pode ser usado para ler e modificar cursos e informações da lista de estudantes.
Da perspectiva da sincronização do SIA, isso significa que o identificador interno do SIA de um curso pode ser registrado como um alias em todo o domínio para o curso. Dessa forma, qualquer desenvolvedor que se integra ao SIA e ao Google Sala de Aula pode simplesmente usar o identificador do SIA para interagir com os dados do Google Sala de Aula.
Por exemplo, se presumirmos que o nome do SIA é school
e o identificador interno
usado pelo SIA para um curso específico é math_101
, crie um alias
como d:school_math_101
.
Adicionar um alias para um novo curso
Para adicionar um alias a um novo curso, defina course.id
como o alias desejado ao
fazer a solicitação courses.create()
.
Apps Script
Java
Python
Adicionar um alias para um curso que já existe
Para adicionar o alias a um curso existente, defina alias
como o nome do alias desejado e use o método courses.aliases.create()
.
Apps Script
Java
Python
Recuperar aliases do curso
Recupere os aliases de um curso usando o método courses.aliases.list()
, conforme mostrado no exemplo a seguir:
.NET
Java
Python