Method: files.copy
Stay organized with collections
Save and categorize content based on your preferences.
Creates a copy of the specified file.
HTTP request
POST https://www.googleapis.com/drive/v2/files/{fileId}/copy
The URL uses
gRPC Transcoding
syntax.
Path parameters
Parameters
|
fileId
|
string
The ID of the file to copy.
|
Query parameters
Parameters
|
convert
|
boolean
Whether to convert this file to the corresponding Docs Editors format.
|
enforceSingleParent
(deprecated)
|
boolean
Deprecated: Copying files into multiple folders is no longer supported. Use shortcuts instead.
|
ocr
|
boolean
Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
|
ocrLanguage
|
string
If
ocr
is true, hints at the language to use. Valid values are BCP 47 codes.
|
pinned
|
boolean
Whether to pin the head revision of the new copy. A file can have a maximum of 200 pinned revisions.
|
supportsAllDrives
|
boolean
Whether the requesting application supports both My Drives and shared drives.
|
supportsTeamDrives
(deprecated)
|
boolean
Deprecated: Use
supportsAllDrives
instead.
|
timedTextLanguage
|
string
The language of the timed text.
|
timedTextTrackName
|
string
The timed text track name.
|
visibility
|
enum (
Visibility
)
The visibility of the new file. This parameter is only relevant when the source is not a native Google Doc and convert=false.
|
includePermissionsForView
|
string
Specifies which additional view's permissions to include in the response. Only
published
is supported.
|
includeLabels
|
string
A comma-separated list of IDs of labels to include in the
labelInfo
part of the response.
|
Request body
The request body contains an instance of
File
.
Response body
If successful, the response body contains an instance of
File
.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
https://www.googleapis.com/auth/drive.file
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
Authorization guide
.
Except as otherwise noted, the content of this page is licensed under the
Creative Commons Attribution 4.0 License
, and code samples are licensed under the
Apache 2.0 License
. For details, see the
Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-05-10 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Missing the information I need"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Too complicated / too many steps"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Out of date"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Samples / code issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]