Erstellt eine Kopie einer Datei und wendet alle angeforderten Updates mit Patch-Semantik an. Weitere Informationen finden Sie unter Dateien erstellen und verwalten.
HTTP-Anfrage
POST https://www.googleapis.com/drive/v3/files/{fileId}/copy
Eingestellt: Das Kopieren von Dateien in mehrere Ordner wird nicht mehr unterstützt. Verwenden Sie stattdessen Tastenkombinationen.
ignoreDefaultVisibility
boolean
Gibt an, ob die Standardeinstellungen für die Sichtbarkeit der Domain für die erstellte Datei ignoriert werden sollen. Domain-Administratoren können festlegen, dass alle hochgeladenen Dateien standardmäßig für die Domain sichtbar sind. Dieser Parameter umgeht dieses Verhalten für die Anfrage. Berechtigungen werden weiterhin von übergeordneten Ordnern übernommen.
keepRevisionForever
boolean
Gibt an, ob das Feld keepForever in der neuen Head-Revision festgelegt werden soll. Das gilt nur für Dateien mit binären Inhalten in Google Drive. Es können nur 200 Überarbeitungen der Datei dauerhaft gespeichert werden. Wenn das Limit erreicht ist, können Sie versuchen, angepinnte Überarbeitungen zu löschen.
ocrLanguage
string
Ein Sprachhinweis für die OCR-Verarbeitung beim Importieren von Bildern (ISO 639-1-Code).
supportsAllDrives
boolean
Ob die anfragende Anwendung sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt.
supportsTeamDrives (deprecated)
boolean
Verworfen: Verwenden Sie stattdessen supportsAllDrives.
includePermissionsForView
string
Gibt an, welche Berechtigungen für zusätzliche Ansichten in die Antwort aufgenommen werden sollen. Nur published wird unterstützt.
includeLabels
string
Eine durch Kommas getrennte Liste mit IDs von Labels, die im labelInfo-Teil der Antwort enthalten sein sollen.
Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung für Ihre App, damit sie verwendet werden können. Weitere Informationen finden Sie im Autorisierungsleitfaden.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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)."]]
