Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Google Drive, dosyaları koleksiyonlar halinde düzenler, türlerine göre tanımlar ve dosya işlemlerini kolaylaştırmak için her dosya için belirli özellikler sağlar.
Google Drive API, Drive'da depolanan dosyaları files kaynağı olarak gösterir.
Sahiplik
Drive, dosyaları kullanıcının içerikle ilişkisine ve depolama konumuna göre düzenler. Koleksiyonlar, dosyanın Drive'da hangi dosya grubuyla birlikte depolandığını göstermek için dosyanın meta verilerinin bir parçası olarak belirtilir. Drive'ım ile ortak drive koleksiyonları arasındaki temel fark, dosya sahipliğidir. Drive'ım klasöründeki dosyaların sahibi tek bir kullanıcıdır. Ortak Drive'daki dosyaların sahibi ise bir grup veya kuruluştur.
Drive'ım
Her kullanıcının, birincil hiyerarşisi olarak işlev gören ve bu kök klasörden türeyen her şeyi içeren "Drive'ım" adlı bir "kök" klasörü vardır. Kullanıcı, bu klasörün birincil sahibidir.
Ortak Drive'lar
Ortak Drive, Drive'da Drive'ım ile paralel olarak bulunan bir kuruluş yapısıdır. Ortak drive'da veya Drive'ım'da tek bir dosyayı düzenleyebilirsiniz ancak ikisinde birden düzenleyemezsiniz. Ancak
Drive kısayolları, ortak Drive'lardaki dosyaları veya klasörleri Drive'ım bölümüne ya da tam tersi yönde işaret etmek için kullanılabilir.
Dosya türleri
Drive, dosyaları türlerine göre tanımlar. Bu listede, kullanılabilen tüm dosya türleri gösterilir:
Blob
Metin veya ikili içerik (ör.resim, video ve PDF) barındıran bir dosya
Klasör
Drive'daki diğer dosya türlerini düzenlemek için kullanabileceğiniz bir kapsayıcıdır. Klasörler yalnızca meta verileri içeren ve MIME türü application/vnd.google-apps.folder olan dosyalardır. Daha fazla bilgi için Klasör oluşturma ve klasörlere içerik ekleme başlıklı makaleyi inceleyin.
Not: Drive'ım bölümünde depolanan tek bir dosya birden fazla klasörde bulunabilir. Ortak drive'da depolanan tek bir dosyanın yalnızca bir üst klasörü olabilir.
Google Workspace dokümanı
Google Workspace uygulamaları (ör. Google Dokümanlar, E-Tablolar veya Slaytlar) tarafından oluşturulan dosyalar. MIME türü biçimi application/vnd.google-apps.*app* şeklindedir. Burada app, uygulama adıdır (ör. bir E-Tablolar dosyası için application/vnd.google-apps.spreadsheet). Drive ve Google Workspace'e özgü MIME türlerinin listesi için Google Workspace ve Google Drive'da desteklenen MIME türleri başlıklı makaleyi inceleyin.
Kısayol
Drive'daki başka bir dosyaya yönlendiren, yalnızca meta veri içeren bir dosya. Kısayol dosyasının MIME türü application/vnd.google-apps.shortcut. Daha fazla bilgi için Drive dosyasının kısayolunu oluşturma başlıklı makaleyi inceleyin.
Üçüncü taraf kısayolu
Üçüncü taraf depolama sisteminde depolanan içeriğe bağlantı veren, yalnızca meta verileri içeren bir dosya. Üçüncü taraf kısayol dosyasının MIME türü application/vnd.google-apps.drive-sdk. Daha fazla bilgi için Uygulamanız tarafından depolanan içeriklere yönelik kısayol dosyası oluşturma başlıklı makaleyi inceleyin.
Dosya özellikleri
Bu listede, Drive dosyalarının bazı özellikleri gösterilmektedir:
Erişim teklifi
İstekte bulunan bir kullanıcının, onaylayandan bir alıcıya Drive öğesine erişim izni vermesini istediği teklif. Daha fazla bilgi için Bekleyen erişim önerilerini listeleme ve çözme başlıklı makaleyi inceleyin.
İçerik
Dosyanın ikili veya metin gövdesi. Drive'da depolayabileceğiniz içeriklere örnek olarak resimler, videolar, metinler ve PDF'ler verilebilir.
Dosya kimliği
Her dosya için benzersiz ve opak bir kimlik. Dosya adının değişmesi durumunda bile dosya kimlikleri dosyanın kullanım ömrü boyunca sabit kalır. Arama ifadeleri, dosyaları ada, türe, içeriğe, üst kapsayıcıya, sahibe veya diğer meta verilere göre bulmak için kullanılır.
Meta veriler
Dosyanın içeriğini açıklayan veriler. Bu veriler arasında ad, tür, oluşturma ve değiştirme zamanları yer alır. name gibi bazı meta veri alanları kullanıcıdan bağımsızdır ve her kullanıcı için aynı şekilde görünür. capabilities ve viewedByMeDate gibi diğer alanlar kullanıcıya özel değerler içerir. Resim ve video gibi dosya türleri, EXIF ve diğer yerleştirilmiş meta verilerden çıkarılan ek meta veriler içerir. Daha fazla bilgi için Dosya meta verilerini yönetme başlıklı makaleyi inceleyin.
İzin
Bir kullanıcının, grubun, alanın veya herkesin bir dosyaya ya da klasör hiyerarşisine erişmesi için verilen erişim izni. Kullanıcılar, erişim kontrol listesi (EKL) ile bir dosyaya kimlerin erişebileceğini kontrol eder. EKL, dosyanın izinlerinin listesidir. Daha fazla bilgi için Dosya, klasör ve Drive paylaşma başlıklı makaleyi inceleyin.
Düzeltme geçmişi
Yalnızca dosya içeriğinde yapılan değişikliklerin kaydı. Dosya meta verilerinde yapılan değişiklikler bu kayda dahil değildir. Düzeltmeler hakkında daha fazla bilgi için Değişikliklere ve düzeltmelere genel bakış başlıklı makaleyi inceleyin.
Küçük resim
Dosyanın grafik gösterimi. Drive, birçok yaygın dosya türü için otomatik olarak küçük resimler oluşturur. Drive'ın oluşturamadığı kısayollar ve diğer dosya türleri için küçük resim sağlayabilirsiniz. Daha fazla bilgi için Küçük resim yükleme başlıklı makaleyi inceleyin.
Dosya düzenleme
Drive API, dosyaları spaces olarak adlandırılan depolama konumlarında ve corpora olarak adlandırılan koleksiyonlarda düzenler.
Alanlar
Birbirinden izole edilmiş belirli depolama konumları. Drive'daki tüm içerikler şu iki tanımlı alandan birinde saklanır: drive
ve appDataFolder.
drive: Drive'da oluşturulan ve kullanıcı tarafından görülebilen tüm dosyaları içerir. PDF'ler, dokümanlar, Google Dokümanları, kısayollar ve kullanıcının yüklediği diğer içerikler drive alanında bulunur.
appDataFolder: Kullanıcı başına uygulama verilerini içerir. Uygulamalar genellikle yapılandırma dosyalarını ve kullanıcıların doğrudan erişmesi amaçlanmayan diğer verileri depolar.
Dosyalar spaces arasında taşınamaz.
Corpora
Dosya ve klasör aramalarının kapsamını daraltmak için kullanılan dosya koleksiyonları. Drive için kullanılan metinler: user, domain, drive ve allDrives.
user: Kullanıcı tarafından "Drive'ım"da oluşturulan ve açılan tüm dosyalar ile "Benimle paylaşılanlar"da doğrudan kullanıcıyla paylaşılan dosyaları içerir.
drive: driveId ile belirtildiği gibi, tek bir ortak drive'da bulunan tüm dosyaları içerir.
domain: Kullanıcının alanıyla paylaşılan tüm aranabilir dosyaları içerir.
allDrives: Kullanıcının üye olduğu ortak Drive'lardaki tüm dosyaları, "Drive'ım" ve "Benimle paylaşılanlar" bölümlerindeki tüm dosyaları içerir.
allDrives gövdeleri geniş kapsamlı olduğundan ve performansı etkileyebileceğinden dikkatli kullanın. Mümkün olduğunda verimlilik için allDrives yerine user veya drive kullanın.
İzinler ve sahiplik değiştiği için dosyalar corpora arasında serbestçe taşınabilir.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-04 UTC."],[],[],null,["Google 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\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\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\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\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\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."]]
