Method: invitations.create

Crea un invito. Può esistere un solo invito per utente e corso alla volta. Elimina e ricrea un invito per apportare modifiche.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente che effettua la richiesta non è autorizzato a creare inviti per questo corso o per errori di accesso.
  • NOT_FOUND se il corso o l'utente non esistono.
  • FAILED_PRECONDITION:
    • se l'account dell'utente richiesto è disattivato.
    • se l'utente dispone già di questo ruolo o di un ruolo con autorizzazioni maggiori.
    • per i seguenti errori di richiesta:
      • IneligibleOwner
  • ALREADY_EXISTS se esiste già un invito per l'utente e il corso specificati.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Invitation.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Invitation appena creata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.