Method: courses.create
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создает курс.
Пользователь, указанный в ownerId
является владельцем созданного курса и добавлен в качестве преподавателя. Пользователь, не являющийся администратором, может создать курс, владельцом которого он является, только сам. Администраторы домена могут создавать курсы, владельцем которых является любой пользователь в своем домене.
Этот метод возвращает следующие коды ошибок:
-
PERMISSION_DENIED
, если запрашивающему пользователю не разрешено создавать курсы или возникли ошибки доступа . -
NOT_FOUND
, если основной преподаватель не является допустимым пользователем. -
FAILED_PRECONDITION
, если учетная запись владельца курса отключена или при следующих ошибках запроса :- Пользователь не может владеть курсом
- Достигнут лимит членства в группах пользователей
- CourseTitleCannotContainUrl
-
ALREADY_EXISTS
, если псевдоним был указан в id
и уже существует.
HTTP-запрос
POST https://classroom.googleapis.com/v1/courses
URL использует синтаксис перекодировки gRPC .
Текст запроса
Тело запроса содержит экземпляр Course
.
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр Course
.
Области авторизации
Требуется следующая область OAuth:
-
https://www.googleapis.com/auth/classroom.courses
Более подробную информацию смотрите в Руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-08 UTC.
[null,null,["Последнее обновление: 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)."]]