- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
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
|
The ID of the file to copy. |
Query parameters
| Parameters | |
|---|---|
convert
|
Whether to convert this file to the corresponding Docs Editors format. |
enforceSingleParent
|
Deprecated: Copying files into multiple folders is no longer supported. Use shortcuts instead. |
ocr
|
Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads. |
ocrLanguage
|
If |
pinned
|
Whether to pin the head revision of the new copy. A file can have a maximum of 200 pinned revisions. |
supportsAllDrives
|
Whether the requesting application supports both My Drives and shared drives. |
supportsTeamDrives
|
Deprecated: Use |
timedTextLanguage
|
The language of the timed text. |
timedTextTrackName
|
The timed text track name. |
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
|
Specifies which additional view's permissions to include in the response. Only |
includeLabels
|
A comma-separated list of IDs of labels to include in the |
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 .
