Mit einem Alias wird ein Kurs eindeutig identifiziert. Er darf in einem der folgenden Bereiche nur einmal vorkommen:
domain: Domain-übergreifende Alias sind für alle Nutzer in der Domain des Alias-Erstellers sichtbar und kann nur von einem Domainadministrator erstellt werden. Domain-übergreifende Alias werden häufig verwendet, wenn ein Kurs eine Kennung außerhalb von Classroom hat.
Projekt: Ein projektbezogenes Alias ist für jede Anfrage von einer Anwendung sichtbar, bei der die Projekt-ID der Developer Console verwendet wird, mit der der Alias erstellt wurde. Er kann von jedem Projekt erstellt werden. Ein projektbezogenes Alias wird häufig verwendet, wenn eine Anwendung alternative Kennzeichnungen hat. Ein Zufallswert kann auch verwendet werden, um doppelte Kurse bei Übertragungsfehlern zu vermeiden, da beim Wiederholen einer Anfrage ALREADY_EXISTS zurückgegeben wird, wenn eine vorherige erfolgreich war.
JSON-Darstellung
{"alias": string}
Felder
alias
string
Alias-String. Das Format des Strings gibt den gewünschten Alias-Bereich an.
d:<name> gibt einen Alias auf Domainebene an. Beispiel: d:math_101
p:<name> gibt einen Alias auf Projektebene an. Beispiel: p:abc123
Dieses Feld hat eine maximale Länge von 256 Zeichen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2024-10-11 (UTC)."],[[["A CourseAlias is an alternative, unique identifier for a course, offering flexibility for domain and project-level scoping."],["Aliases can be domain-scoped (visible within the creator's domain) or project-scoped (visible to the creating project)."],["Domain-scoped aliases are typically used for external course identifiers, while project-scoped aliases are useful for application-specific identifiers or ensuring data integrity."],["You can manage CourseAliases using the provided methods to create, delete, and list them for a specific course."]]],[]]