REST Resource: courses.aliases
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: CourseAlias
Identificatore alternativo per un corso.
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_101p:<name> indica un alias a livello di progetto. Esempio: p:abc123 Questo campo ha una lunghezza massima di 256 caratteri.
|
Metodi |
|
|
Crea un alias per un corso. |
|
|
Consente di eliminare un alias di un corso. |
|
|
Restituisce un elenco di alias per un corso. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["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. |"]]
