Un alias identifica in modo univoco un corso. Deve essere univoco in uno dei seguenti ambiti:
domain: un alias basato sul dominio è visibile a tutti gli utenti all'interno del dominio del creatore dell'alias e può essere creato solo da un amministratore di dominio. Un alias a livello di dominio viene spesso utilizzato quando un corso ha un identificatore esterno a Classroom.
project: un alias basato sul progetto è visibile a qualsiasi richiesta di un'applicazione che utilizza l'ID progetto di Developer Console che ha creato l'alias e può essere creato da qualsiasi progetto. Un alias a livello di progetto viene spesso utilizzato quando un'applicazione ha identificatori alternativi. Un valore casuale può essere utilizzato anche per evitare corsi duplicati in caso di errori di trasmissione, poiché il nuovo tentativo di invio di una richiesta restituirà ALREADY_EXISTS se una precedente è andata a buon fine.
Rappresentazione JSON
{"alias": string}
Campi
alias
string
Stringa dell'alias. Il formato della stringa indica l'ambito dell'alias desiderato.
d:<name> indica un alias a livello di dominio. Esempio: d:math_101
p:<name> indica un alias a livello di progetto. Esempio: p:abc123
Questo campo ha una lunghezza massima di 256 caratteri.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-25 UTC."],[],[],null,["# REST Resource: courses.aliases\n\n- [Resource: CourseAlias](#CourseAlias)\n - [JSON representation](#CourseAlias.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CourseAlias\n---------------------\n\nAlternative identifier for a course.\n\nAn alias uniquely identifies a course. It must be unique within one of the following scopes:\n\n- domain: A domain-scoped alias is visible to all users within the alias creator's domain and can be created only by a domain admin. A domain-scoped alias is often used when a course has an identifier external to Classroom.\n\n- project: A project-scoped alias is visible to any request from an application using the Developer Console project ID that created the alias and can be created by any project. A project-scoped alias is often used when an application has alternative identifiers. A random value can also be used to avoid duplicate courses in the event of transmission failures, as retrying a request will return `ALREADY_EXISTS` if a previous one has succeeded.\n\n| JSON representation |\n|-----------------------------|\n| ``` { \"alias\": string } ``` |\n\n| Fields ||\n|---------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `alias` | `string` Alias string. The format of the string indicates the desired alias scoping. - `d:\u003cname\u003e` indicates a domain-scoped alias. Example: `d:math_101` - `p:\u003cname\u003e` indicates a project-scoped alias. Example: `p:abc123` This field has a maximum length of 256 characters. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------------------|-----------------------------------------|\n| ### [create](/workspace/classroom/reference/rest/v1/courses.aliases/create) | Creates an alias for a course. |\n| ### [delete](/workspace/classroom/reference/rest/v1/courses.aliases/delete) | Deletes an alias of a course. |\n| ### [list](/workspace/classroom/reference/rest/v1/courses.aliases/list) | Returns a list of aliases for a course. |"]]
