Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Google Drive mengatur file dalam koleksi, mendeskripsikan file berdasarkan jenis, dan
memberikan atribut khusus untuk setiap file guna memfasilitasi manipulasi file.
Google Drive API merepresentasikan file yang disimpan di Drive sebagai resource
files.
Kepemilikan
Drive mengatur file berdasarkan hubungan pengguna dengan konten dan lokasi penyimpanannya. Koleksi ditentukan sebagai bagian dari
metadata file untuk menunjukkan grup file mana yang disimpan bersama file di dalam
Drive. Perbedaan utama antara koleksi Drive Saya dan koleksi drive bersama adalah kepemilikan file. Satu pengguna adalah pemilik file di Drive Saya, sedangkan grup atau organisasi adalah pemilik file di drive bersama.
Drive Saya
Setiap pengguna memiliki folder "root" yang disebut "Drive Saya" yang berfungsi sebagai hierarki utamanya, dan terdiri dari semua yang berasal dari folder root ini. Pengguna adalah
pemilik utama folder ini.
Drive bersama
Drive bersama adalah struktur organisasi dalam Drive yang berjalan paralel dengan Drive Saya. Anda dapat mengatur satu file dalam drive bersama atau Drive Saya, tetapi tidak keduanya. Namun,
pintasan Drive dapat digunakan untuk
menunjuk ke file atau folder dari drive bersama ke Drive Saya, atau
sebaliknya.
Jenis file
Drive menjelaskan file menurut jenisnya. Daftar ini menampilkan semua jenis file yang tersedia:
Blob
File yang berisi konten teks atau biner seperti gambar, video, dan
PDF.
Folder
Penampung yang dapat Anda gunakan untuk mengatur jenis file lain di Drive. Folder adalah file yang hanya berisi metadata, dan memiliki
jenis MIME application/vnd.google-apps.folder. Untuk mengetahui informasi selengkapnya,
lihat Membuat dan mengisi folder.
Catatan: Satu file yang disimpan di Drive Saya dapat berada di beberapa folder. Satu file yang disimpan di drive bersama hanya dapat memiliki satu folder induk.
Dokumen Google Workspace
File yang dibuat oleh aplikasi Google Workspace, seperti Google Dokumen, Spreadsheet, atau Slide. Format jenis MIME adalah
application/vnd.google-apps.*app* dengan app adalah nama aplikasi
(seperti application/vnd.google-apps.spreadsheet untuk file
Spreadsheet). Untuk mengetahui daftar jenis MIME khusus Drive dan Google Workspace, lihat Jenis MIME yang didukung Google Workspace dan Google Drive.
Pintasan
File hanya metadata yang mengarah ke file lain di Drive. Jenis MIME file pintasan adalah application/vnd.google-apps.shortcut. Untuk mengetahui informasi
selengkapnya, lihat Membuat pintasan ke file
Drive.
Pintasan pihak ketiga
File hanya metadata yang ditautkan ke konten yang disimpan di sistem penyimpanan pihak ketiga. Jenis MIME file pintasan pihak ketiga adalah
application/vnd.google-apps.drive-sdk. Untuk mengetahui informasi selengkapnya, lihat Membuat file pintasan ke konten yang disimpan oleh aplikasi Anda.
Karakteristik file
Daftar ini menunjukkan beberapa karakteristik file Drive:
Isi biner atau teks file. Beberapa contoh konten yang dapat Anda simpan di
Drive adalah gambar, video, teks, dan PDF.
ID File
ID unik dan buram untuk setiap file. ID file tetap stabil selama masa aktif file, meskipun nama file berubah. Ekspresi
penelusuran digunakan untuk menemukan file berdasarkan nama,
jenis, konten, penampung induk, pemilik, atau metadata lainnya.
Metadata
Data yang menjelaskan isi file. Data ini mencakup nama, jenis,
pembuatan, dan waktu modifikasi. Beberapa kolom metadata, seperti name,
tidak bergantung pada pengguna dan muncul sama untuk setiap pengguna. Kolom lain, seperti
capabilities dan viewedByMeDate berisi nilai khusus pengguna. Jenis
file, seperti gambar dan video, berisi metadata tambahan yang diekstrak dari
EXIF dan metadata tersemat lainnya. Untuk mengetahui informasi selengkapnya, lihat Mengelola metadata
file.
Izin
Pemberian akses untuk pengguna, grup, domain, atau semua orang untuk mengakses file atau hierarki folder. Pengguna mengontrol siapa yang dapat mengakses file dengan daftar kontrol akses (ACL), yang merupakan daftar izin untuk file tersebut. Untuk mengetahui informasi selengkapnya, lihat Membagikan file, folder, dan drive.
Histori revisi
Catatan perubahan pada konten file saja, bukan metadata file. Untuk
detail selengkapnya tentang revisi, lihat Ringkasan perubahan dan revisi.
Thumbnail
Representasi grafis dari file. Drive otomatis membuat thumbnail untuk banyak jenis file umum. Untuk pintasan dan jenis file lain yang tidak dapat dirender Drive, Anda dapat memberikan gambar mini. Untuk mengetahui informasi selengkapnya, lihat Mengupload thumbnail.
Pengelolaan file
Drive API mengatur file ke dalam lokasi penyimpanan, yang disebut spaces,
dan koleksi, yang disebut corpora.
Ruang
Lokasi penyimpanan tertentu yang diisolasi satu sama lain. Semua konten di
Drive disimpan di salah satu dari dua ruang yang ditentukan ini: drive
dan appDataFolder.
drive: Mencakup semua file yang terlihat oleh pengguna yang dibuat di
Drive. PDF, dokumen, Google Dokumen, pintasan, dan
konten lain yang diupload pengguna berada di ruang drive.
appDataFolder: Mencakup data aplikasi per pengguna. Aplikasi
biasanya menyimpan file konfigurasi dan data lain yang tidak dimaksudkan untuk
dapat diakses langsung oleh pengguna.
File tidak dapat dipindahkan antar-spaces.
Corpora
Kumpulan file yang digunakan untuk mempersempit cakupan penelusuran file dan folder. Korpus untuk Drive adalah: user, domain, drive, dan
allDrives.
user: Mencakup semua file yang dibuat dan dibuka oleh pengguna di "Drive Saya", dan file yang dibagikan langsung kepada pengguna di "Dibagikan dengan saya".
drive: Mencakup semua file yang ada dalam satu drive bersama, seperti
yang ditunjukkan oleh driveId.
domain: Mencakup semua file yang dapat ditelusuri yang dibagikan dengan domain pengguna.
allDrives: Mencakup semua file di drive bersama tempat pengguna menjadi anggota, dan semua file di "Drive Saya" dan "Dibagikan kepada saya".
Gunakan korpora allDrives dengan hati-hati karena memiliki cakupan yang luas dan dapat memengaruhi performa. Jika memungkinkan, gunakan user atau drive, bukan allDrives, untuk efisiensi.
File dapat dipindahkan dengan bebas antar-corpora saat izin dan kepemilikan berubah.
[null,null,["Terakhir diperbarui pada 2025-08-04 UTC."],[],[],null,["# Files and folders overview\n\nGoogle Drive organizes files in collections, describes files by types, and\nprovides specific attributes for each file to facilitate file manipulation.\n\nThe Google Drive API represents files stored on Drive as a\n[`files`](/workspace/drive/api/reference/rest/v3/files) resource.\n| **Note:** Folders are treated as a type of file. For more details about folders, see [File types](#types).\n\nOwnership\n---------\n\nDrive organizes files based on the user's relationship with the\ncontent and its storage location. *Collections* are specified as part of the\nfile's metadata to show which group of files the file is stored with inside\nDrive. The main difference between My Drive and\nshared drive collections is file ownership. A single user is the owner of files\nin their My Drive, whereas a group or organization owns files in\na shared drive.\n\n*My Drive*\n: Each user has a \"root\" folder called \"My\n Drive\" that functions as their primary hierarchy, and\n consists of everything that descends from this root folder. The user is the\n primary owner of this folder.\n\n*Shared drives*\n: A [shared drive](/workspace/drive/api/guides/about-shareddrives) is an\n organizational structure within Drive that lives parallel to\n My Drive. You can organize an individual file within a shared\n drive or My Drive, but not both. However, [Drive shortcuts](/workspace/drive/api/guides/shortcuts) can be used to\n point to files or folders from shared drives to My Drive, or\n the other way around.\n\nFile types\n----------\n\nDrive describes files by types. This list shows all available\nfile types:\n\n*Blob*\n: A file that contains text or binary content such as images, videos, and\n PDFs.\n\n*Folder*\n\n: A container you can use to organize other types of files on\n Drive. Folders are files that only contain metadata, and have\n the MIME type `application/vnd.google-apps.folder`. For more information,\n see [Create and populate folders](/workspace/drive/api/guides/folder).\n\n **Note:** A single file stored on My Drive can be in multiple\n folders. A single file stored on a [shared\n drive](/workspace/drive/api/guides/about-shareddrives) can only have one parent folder.\n\n*Google Workspace document*\n\n: A file that a Google Workspace application\n creates, such as Google Docs, Sheets, or\n Slides. The MIME type format is\n `application/vnd.google-apps.*app*` where *app* is the application name\n (such as `application/vnd.google-apps.spreadsheet` for a\n Sheets file). For a list of Drive and\n Google Workspace-specific MIME types, see [Google Workspace and\n Google Drive supported MIME types](/workspace/drive/api/guides/mime-types).\n\n*Shortcut*\n\n: A metadata-only file that points to another file on Drive. The\n shortcut file MIME type is `application/vnd.google-apps.shortcut`. For more\n information, see [Create a shortcut to a Drive\n file](/workspace/drive/api/guides/shortcuts).\n\n*Third-party shortcut*\n\n: A metadata-only file that links to content stored on a third-party storage\n system. The third-party shortcut file MIME type is\n `application/vnd.google-apps.drive-sdk`. For more information, see [Create a\n shortcut file to content stored by your\n app](/workspace/drive/api/guides/third-party-shortcuts).\n\n| **Note:** You cannot upload or download folders, Google Workspace documents, shortcuts, and third-party shortcuts to or from Drive. However, if they use compatible formats you can upload or export Google Workspace documents. For example, you can create a Docs document when you import a PDF. Similarly, you can export a Google Slides presentation as a Microsoft PowerPoint file.\n\nFile characteristics\n--------------------\n\nThis list shows some characteristics of a Drive file:\n\n*Access proposal*\n: A proposal from a requester to an approver to grant a recipient access to a\n Drive item. For more information, see [List and resolve\n pending access\n proposals](/workspace/drive/api/guides/manage-sharing#access-proposals).\n\n*Content*\n: The binary or text body of the file. Some content examples you can store in\n Drive are images, videos, text, and PDFs.\n\n*File ID*\n: A unique, opaque ID for each file. File IDs are stable throughout the life of\n the file, even if the file name changes. [Search\n expressions](/workspace/drive/api/guides/search-files) are used to locate files by name,\n type, content, parent container, owner, or other metadata.\n\n*Metadata*\n: Data describing the contents of the file. This data includes the name, type,\n creation, and modification times. Some metadata fields, such as the `name`,\n are user-agnostic and appear the same for each user. Other fields, such as\n `capabilities` and `viewedByMeDate` contain user-specific values. File\n types, such as images and videos, contain additional metadata extracted from\n EXIF and other embedded metadata. For more information, see [Manage file\n metadata](/workspace/drive/api/guides/file).\n\n*Permission*\n: An access grant for a user, group, domain, or the world to access a file or a\n folder hierarchy. Users control who can access a file with the access\n control list (ACL), which is a list of permissions for the file. For more\n information, see [Share files, folders and\n drives](/workspace/drive/api/guides/manage-sharing).\n\n*Revision history*\n: The record of changes to the file content only, not the file metadata. For\n more details about revisions, see [Changes and revisions overview](/workspace/drive/api/guides/change-overview).\n\n*Thumbnail*\n: A graphical representation of a file. Drive automatically\n generates thumbnails for many common file types. For shortcuts and other\n file types that Drive can't render, you can provide a\n thumbnail image. For more information, see [Upload thumbnails](/workspace/drive/api/guides/file#upload-thumbnails).\n\nFile organization\n-----------------\n\nThe Drive API organizes files into storage locations, called `spaces`,\nand collections, called `corpora`.\n\n*Spaces*\n\n: Specific storage locations that are isolated from each other. All content in\n Drive is stored in one of these two defined spaces: `drive`\n and `appDataFolder`.\n\n - `drive`: Includes all user-visible files created in\n Drive. PDFs, documents, Google Docs, shortcuts, and\n other content the user uploads is located in the `drive` space.\n\n - `appDataFolder`: Includes per-user application data. Applications\n typically store configuration files and other data not intended to be\n directly accessible by users.\n\n Files cannot move between `spaces`.\n\n*Corpora*\n\n: Collections of files used to narrow the scope of file and folder searches. The\n corpora for Drive are: `user`, `domain`, `drive`, and\n `allDrives`.\n\n - `user`: Includes all files created by and opened by the user in \"My\n Drive\", and those shared directly with the user in\n \"Shared with me.\"\n\n - `drive`: Includes all files contained in a single shared drive, as\n indicated by the `driveId`.\n\n - `domain`: Includes all searchable files shared with the user's domain.\n\n - `allDrives`: Includes all files in shared drives where the user is a\n member, and all files in \"My Drive\" and \"Shared with me.\"\n Use the `allDrives` corpora with caution as it has a broad scope and can\n affect performance. When possible, use `user` or `drive` instead of\n `allDrives` for efficiency.\n\n Files can move freely between `corpora` as permissions and ownership change.\n\nRelated topics\n--------------\n\nHere are a few next steps you might take:\n\n- Learn how to [Create and manage files](/workspace/drive/api/guides/create-file).\n- Learn how to [Create and populate folders](/workspace/drive/api/guides/folder).\n- Learn how to [Upload file data](/workspace/drive/api/guides/manage-uploads).\n- Learn how to [Download and export files](/workspace/drive/api/guides/manage-downloads).\n- Learn how to [Store application-specific data](/workspace/drive/api/guides/appdata).\n- Learn how to [Display the Google Picker](/workspace/drive/api/guides/picker) on a page."]]
