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.
Los alias se pueden configurar de dos maneras: para todo el dominio o 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 a nivel del proyecto usan un prefijo de
p:
y solo los puede ver y usar la aplicación (proyecto de la consola para desarrolladores) que los creó.
Los alias se pueden usar en cualquier lugar 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 los cursos y las listas de estudiantes.
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
Agrega un alias para 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 los alias de los 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