Method: files.copy
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt eine Kopie der angegebenen Datei.
HTTP-Anfrage
POST https://www.googleapis.com/drive/v2/files/{fileId}/copy
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
fileId |
string
Die ID der zu kopierenden Datei.
|
Abfrageparameter
| Parameter |
convert |
boolean
Ob diese Datei in das entsprechende Google Docs-Editoren-Format konvertiert werden soll.
|
enforceSingleParent
(deprecated) |
boolean
Eingestellt: Das Kopieren von Dateien in mehrere Ordner wird nicht mehr unterstützt. Verwenden Sie stattdessen Tastenkombinationen.
|
ocr |
boolean
Ob OCR für JPG-, PNG-, GIF- oder PDF-Uploads versucht werden soll.
|
ocrLanguage |
string
Wenn ocr „true“ ist, wird die zu verwendende Sprache angegeben. Gültige Werte sind BCP 47-Codes.
|
pinned |
boolean
Ob die Hauptversion der neuen Kopie angepinnt werden soll. Eine Datei kann maximal 200 angepinnte Versionen haben.
|
supportsAllDrives |
boolean
Ob die anfragende Anwendung sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt.
|
supportsTeamDrives
(deprecated) |
boolean
Verworfen. Verwenden Sie stattdessen supportsAllDrives.
|
timedTextLanguage |
string
Die Sprache des synchronisierten Textes.
|
timedTextTrackName |
string
Der Name des Zeitgeber-Texttracks.
|
visibility |
enum (Visibility)
Die Sichtbarkeit der neuen Datei. Dieser Parameter ist nur relevant, wenn die Quelle kein natives Google-Dokument ist und „convert“ auf „false“ gesetzt ist.
|
includePermissionsForView |
string
Gibt an, welche Berechtigungen der zusätzlichen Ansicht in der Antwort enthalten sein sollen. Nur published wird unterstützt.
|
includeLabels |
string
Eine durch Kommas getrennte Liste von IDs von Labels, die in den Teil labelInfo der Antwort aufgenommen werden sollen.
|
Anfragetext
Der Anfragetext enthält eine Instanz von File.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von File.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
