Method: files.copy
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Membuat salinan file dan menerapkan pembaruan yang diminta dengan semantik patch. Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengelola file.
Permintaan HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/copy
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
fileId |
string
ID file.
|
Parameter kueri
| Parameter |
enforceSingleParent
(deprecated) |
boolean
Tidak digunakan lagi: Menyalin file ke beberapa folder tidak lagi didukung. Gunakan pintasan sebagai gantinya.
|
ignoreDefaultVisibility |
boolean
Apakah akan mengabaikan setelan visibilitas default domain untuk file yang dibuat. Administrator domain dapat memilih untuk membuat semua file yang diupload terlihat oleh domain secara default; parameter ini melewati perilaku tersebut untuk permintaan. Izin masih diwarisi dari folder induk.
|
keepRevisionForever |
boolean
Apakah akan menyetel kolom keepForever dalam revisi head baru. Opsi ini hanya berlaku untuk file dengan konten biner di Google Drive. Hanya 200 revisi untuk file yang dapat disimpan selamanya. Jika batas tercapai, coba hapus revisi yang disematkan.
|
ocrLanguage |
string
Petunjuk bahasa untuk pemrosesan OCR selama impor gambar (kode ISO 639-1).
|
supportsAllDrives |
boolean
Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama.
|
supportsTeamDrives
(deprecated) |
boolean
Tidak digunakan lagi: Gunakan supportsAllDrives sebagai gantinya.
|
includePermissionsForView |
string
Menentukan izin tampilan tambahan mana yang akan disertakan dalam respons. Hanya published yang didukung.
|
includeLabels |
string
Daftar ID label yang dipisahkan koma untuk disertakan dalam bagian labelInfo respons.
|
Isi permintaan
Isi permintaan memuat instance File.
Isi respons
Jika berhasil, isi respons memuat instance File.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
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
Beberapa cakupan dibatasi dan memerlukan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-27 UTC.
[null,null,["Terakhir diperbarui pada 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)."]]
