Method: courses.create

Crea un corso.

L'utente specificato in ownerId è il proprietario del corso creato e viene aggiunto come insegnante. Un utente non amministratore che effettua la richiesta può creare un corso solo se è il proprietario. Gli amministratori di dominio possono creare corsi di proprietà di qualsiasi utente all'interno del proprio dominio.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente che effettua la richiesta non è autorizzato a creare corsi o in caso di errori di accesso.
  • NOT_FOUND se l'insegnante principale non è un utente valido.
  • FAILED_PRECONDITION se l'account del proprietario del corso è disattivato o per i seguenti errori di richiesta:
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
    • CourseTitleCannotContainUrl
  • ALREADY_EXISTS se è stato specificato un alias nell'id ed esiste già.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
previewVersion

enum (PreviewVersion)

Facoltativo. La versione di anteprima dell'API. Questa impostazione deve essere configurata per accedere alle nuove funzionalità dell'API rese disponibili agli sviluppatori nel Programma Anteprima.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Course.

Corpo della risposta

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la guida all'autorizzazione.