Method: invitations.list

Restituisce un elenco di inviti che l'utente che ha inviato la richiesta è autorizzato a visualizzare, limitato a quelli che corrispondono alla richiesta di elenco.

Nota: è necessario specificare almeno un valore tra userId o courseId. Possono essere forniti entrambi i campi.

Questo metodo restituisce i seguenti codici di errore:

Richiesta HTTP

GET https://classroom.googleapis.com/v1/invitations

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
userId

string

Limita gli inviti restituiti a quelli di un utente specifico. L'identificatore può essere uno dei seguenti:

  • L'identificatore numerico dell'utente
  • l'indirizzo email dell'utente
  • il valore letterale della stringa "me", che indica l'utente che ha inviato la richiesta
courseId

string

Limita gli inviti restituiti a quelli per un corso con l'identificatore specificato.
pageSize

integer

Numero massimo di articoli da restituire. Il valore predefinito è 500 se non specificato o 0.

Il server potrebbe restituire un numero di risultati inferiore a quello specificato.
pageToken

string

Valore nextPageToken restituito da una chiamata list precedente, che indica che deve essere restituita la pagina dei risultati successiva.

La richiesta list deve essere altrimenti identica a quella che ha generato questo token.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta quando inviti a elencare gli inviti.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "invitations": [
    {
      object (Invitation)
    }
  ],
  "nextPageToken": string
}
Campi
invitations[]

object (Invitation)

Inviti che corrispondono alla richiesta di elenco.
nextPageToken

string

Token che identifica la pagina successiva di risultati da restituire. Se viene lasciato vuoto, non sono disponibili altri risultati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.rosters.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.