Puedes hacer referencia a los cursos con un nombre diferente con un recurso de alias de curso. Los seudónimos de los cursos son una asignación entre los identificadores de cursos de Google Classroom y los identificadores de cursos externos.
Te recomendamos que, cada vez que crees un curso desde un SIA o lo vincules a un SIA, uses el courseID del SIA como el alias del curso. La API de Classroom
te permite hacerlo directamente en la creación del curso. Para ello, especifica el parámetro id
del
curso como el alias. Si el alias ya existe, la creación del curso fallará con un error ALREADY_EXISTS (409)
. Esto evitará la creación de cursos duplicados si hay un error en el programa de sincronización.
Existen dos variantes de alias: para todo el dominio y para todo el proyecto.
- Los alias de dominio completo usan un prefijo de
d:
y cualquier persona que use la API de Classroom puede verlos. - Los alias de todo el proyecto usan un prefijo de
p:
, y solo la aplicación (proyecto de consola para desarrolladores) que los creó puede verlos y usarlos.
Los alias se pueden usar en cualquier parte de la API que espere un identificador de curso. Esto significa que, una vez que se registra un alias con la API, se puede usar para leer y modificar la información de las listas y los cursos.
Desde la perspectiva de la sincronización del SIE, esto significa que el identificador interno del SIE para un curso se puede registrar como un alias para todo el dominio. De esta manera, cualquier desarrollador que realice integraciones con el SIE y Classroom puede usar el identificador del SIE para interactuar con los datos de Classroom.
Por ejemplo, si suponemos que el nombre del SIE es school
y el identificador interno que usa el SIE para un curso en particular es math_101
, puedes crear un alias como d:school_math_101
.
Agrega un alias para un curso nuevo
Para agregar un alias para un curso nuevo, establece course.id
en el alias deseado cuando realices la solicitud courses.create()
.
Apps Script
Java
Python
Cómo agregar un alias a un curso existente
Para agregar el alias a un curso existente, puedes establecer alias
en el nombre de alias deseado y usar el método courses.aliases.create()
.
Apps Script
Java
Python
Cómo recuperar alias de cursos
Puedes recuperar los alias de un curso con el método courses.aliases.list()
, como se muestra en el siguiente ejemplo:
.NET
Java
Python