Dodatki do Google Classroom są teraz ogólnie dostępne dla programistów. Więcej informacji znajdziesz w
dokumentacji dodatków.
Method: courses.topics.patch
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zaktualizuje co najmniej jedno pole tematu.
Ta metoda zwraca te kody błędów:
PERMISSION_DENIED jeśli projekt dewelopera, który wysłał żądanie, nie utworzył odpowiedniego tematu lub w przypadku błędów dostępu.INVALID_ARGUMENT jeśli żądanie ma nieprawidłowy format.FAILED_PRECONDITION jeśli w kursie istnieje temat o tej samej nazwie.NOT_FOUND, jeśli żądany kurs lub temat nie istnieje
Żądanie HTTP
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/topics/{id}
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.
|
id |
string
Identyfikator tematu.
|
Parametry zapytania
| Parametry |
updateMask |
string (FieldMask format)
Maska, która określa, które pola tematu mają zostać zaktualizowane. To pole jest wymagane do wprowadzenia aktualizacji. Jeśli podasz nieprawidłowe pola, aktualizacja się nie powiedzie. Jeśli pole obsługuje puste wartości, można je wyczyścić, podając je w masce aktualizacji, a nie w obiekcie Topic. Jeśli w masce aktualizacji znajduje się pole, które nie obsługuje pustych wartości, i nie jest ono ustawione w obiekcie Topic, zwracany jest błąd INVALID_ARGUMENT. Możesz określić te pola:
Jest to lista pełnych nazw pól rozdzielona przecinkami. Przykład: "user.displayName,photo".
|
Treść żądania
Treść żądania zawiera wystąpienie elementu Topic.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Topic.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/classroom.topics
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.topics.patch\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\nUpdates one or more fields of a topic.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting developer project did not create the corresponding topic or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `FAILED_PRECONDITION` if there exists a topic in the course with the same name.\n- `NOT_FOUND` if the requested course or topic does not exist\n\n### HTTP request\n\n`PATCH https://classroom.googleapis.com/v1/courses/{courseId}/topics/{id}`\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| `id` | `string` Identifier of the topic. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Mask that identifies which fields on the topic to update. This field is required to do an update. The update fails if invalid fields are specified. If a field supports empty values, it can be cleared by specifying it in the update mask and not in the Topic object. If a field that does not support empty values is included in the update mask and not set in the Topic object, an `INVALID_ARGUMENT` error is returned. The following fields may be specified: - `name` This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [Topic](/workspace/classroom/reference/rest/v1/courses.topics#Topic).\n\n### Response body\n\nIf successful, the response body contains an instance of [Topic](/workspace/classroom/reference/rest/v1/courses.topics#Topic).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.topics`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
