Method: files.insert

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 setiap 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 hal seperti "title": "cat.jpg" dalam metadata.

Permintaan GET berikutnya akan menyertakan properti fileExtension hanya baca yang diisi dengan ekstensi yang awalnya ditentukan di 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 diperlukan. Selain itu, kolom ini tidak ditampilkan di widget "Coba metode ini" karena widget tidak mendukung upload data.

Nilai yang dapat diterima:

  • media - Upload sederhana. Upload media saja, tanpa metadata apa pun.
  • multipart - Upload multibagian. Upload media dan metadatanya, dalam satu permintaan.
  • resumable - Upload yang dapat dilanjutkan. Upload file dengan cara yang dapat dilanjutkan, menggunakan serangkaian minimal dua permintaan dengan permintaan pertama menyertakan metadata.
convert

boolean

Apakah ingin mengonversi file ini ke format Editor Dokumen yang sesuai.

enforceSingleParent
(deprecated)

boolean

Tidak digunakan lagi: Membuat file di beberapa folder tidak lagi didukung.

ocr

boolean

Apakah akan mencoba OCR pada upload berformat .jpg, .png, .gif, atau .pdf.

ocrLanguage

string

Jika ocr bernilai benar (true), petunjuk tentang bahasa yang akan digunakan. Nilai yang valid adalah kode BCP 47.

pinned

boolean

Apakah akan menyematkan revisi utama pada file yang diupload. 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 yang dibatasi 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 convert=false.

includePermissionsForView

string

Menentukan izin tampilan tambahan 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 akan berisi 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 memerlukan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk informasi selengkapnya, lihat Panduan otorisasi.