REST Resource: courses.topics
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: argomento
Argomento creato da un insegnante per il corso
Rappresentazione JSON |
{
"courseId": string,
"topicId": string,
"name": string,
"updateTime": string
} |
Campi |
courseId |
string
L'identificatore del corso. Sola lettura.
|
topicId |
string
Identificatore univoco dell'argomento. Sola lettura.
|
name |
string
Il nome dell'argomento, generato dall'utente. Gli spazi vuoti iniziali e finali, se presenti, vengono rimossi. Inoltre, più spazi bianchi consecutivi vengono compressi in uno solo all'interno del nome. Il risultato deve essere una stringa non vuota. I nomi degli argomenti fanno distinzione tra maiuscole e minuscole e non devono contenere più di 100 caratteri.
|
updateTime |
string (Timestamp format)
L'ora dell'ultimo aggiornamento dell'argomento da parte del sistema. Sola lettura. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30" .
|
Metodi |
|
Crea un argomento. |
|
Elimina un argomento. |
|
Restituisce un argomento. |
|
Restituisce l'elenco degli argomenti che il richiedente è autorizzato a visualizzare. |
|
Aggiorna uno o più campi di un argomento. |
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-08-26 UTC.
[null,null,["Ultimo aggiornamento 2025-08-26 UTC."],[],[],null,["- [Resource: Topic](#Topic)\n - [JSON representation](#Topic.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Topic Topic created by a teacher for the course\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------|\n| ``` { \"courseId\": string, \"topicId\": string, \"name\": string, \"updateTime\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course. Read-only. |\n| `topicId` | `string` Unique identifier for the topic. Read-only. |\n| `name` | `string` The name of the topic, generated by the user. Leading and trailing whitespaces, if any, are trimmed. Also, multiple consecutive whitespaces are collapsed into one inside the name. The result must be a non-empty string. Topic names are case sensitive, and must be no longer than 100 characters. |\n| `updateTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` The time the topic was last updated by the system. Read-only. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n\n| Methods ||\n|------------------------------------------------------------------------|---------------------------------------------------------------------|\n| [create](/workspace/classroom/reference/rest/v1/courses.topics/create) | Creates a topic. |\n| [delete](/workspace/classroom/reference/rest/v1/courses.topics/delete) | Deletes a topic. |\n| [get](/workspace/classroom/reference/rest/v1/courses.topics/get) | Returns a topic. |\n| [list](/workspace/classroom/reference/rest/v1/courses.topics/list) | Returns the list of topics that the requester is permitted to view. |\n| [patch](/workspace/classroom/reference/rest/v1/courses.topics/patch) | Updates one or more fields of a topic. |"]]