Dodatki do Google Classroom są teraz ogólnie dostępne dla programistów. Więcej informacji znajdziesz w
dokumentacji dodatków.
Method: courses.courseWork.create
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
tworzenia zadań.
Wyniki pracy nad kursem (i odpowiednie prace przesłane przez studentów) są powiązane z projektem w Konsoli dewelopera, którego identyfikator klienta OAuth został użyty do wysłania żądania. Prośby o modyfikację zadań w Classroom i przesyłanych przez uczniów treści muszą być wysyłane z identyfikatorem klienta OAuth z powiązanego projektu w Konsoli dewelopera.
Ta metoda zwraca te kody błędów:
PERMISSION_DENIED jeśli użytkownik nie ma uprawnień do dostępu do kursu, tworzenia zadań w danym kursie, udostępniania załącznika z Dysku lub w przypadku błędów dostępu.INVALID_ARGUMENT jeśli żądanie ma nieprawidłowy format.NOT_FOUND, jeśli żądany kurs nie istnieje.FAILED_PRECONDITION z powodu tego błędu żądania:
Żądanie HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
courseId |
string
Identyfikator kursu. Identyfikatorem może być identyfikator przypisany przez Classroom lub alias.
|
Parametry zapytania
| Parametry |
previewVersion |
enum (PreviewVersion)
Opcjonalnie. Wersja podglądu punktu końcowego. Aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach programu w wersji podglądowej, musisz ustawić tę opcję.
|
Treść żądania
Treść żądania zawiera wystąpienie elementu CourseWork.
Treść odpowiedzi
Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierała nowo utworzoną instancję CourseWork.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/classroom.coursework.students
Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[],[],null,["# Method: courses.courseWork.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_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 course work.\n\nThe resulting course work (and corresponding student submissions) are associated with the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to make the request. Classroom API requests to modify course work and student submissions must be made with an OAuth client ID from the associated Developer Console project.\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 course work 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}/courseWork`\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### Query parameters\n\n| Parameters ||\n|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Optional. The preview version of the endpoint. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Request body\n\nThe request body contains an instance of [CourseWork](/workspace/classroom/reference/rest/v1/courses.courseWork#CourseWork).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [CourseWork](/workspace/classroom/reference/rest/v1/courses.courseWork#CourseWork).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.coursework.students`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
