Halaman ini diterjemahkan oleh Cloud Translation API.

Method: files.insert

Permintaan HTTP
Parameter kueri
Isi permintaan
Isi respons
Cakupan otorisasi
Cobalah

Menyisipkan file baru.

Metode ini mendukung URI /upload dan menerima media yang diupload dengan karakteristik berikut:

Ukuran file maksimum:5.120 GB
Jenis MIME Media yang diterima:*/*

Catatan: Tentukan jenis MIME yang valid, bukan nilai */* literal. */* literal hanya digunakan untuk menunjukkan bahwa jenis MIME yang valid dapat diupload.

Untuk mengetahui informasi selengkapnya tentang cara mengupload file, lihat Mengupload data file.

Aplikasi yang membuat pintasan dengan files.insert harus menentukan jenis MIME application/vnd.google-apps.shortcut.

Aplikasi harus menentukan ekstensi file di properti title saat menyisipkan file dengan API. Misalnya, operasi untuk menyisipkan file JPEG harus menentukan sesuatu seperti "title": "cat.jpg" dalam metadata.

Permintaan GET berikutnya mencakup properti fileExtension hanya baca yang diisi dengan ekstensi yang awalnya ditentukan dalam properti title. Saat pengguna Google Drive meminta untuk mendownload file, atau saat file didownload melalui klien sinkronisasi, Drive akan membuat nama file lengkap (dengan ekstensi) berdasarkan judul. Jika ekstensi tidak ada, Drive akan mencoba menentukan ekstensi berdasarkan jenis MIME file.

Permintaan HTTP

URI Upload, untuk permintaan upload media:
POST https://www.googleapis.com/upload/drive/v2/files
URI Metadata, untuk permintaan khusus metadata:
POST https://www.googleapis.com/drive/v2/files

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
`uploadType`	`string` Jenis permintaan upload ke URI `/upload`. Jika Anda mengupload data dengan URI `/upload`, kolom ini wajib diisi. Jika Anda membuat file khusus metadata, kolom ini tidak wajib. Selain itu, kolom ini tidak ditampilkan di widget "Coba metode ini" karena widget tersebut tidak mendukung upload data. Nilai yang dapat diterima adalah: `media` - Upload sederhana. Upload media saja, tanpa metadata apa pun. `multipart` - Upload multibagian. Mengupload media dan metadatanya, dalam satu permintaan. `resumable` - Upload yang dapat dilanjutkan. Upload file dengan cara yang dapat dilanjutkan, menggunakan serangkaian setidaknya dua permintaan jika permintaan pertama menyertakan metadata.
`convert`	`boolean` Apakah akan mengonversi file ini ke format Editor Dokumen yang sesuai.
`enforceSingleParent (deprecated)`	`boolean` Tidak digunakan lagi: Pembuatan file di beberapa folder tidak lagi didukung.
`ocr`	`boolean` Coba OCR pada upload .jpg, .png, .gif, atau .pdf.
`ocrLanguage`	`string` Jika ocr bernilai benar, petunjuk tentang bahasa yang akan digunakan. Nilai yang valid adalah kode BCP 47.
`pinned`	`boolean` Apakah akan menyematkan revisi kepala file yang diupload. Sebuah file dapat memiliki maksimum 200 revisi yang disematkan.
`supportsAllDrives`	`boolean` Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama.
`supportsTeamDrives (deprecated)`	`boolean` Tidak digunakan lagi: Sebagai gantinya, gunakan `supportsAllDrives`.
`timedTextLanguage`	`string` Bahasa teks dengan waktu.
`timedTextTrackName`	`string` Nama trek teks dengan waktu.
`useContentAsIndexableText`	`boolean` Apakah akan menggunakan konten sebagai teks yang dapat diindeks.
`visibility`	`enum (Visibility)` Visibilitas file baru. Parameter ini hanya relevan saat conversion=false.
`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 di 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/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

Beberapa cakupan dibatasi dan membutuhkan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.