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 tant que 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 en fait 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.

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.

Champs d'application 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.