Method: invitations.create

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

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente che ha inviato la richiesta non è autorizzato a creare inviti per questo corso o in caso di errori di accesso.
  • NOT_FOUND se il corso o l'utente non esiste.
  • FAILED_PRECONDITION:
    • se l'account dell'utente richiesto è disattivato.
    • se l'utente ha già questo ruolo o un ruolo con autorizzazioni superiori.
    • 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 alle autorizzazioni.