Dodatki do Google Classroom są teraz ogólnie dostępne dla programistów. Więcej informacji znajdziesz w
dokumentacji dodatków.
Method: courses.courseWorkMaterials.addOnAttachments.patch
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Aktualizuje załącznik dodatku.
Wymaga, aby dodatek był pierwotnym twórcą załącznika.
Ta metoda zwraca te kody błędów:
PERMISSION_DENIED w przypadku błędów dostępu.INVALID_ARGUMENT jeśli żądanie ma nieprawidłowy format.NOT_FOUND jeśli jeden z identyfikowanych zasobów nie istnieje.
Żądanie HTTP
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
courseId |
string
Wymagane. Identyfikator kursu.
|
itemId |
string
Identyfikator posta, w ramach którego znajduje się załącznik.
|
attachmentId |
string
Wymagane. Identyfikator załącznika.
|
Parametry zapytania
| Parametry |
postId |
string
Wymagane. Identyfikator posta, w ramach którego znajduje się załącznik.
|
updateMask |
string (FieldMask format)
Wymagane. Maska, która wskazuje, które pola załącznika mają zostać zaktualizowane. Jeśli podasz nieprawidłowe pola, aktualizacja się nie powiedzie. Jeśli pole obsługuje puste wartości, można je wyczyścić, określając je w masce aktualizacji, a nie w obiekcie AddOnAttachment. Jeśli w masce aktualizacji znajduje się pole, które nie obsługuje pustych wartości, i nie jest ono ustawione w obiekcie AddOnAttachment, zwracany jest błąd INVALID_ARGUMENT. Nauczyciele mogą określić te pola:
titleteacherViewUristudentViewUristudentWorkReviewUridueDatedueTimemaxPoints Jest to lista pełnych nazw pól rozdzielona przecinkami. Przykład: "user.displayName,photo".
|
Treść żądania
Treść żądania zawiera wystąpienie elementu AddOnAttachment.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu AddOnAttachment.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/classroom.addons.teacher
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.courseWorkMaterials.addOnAttachments.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\nUpdates an add-on attachment.\n\nRequires the add-on to have been the original creator of the attachment.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if one of the identified resources does not exist.\n\n### HTTP request\n\n`PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|-------------------------------------------------------------------------|\n| `courseId` | `string` Required. Identifier of the course. |\n| `itemId` | `string` Identifier of the post under which the attachment is attached. |\n| `attachmentId` | `string` Required. Identifier of the attachment. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `postId` | `string` Required. Identifier of the post under which the attachment is attached. |\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. Mask that identifies which fields on the attachment to 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 `AddOnAttachment` object. If a field that does not support empty values is included in the update mask and not set in the `AddOnAttachment` object, an `INVALID_ARGUMENT` error is returned. The following fields may be specified by teachers: - `title` - `teacherViewUri` - `studentViewUri` - `studentWorkReviewUri` - `dueDate` - `dueTime` - `maxPoints` 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 [AddOnAttachment](/workspace/classroom/reference/rest/v1/courses.announcements.addOnAttachments#AddOnAttachment).\n\n### Response body\n\nIf successful, the response body contains an instance of [AddOnAttachment](/workspace/classroom/reference/rest/v1/courses.announcements.addOnAttachments#AddOnAttachment).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.addons.teacher`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
