Method: courses.create

Crée un cours.

L'utilisateur spécifié dans ownerId est le propriétaire du cours créé et est ajouté en tant qu'enseignant. Un utilisateur non administrateur ne peut créer un cours qu'en se désignant comme propriétaire. Les administrateurs de domaine peuvent créer des cours appartenant à n'importe quel utilisateur de leur domaine.

Cette méthode renvoie les codes d'erreur suivants :

  • PERMISSION_DENIED si l'utilisateur qui envoie la demande n'est pas autorisé à créer des cours ou en cas d'erreur d'accès.
  • NOT_FOUND si l'enseignant principal n'est pas un utilisateur valide.
  • FAILED_PRECONDITION si le compte du propriétaire du cours est désactivé ou pour les erreurs de requête suivantes :
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
    • CourseTitleCannotContainUrl
  • ALREADY_EXISTS si un alias a été spécifié dans id et existe déjà.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
previewVersion

enum (PreviewVersion)

Facultatif. Version preview de l'API. Ce paramètre doit être défini pour accéder aux nouvelles fonctionnalités d'API mises à la disposition des développeurs dans le programme Preview.

Corps de la requête

Le corps de la requête contient une instance de Course.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Course.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez le guide d'autorisation.