- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Restituisce un elenco di corsi che l'utente richiedente è autorizzato a visualizzare, limitato a quelli che corrispondono alla richiesta. I corsi restituiti vengono ordinati in base all'ora di creazione e vengono inseriti per primi quelli creati più di recente.
Questo metodo restituisce i seguenti codici di errore:
PERMISSION_DENIED
per errori di accesso.INVALID_ARGUMENT
se il formato dell'argomento di query non è corretto.NOT_FOUND
se non esistono utenti specificati negli argomenti della query.
Richiesta HTTP
GET https://classroom.googleapis.com/v1/courses
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di ricerca
Parametri | |
---|---|
studentId |
Limita i corsi restituiti a quelli che hanno uno studente con l'identificatore specificato. L'identificatore può essere uno dei seguenti:
|
teacherId |
Limita i corsi restituiti a quelli con un insegnante con l'identificatore specificato. L'identificatore può essere uno dei seguenti:
|
courseStates[] |
Limita i corsi restituiti a quelli che si trovano in uno degli stati specificati. Il valore predefinito è ACTIVE, ARCHIVED, PROVISIONED, DECLINED. |
pageSize |
Numero massimo di articoli da restituire. Zero o non specificato indica che il server può assegnare un limite massimo. Il server potrebbe restituire un numero di risultati inferiore a quello specificato. |
pageToken |
Valore La richiesta |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Risposta quando si elencano i corsi.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"courses": [
{
object ( |
Campi | |
---|---|
courses[] |
Corsi che corrispondono alla richiesta di elenco. |
nextPageToken |
Token che identifica la pagina successiva dei risultati da restituire. Se vuoto, non sono disponibili ulteriori risultati. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/classroom.courses
https://www.googleapis.com/auth/classroom.courses.readonly
Per ulteriori informazioni, consulta la Guida alle autorizzazioni.