Crea una copia de un archivo y aplica las actualizaciones solicitadas con semántica de parche. Para obtener más información, consulta Crea y administra archivos.
Solicitud HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/copy
Obsoleto: Ya no se admite la copia de archivos en varias carpetas. En su lugar, usa combinaciones de teclas.
ignoreDefaultVisibility
boolean
Indica si se deben ignorar los parámetros de configuración de visibilidad predeterminados del dominio para el archivo creado. Los administradores del dominio pueden elegir que todos los archivos subidos sean visibles para el dominio de forma predeterminada. Este parámetro anula ese comportamiento para la solicitud. Los permisos se siguen heredando de las carpetas superiores.
keepRevisionForever
boolean
Indica si se debe establecer el campo keepForever en la nueva revisión principal. Esto solo se aplica a los archivos con contenido binario en Google Drive. Solo se pueden conservar 200 revisiones del archivo de forma permanente. Si se alcanza el límite, intenta borrar las revisiones fijadas.
ocrLanguage
string
Es una sugerencia de idioma para el procesamiento de OCR durante la importación de imágenes (código ISO 639-1).
supportsAllDrives
boolean
Indica si la aplicación solicitante admite tanto Mi unidad como las unidades compartidas.
supportsTeamDrives (deprecated)
boolean
Obsoleto: Usa supportsAllDrives en su lugar.
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 incluirán 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:
Algunos alcances 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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-27 (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)."]]
