Method: courses.create
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/08 (UTC).
[null,null,["Dernière mise à jour le 2025/08/08 (UTC)."],[],[],null,["# Method: courses.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a course.\n\nThe user specified in `ownerId` is the owner of the created course and added as a teacher. A non-admin requesting user can only create a course with themselves as the owner. Domain admins can create courses owned by any user within their domain.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to create courses or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `NOT_FOUND` if the primary teacher is not a valid user.\n- `FAILED_PRECONDITION` if the course owner's account is disabled or for the following [request errors](/workspace/classroom/reference/Request.Errors):\n - UserCannotOwnCourse\n - UserGroupsMembershipLimitReached\n - CourseTitleCannotContainUrl\n- `ALREADY_EXISTS` if an alias was specified in the `id` and already exists.\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/courses`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains an instance of [Course](/workspace/classroom/reference/rest/v1/courses#Course).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Course](/workspace/classroom/reference/rest/v1/courses#Course).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.courses`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
