Method: files.copy
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Belirtilen dosyanın bir kopyasını oluşturur.
HTTP isteği
POST https://www.googleapis.com/drive/v2/files/{fileId}/copy
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
fileId |
string
Kopyalanacak dosyanın kimliği.
|
Sorgu parametreleri
| Parametreler |
convert |
boolean
Bu dosyanın ilgili Dokümanlar Düzenleyicisi biçimine dönüştürülüp dönüştürülmeyeceği.
|
enforceSingleParent
(deprecated) |
boolean
Desteği sonlandırıldı: Dosyaların birden fazla klasöre kopyalanması artık desteklenmiyor. Bunun yerine kısayolları kullanın.
|
ocr |
boolean
.jpg, .png, .gif veya .pdf yüklemelerinde OCR'nin çalışıp çalışmayacağı.
|
ocrLanguage |
string
ocr doğruysa kullanılacak dile dair ipuçları verir. Geçerli değerler BCP 47 kodlarıdır.
|
pinned |
boolean
Yeni kopyanın ilk düzeltmesinin sabitlenip sabitlenmeyeceği. Bir dosyada en fazla 200 sabitlenmiş düzeltme olabilir.
|
supportsAllDrives |
boolean
İstekte bulunan uygulamanın hem Drive'ım hem de ortak Drive'ları destekleyip desteklemediği.
|
supportsTeamDrives
(deprecated) |
boolean
Desteği sonlandırıldı: Bunun yerine supportsAllDrives politikasını kullanın.
|
timedTextLanguage |
string
Zamanlanmış metnin dili.
|
timedTextTrackName |
string
Zamanlanmış altyazı parçasının adı.
|
visibility |
enum (Visibility)
Yeni dosyanın görünürlüğü. Bu parametre yalnızca kaynak doğal bir Google Dokümanı olmadığında ve convert=false olduğunda geçerlidir.
|
includePermissionsForView |
string
Yanıta hangi ek görünümün izinlerinin dahil edileceğini belirtir. Yalnızca published desteklenir.
|
includeLabels |
string
Yanıtın labelInfo bölümüne dahil edilecek etiketlerin virgülle ayrılmış kimlik listesi.
|
İstek içeriği
İstek metni, File öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılıysa yanıt metni, File öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
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
Bazı kapsamlar kısıtlıdır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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)."]]
