Method: courses.announcements.create
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создает объявление.
Этот метод возвращает следующие коды ошибок:
-
PERMISSION_DENIED если запрашивающему пользователю не разрешен доступ к запрошенному курсу, создание объявлений в запрошенном курсе, публикация вложения на Диске или ошибки доступа . -
INVALID_ARGUMENT , если запрос имеет неверный формат. -
NOT_FOUND , если запрошенный курс не существует. -
FAILED_PRECONDITION из-за следующей ошибки запроса :
HTTP-запрос
POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
courseId | string Идентификатор курса. Этот идентификатор может быть либо идентификатором, присвоенным Классом, либо alias . |
Тело запроса
Тело запроса содержит экземпляр Announcement .
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр Announcement .
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/classroom.announcements
Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[],[],null,["# Method: courses.announcements.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an announcement.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course, create announcements in the requested course, share a Drive attachment, or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course does not exist.\n- `FAILED_PRECONDITION` for the following [request error](/workspace/classroom/reference/Request.Errors):\n - AttachmentNotVisible\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course. This identifier can be either the Classroom-assigned identifier or an [alias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias). |\n\n### Request body\n\nThe request body contains an instance of [Announcement](/workspace/classroom/reference/rest/v1/courses.announcements#Announcement).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Announcement](/workspace/classroom/reference/rest/v1/courses.announcements#Announcement).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.announcements`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
