Note: Requires authorization.
Creates a copy of a file and applies any requested updates with patch semantics. Try it now.
POST https://www.googleapis.com/drive/v3/files/fileId/copy
Parameter name | Value | Description |
---|---|---|
Path parameters | ||
fileId | string | The ID of the file. |
Optional query parameters | ||
fields | string | The paths of the fields you want included in the response. If not specified, the response includes a default set of fields specific to this method. For development you can use the special value * to return all fields, but you'll achieve greater performance by only selecting the fields you need. For more information see the partial responses documentation. |
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. (Default: false) |
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. (Default: false) |
ocrLanguage | string | A language hint for OCR processing during image import (ISO 639-1 code). |
supportsAllDrives | boolean | Warning: This item is deprecated. Deprecated - Whether the requesting application supports both My Drives and shared drives. This parameter will only be effective until June 1, 2020. Afterwards all applications are assumed to support shared drives. (Default: false) |
supportsTeamDrives | boolean | Warning: This item is deprecated. Deprecated use supportsAllDrives instead. (Default: false) |
This request requires authorization with at least one of the following scopes:
Scope |
---|
https://www.googleapis.com/auth/drive |
https://www.googleapis.com/auth/drive.file |
https://www.googleapis.com/auth/drive.appdata |
https://www.googleapis.com/auth/drive.photos.readonly |
Some scopes are restricted and require a security assessment for your app to use them. For more information, see the authentication and authorization page.
In the request body, supply a Files resource with the following properties:
Property name | Value | Description | Notes |
---|---|---|---|
Optional Properties | |||
appProperties | object | A collection of arbitrary key-value pairs which are private to the requesting app. Entries with null values are cleared in update and copy requests. | writable |
contentHints.thumbnail.image | bytes | The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5). | writable |
contentHints.thumbnail.mimeType | string | The MIME type of the thumbnail. | writable |
copyRequiresWriterPermission | boolean | Whether the options to copy, print, or download this file, should be disabled for readers and commenters. | writable |
description | string | A short description of the file. | writable |
id | string | The ID of the file. | writable |
mimeType | string | The MIME type of the file. Google Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded. If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource. | writable |
modifiedTime | datetime | The last time the file was modified by anyone (RFC 3339 date-time). Note that setting modifiedTime will also update modifiedByMeTime for the user. | writable |
name | string | The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant. | writable |
parents[] | list | The IDs of the parent folders which contain the file. If not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list. | writable |
properties | object | A collection of arbitrary key-value pairs which are visible to all apps. Entries with null values are cleared in update and copy requests. | writable |
starred | boolean | Whether the user has starred the file. | writable |
viewedByMeTime | datetime | The last time the file was viewed by the user (RFC 3339 date-time). | writable |
writersCanShare | boolean | Whether users with only writer permission can modify the file's permissions. Not populated for items in shared drives. | writable |
If successful, this method returns a Files resource in the response body.
Use the APIs Explorer below to call this method on live data and see the response.
扫码关注腾讯云开发者
领取腾讯云代金券
Copyright © 2013 - 2025 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号:粤B2-20090059 深公网安备号 44030502008569
腾讯云计算(北京)有限责任公司 京ICP证150476号 | 京ICP备11018762号 | 京公网安备号11010802020287
Copyright © 2013 - 2025 Tencent Cloud.
All Rights Reserved. 腾讯云 版权所有