Google Classroom アドオンの一般提供が開始されました。詳しくは、
アドオンのドキュメントをご覧ください。
Method: courses.courseWork.addOnAttachments.patch
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
アドオンの添付ファイルを更新します。
アドオンが添付ファイルの元の作成者である必要があります。
このメソッドは、次のエラーコードを返します。
PERMISSION_DENIED
: アクセス エラー。
INVALID_ARGUMENT
: リクエストの形式が正しくない場合。
NOT_FOUND
: 検出されたリソースのいずれかが存在しない場合。
HTTP リクエスト
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
courseId |
string
必須。コースの識別子。
|
itemId |
string
添付ファイルが添付されている投稿の ID。
|
attachmentId |
string
必須。添付ファイルの識別子。
|
クエリ パラメータ
パラメータ |
postId |
string
必須。添付ファイルが添付されている投稿の ID。
|
updateMask |
string (FieldMask format)
必須。添付ファイルのどのフィールドを更新するかを識別するマスク。無効なフィールドが指定されている場合、更新は失敗します。フィールドが空の値をサポートしている場合は、AddOnAttachment オブジェクトではなく更新マスクで指定することで、そのフィールドを消去できます。空の値をサポートしていないフィールドが更新マスクに含まれ、AddOnAttachment オブジェクトに設定されていない場合、INVALID_ARGUMENT エラーが返されます。 教師は次のフィールドを指定できます。
title
teacherViewUri
studentViewUri
studentWorkReviewUri
dueDate
dueTime
maxPoints
完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo" 。
|
リクエストの本文
リクエストの本文には AddOnAttachment
のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には AddOnAttachment
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/classroom.addons.teacher
詳しくは、認可ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],null,["# Method: courses.courseWork.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}/courseWork/{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)."]]