Method: files.copy
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
HTTP-запрос
POST https://www.googleapis.com/drive/v3/files/{fileId}/copy
URL использует синтаксис перекодировки gRPC .
Параметры пути
| Параметры |
|---|
fileId | string Идентификатор файла. |
Параметры запроса
| Параметры |
|---|
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 ответа. |
Текст запроса
Тело запроса содержит экземпляр 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
Некоторые области действия ограничены, и для их использования вашему приложению требуется оценка безопасности. Подробнее см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-26 UTC.
[null,null,["Последнее обновление: 2025-08-26 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)."]]
