Puedes hacer referencia a los cursos con un nombre diferente usando un alias de curso. Los alias de curso pueden servir como una asignación entre los identificadores de cursos de Google Classroom y los identificadores de cursos externos. Por ejemplo, puedes establecer un alias de curso para que coincida con el ID del curso de un sistema de información de estudiantes (SIE).
El alias de curso tiene dos formas: en todo el dominio y en todo el proyecto.
Los alias en todo el dominio usan el prefijo
d:y cualquier persona que use la API de Classroom puede verlos. El espacio de nombres del dominio es útil para crear alias a los que todos los usuarios necesitan acceder, pero que no son específicos de ningún programa. Por ejemplo, las listas alternativas de un curso, como MATH 127 y COMSCI 127, se deben crear en el espacio de nombres del dominio. Solo los administradores del dominio pueden crear alias en el espacio de nombres del dominio, pero todos los usuarios de un dominio pueden verlos.Los alias en todo el proyecto usan un prefijo de
p:y solo el proyecto de Google Cloud que los creó puede verlos y usarlos. El espacio de nombres del proyecto del desarrollador es útil para administrar alias específicos de una aplicación. Por ejemplo, una aplicación que usa identificadores alternativos para los cursos puede crear alias para asignar su identificador a los cursos de Classroom. Los alias creados en este espacio de nombres están vinculados a un proyecto de Google Cloud específico. Cualquier usuario de una aplicación puede crear y ver alias en el espacio de nombres del proyecto del desarrollador de esa aplicación.
Se puede usar un alias de curso en lugar del ID del curso de Classroom para cualquier endpoint de API de Classroom. Esto significa que el alias se puede usar para leer y modificar cursos y la información de la lista.
Usa un alias para la sincronización con los sistemas de información de alumnos
El identificador interno del SIA para un curso se puede registrar como un alias en todo el dominio para el curso. De esa manera, cualquier desarrollador que se integre con el SIA y Classroom puede usar el identificador del SIA para interactuar con los datos de Classroom.
Si creas un curso desde un SIA o vinculas un curso a un SIA, te recomendamos
que se use el ID del curso del SIA como alias del curso. Cuando creas un
curso con el courses.create() método, puedes especificar el alias en el
id campo de la solicitud. Si el alias ya existe, la creación del curso falla con un error 409 ALREADY_EXISTS. Esto evita la creación de cursos duplicados si hay un problema en el programa de sincronización.
Por ejemplo, si suponemos que el nombre del SIA es school y el identificador interno
que usa el SIA 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 un alias cuando
realices la courses.create() solicitud.
Apps Script
Java
Python
Agrega un alias para un curso existente
Para agregar el alias en un curso existente, puedes establecer el campo alias
y usar el método courses.aliases.create().
Apps Script
Java
Python
Recupera alias de cursos
Puedes recuperar los alias de un curso con el
courses.aliases.list() método, como se muestra en el
siguiente ejemplo:
.NET
Java
Python