Method: files.copy
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ファイルのコピーを作成し、パッチ セマンティクスを使用してリクエストされた更新を適用します。詳細については、ファイルを作成、管理するをご覧ください。
HTTP リクエスト
POST https://www.googleapis.com/drive/v3/files/{fileId}/copy
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
fileId |
string
ファイルの ID。
|
クエリ パラメータ
パラメータ |
enforceSingleParent (deprecated) |
boolean
非推奨: 複数のフォルダへのファイルのコピーはサポートされなくなりました。代わりにショートカットを使用してください。
|
ignoreDefaultVisibility |
boolean
作成されたファイルに対してドメインのデフォルトの公開設定を無視するかどうか。ドメイン管理者は、アップロードされたすべてのファイルをデフォルトでドメインに表示するように選択できます。このパラメータは、リクエストに対してその動作をバイパスします。権限は引き続き親フォルダから継承されます。
|
keepRevisionForever |
boolean
新しいヘッド リビジョンで keepForever フィールドを設定するかどうか。これは、Google ドライブ内のバイナリ コンテンツを含むファイルにのみ適用されます。ファイルを削除しない状態で保存できるのは 200 個の版のみです。上限に達した場合は、固定されたリビジョンを削除してみてください。
|
ocrLanguage |
string
画像インポート時の OCR 処理の言語ヒント(ISO 639-1 コード)。
|
supportsAllDrives |
boolean
リクエスト元のアプリケーションがマイドライブと共有ドライブの両方をサポートしているかどうか。
|
supportsTeamDrives (deprecated) |
boolean
非推奨: 代わりに、supportsAllDrives を使用してください。
|
includePermissionsForView |
string
レスポンスに含める追加ビューの権限を指定します。published のみがサポートされています。
|
includeLabels |
string
レスポンスの labelInfo 部分に含めるラベルの ID のカンマ区切りのリスト。
|
リクエストの本文
リクエストの本文には File
のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には File
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.photos.readonly
一部のスコープは制限されており、アプリでそれらを使用するにはセキュリティ評価が必要です。詳しくは、承認ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-27 UTC。
[null,null,["最終更新日 2025-08-27 UTC。"],[],[],null,["# Method: files.copy\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 a copy of a file and applies any requested updates with patch semantics.\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v3/files/{fileId}/copy`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------|\n| `fileId` | `string` The ID of the file. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `enforceSingleParent` | `boolean` Deprecated. Copying files into multiple folders is no longer supported. Use shortcuts instead. |\n| `ignoreDefaultVisibility` | `boolean` Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders. |\n| `keepRevisionForever` | `boolean` Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. |\n| `ocrLanguage` | `string` A language hint for OCR processing during image import (ISO 639-1 code). |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `includePermissionsForView` | `string` Specifies which additional view's permissions to include in the response. Only 'published' is supported. |\n| `includeLabels` | `string` A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. |\n\n### Request body\n\nThe request body contains an instance of [File](/workspace/drive/api/reference/rest/v3/files#File).\n\n### Response body\n\nIf successful, the response body contains an instance of [File](/workspace/drive/api/reference/rest/v3/files#File).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.appdata`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.photos.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]