REST Resource: courses.aliases

Recurso: CourseAlias

Es el identificador alternativo de un curso.

Un alias identifica un curso de forma única. Debe ser único en uno de los siguientes permisos:

  • Dominio: Los alias con alcance de dominio están visibles para todos los usuarios dentro del dominio del creador del alias y solo los administradores del dominio pueden crearlos. Un alias con alcance de dominio a menudo se usa cuando un curso tiene un identificador externo a Classroom.

  • project: Un alias con alcance de proyecto es visible para cualquier solicitud de una aplicación con el ID del proyecto de Developer Console que creó el alias y que cualquier proyecto puede crear. Los alias con alcance de proyecto a menudo se usan cuando una aplicación tiene identificadores alternativos. También se puede usar un valor aleatorio para evitar la duplicación de cursos en caso de fallas de transmisión, ya que, si vuelve a intentar una solicitud, se mostrará ALREADY_EXISTS si se realizó correctamente una anterior.

Representación JSON
{
  "alias": string
}
Campos
alias

string

String de alias. El formato de la string indica el alcance del alias deseado.

  • d:<name> indica un alias con alcance de dominio. Ejemplo: d:math_101
  • p:<name> indica un alias con alcance de proyecto. Ejemplo: p:abc123

La longitud máxima de este campo es 256 caracteres.

Métodos

create

Crea un alias para un curso.

delete

Borra el alias de un curso.

list

Muestra una lista de los alias de un curso.