Method: files.copy
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Cria uma cópia de um arquivo e aplica as atualizações solicitadas com semântica de patch. Para mais informações, consulte Criar e gerenciar arquivos.
Solicitação HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/copy
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
fileId |
string
O ID do arquivo.
|
Parâmetros de consulta
| Parâmetros |
enforceSingleParent
(deprecated) |
boolean
Descontinuado: não é mais possível copiar arquivos para várias pastas. Use atalhos.
|
ignoreDefaultVisibility |
boolean
Se as configurações de visibilidade padrão do domínio devem ser ignoradas para o arquivo criado. Os administradores de domínio podem escolher tornar todos os arquivos enviados visíveis para o domínio por padrão. Esse parâmetro ignora esse comportamento para a solicitação. As permissões ainda são herdadas das pastas principais.
|
keepRevisionForever |
boolean
Se o campo keepForever deve ser definido na nova revisão principal. Isso só se aplica a arquivos com conteúdo binário no Google Drive. Apenas 200 revisões do arquivo podem ser mantidas indefinidamente. Se o limite for atingido, tente excluir revisões fixadas.
|
ocrLanguage |
string
Uma dica de idioma para o processamento de OCR durante a importação de imagens (código ISO 639-1).
|
supportsAllDrives |
boolean
Se o aplicativo solicitante é compatível com Meu Drive e com os drives compartilhados.
|
supportsTeamDrives
(deprecated) |
boolean
Descontinuado: use supportsAllDrives.
|
includePermissionsForView |
string
Especifica quais permissões de visualização adicionais incluir na resposta. Somente published é aceito.
|
includeLabels |
string
Uma lista separada por vírgulas de IDs de rótulos a serem incluídos na parte labelInfo da resposta.
|
Corpo da solicitação
O corpo da solicitação contém uma instância de File.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de File.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.photos.readonly
Alguns escopos são restritos e exigem uma avaliação de segurança para que o app possa usá-los. Para mais informações, consulte o guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-27 UTC.
[null,null,["Última atualização 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)."]]
