Method: files.copy
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Crea una copia del archivo especificado.
Solicitud HTTP
POST https://www.googleapis.com/drive/v2/files/{fileId}/copy
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
fileId |
string
Es el ID del archivo que se copiará.
|
Parámetros de consulta
| Parámetros |
convert |
boolean
Indica si quieres convertir este archivo al formato correspondiente de Documentos de Google.
|
enforceSingleParent
(deprecated) |
boolean
Obsoleto: Ya no se admite copiar archivos en varias carpetas. En su lugar, usa combinaciones de teclas.
|
ocr |
boolean
Si se debe intentar el OCR en las cargas de archivos .jpg, .png, .gif o .pdf
|
ocrLanguage |
string
Si ocr es verdadero, insinúa el idioma que se debe usar. Los valores válidos son los códigos BCP 47.
|
pinned |
boolean
Indica si se debe fijar la revisión principal de la copia nueva. Un archivo puede tener un máximo de 200 revisiones fijadas.
|
supportsAllDrives |
boolean
Si la aplicación solicitante admite Mi unidad y unidades compartidas.
|
supportsTeamDrives
(deprecated) |
boolean
Obsoleto: Usa supportsAllDrives en su lugar.
|
timedTextLanguage |
string
Es el idioma del texto sincronizado.
|
timedTextTrackName |
string
Es el nombre de la pista de texto sincronizado.
|
visibility |
enum (Visibility)
La visibilidad del archivo nuevo. Este parámetro solo es relevante cuando la fuente no es un Documento de Google nativo y convert=false.
|
includePermissionsForView |
string
Especifica qué permisos de vista adicionales se incluirán en la respuesta. Solo se admite published.
|
includeLabels |
string
Es una lista separada por comas de los IDs de las etiquetas que se incluyen en la parte labelInfo de la respuesta.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de File.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de File.
Alcances de autorización
Se necesita uno de los siguientes permisos de OAuth:
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
Algunos permisos están restringidos y requieren una evaluación de seguridad para que tu app los use. Para obtener más información, consulta la Guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (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 the specified file.\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v2/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 to copy. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `convert` | `boolean` Whether to convert this file to the corresponding Docs Editors format. |\n| `enforceSingleParent` **(deprecated)** | `boolean` Deprecated: Copying files into multiple folders is no longer supported. Use shortcuts instead. |\n| `ocr` | `boolean` Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads. |\n| `ocrLanguage` | `string` If `ocr` is true, hints at the language to use. Valid values are BCP 47 codes. |\n| `pinned` | `boolean` Whether to pin the head revision of the new copy. A file can have a maximum of 200 pinned revisions. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `timedTextLanguage` | `string` The language of the timed text. |\n| `timedTextTrackName` | `string` The timed text track name. |\n| `visibility` | `enum (`[Visibility](/workspace/drive/api/reference/rest/v2/Visibility)`)` The visibility of the new file. This parameter is only relevant when the source is not a native Google Doc and convert=false. |\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/v2/files#File).\n\n### Response body\n\nIf successful, the response body contains an instance of [File](/workspace/drive/api/reference/rest/v2/files#File).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\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.apps.readonly`\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)."]]
