Ressource: CourseAlias
Alternative ID für einen Kurs.
Durch einen Alias wird ein Kurs eindeutig identifiziert. Er muss in einem der folgenden Bereiche eindeutig sein:
Domain: Ein auf Domains beschränkter Alias ist für alle Nutzer in der Domain des Alias-Erstellers sichtbar und kann nur von einem Domainadministrator erstellt werden. Ein auf eine Domain beschränkter Alias wird oft verwendet, wenn ein Kurs eine externe Kennung für Classroom hat.
Projekt: Ein projektbezogener Alias ist für jede Anfrage einer Anwendung sichtbar, die die Projekt-ID der Entwicklerkonsole verwendet, die den Alias erstellt hat und die von jedem Projekt erstellt werden kann. Ein projektbezogener Alias wird oft verwendet, wenn eine Anwendung alternative Kennungen hat. Außerdem kann ein Zufallswert bei Übertragungsfehlern verwendet werden, um doppelte Kurse zu vermeiden. Eine Wiederholung einer Anfrage gibt
ALREADY_EXISTS
zurück, wenn die vorherige erfolgreich war.
JSON-Darstellung |
---|
{ "alias": string } |
Felder | |
---|---|
alias |
Alias-String. Das Format des Strings gibt den gewünschten Aliasbereich an.
Dieses Feld hat eine maximale Länge von 256 Zeichen. |
Methoden |
|
---|---|
|
Erstellt einen Alias für einen Kurs. |
|
Löscht einen Alias eines Kurses. |
|
Gibt eine Liste von Aliassen für einen Kurs zurück. |