با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Google Drive فایلها را در مجموعهها سازماندهی میکند، فایلها را بر اساس انواع توصیف میکند و ویژگیهای خاصی را برای هر فایل برای تسهیل دستکاری فایل ارائه میکند.
Google Drive API فایل های ذخیره شده در Drive را به عنوان منبع files نشان می دهد.
مالکیت
Drive فایل ها را بر اساس رابطه کاربر با محتوا و محل ذخیره آن سازماندهی می کند. مجموعه ها به عنوان بخشی از فراداده فایل مشخص می شوند تا نشان دهند فایل با کدام گروه از فایل ها در Drive ذخیره می شود. تفاوت اصلی بین My Drive و مجموعههای درایو مشترک، مالکیت فایل است. یک کاربر تنها مالک فایلها در My Drive خود است، در حالی که یک گروه یا سازمان مالک فایلها در درایو مشترک است.
My Drive
هر کاربر یک پوشه "ریشه" به نام "درایو من" دارد که به عنوان سلسله مراتب اولیه آنها عمل می کند و شامل هر چیزی است که از این پوشه ریشه می آید. کاربر مالک اصلی این پوشه است.
درایوهای مشترک
درایو مشترک یک ساختار سازمانی در Drive است که به موازات My Drive زندگی میکند. می توانید یک فایل جداگانه را در یک درایو مشترک یا My Drive سازماندهی کنید، اما نه هر دو. با این حال، از میانبرهای Drive میتوان برای اشاره به فایلها یا پوشهها از درایوهای مشترک به My Drive یا برعکس استفاده کرد.
انواع فایل
Drive فایل ها را بر اساس انواع توصیف می کند. این لیست تمام انواع فایل های موجود را نشان می دهد:
لکه
فایلی که حاوی متن یا محتوای باینری مانند تصاویر، فیلم ها و فایل های PDF است.
پوشه
ظرفی که میتوانید از آن برای سازماندهی انواع دیگر فایلها در Drive استفاده کنید. پوشه ها فایل هایی هستند که فقط حاوی فراداده هستند و دارای نوع MIME application/vnd.google-apps.folder هستند. برای اطلاعات بیشتر، به ایجاد و پر کردن پوشهها مراجعه کنید.
توجه: یک فایل واحد ذخیره شده در My Drive می تواند در چندین پوشه باشد. یک فایل واحد ذخیره شده در درایو مشترک فقط می تواند یک پوشه والد داشته باشد.
سند Google Workspace
فایلی که یک برنامه Google Workspace ایجاد میکند، مانند Google Docs، Sheets یا Slides. قالب نوع MIME application/vnd.google-apps.*app* است که برنامه نام برنامه است (مانند application/vnd.google-apps.spreadsheet برای فایل Sheets). برای لیستی از انواع MIME مخصوص Drive و Google Workspace، به انواع MIME پشتیبانی شده Google Workspace و Google Drive مراجعه کنید.
میانبر
یک فایل فقط متادیتا که به فایل دیگری در Drive اشاره می کند. نوع فایل میانبر MIME application/vnd.google-apps.shortcut است. برای اطلاعات بیشتر، به ایجاد میانبر برای فایل Drive مراجعه کنید.
میانبر شخص ثالث
یک فایل فقط متادیتا که به محتوای ذخیره شده در یک سیستم ذخیره سازی شخص ثالث پیوند می دهد. نوع فایل میانبر شخص ثالث MIME application/vnd.google-apps.drive-sdk است. برای اطلاعات بیشتر، به ایجاد فایل میانبر برای محتوای ذخیره شده توسط برنامه خود مراجعه کنید.
مشخصات فایل
این لیست برخی از ویژگی های یک فایل Drive را نشان می دهد:
بدنه باینری یا متنی فایل. برخی از نمونههای محتوایی که میتوانید در Drive ذخیره کنید، تصاویر، ویدیوها، متن و PDF هستند.
شناسه فایل
یک شناسه منحصر به فرد و غیر شفاف برای هر فایل. شناسه های فایل در طول عمر فایل ثابت هستند، حتی اگر نام فایل تغییر کند. عبارات جستجو برای مکان یابی فایل ها بر اساس نام، نوع، محتوا، محفظه والد، مالک یا سایر ابرداده ها استفاده می شود.
فراداده
داده هایی که محتویات فایل را توصیف می کند. این داده ها شامل نام، نوع، زمان ایجاد و تغییر است. برخی از فیلدهای فراداده، مانند name ، برای کاربر ناشناس هستند و برای هر کاربر یکسان ظاهر می شوند. فیلدهای دیگر، مانند capabilities و viewedByMeDate حاوی مقادیر خاص کاربر هستند. انواع فایلها، مانند تصاویر و ویدئوها، حاوی ابردادههای اضافی استخراجشده از EXIF و دیگر ابردادههای تعبیهشده هستند. برای اطلاعات بیشتر، به مدیریت فراداده فایل مراجعه کنید.
اجازه
اجازه دسترسی برای کاربر، گروه، دامنه یا جهان برای دسترسی به یک فایل یا یک سلسله مراتب پوشه. کاربران کنترل می کنند که چه کسی می تواند به یک فایل با لیست کنترل دسترسی (ACL) دسترسی داشته باشد، که لیستی از مجوزهای فایل است. برای اطلاعات بیشتر، به اشتراک گذاری فایل ها، پوشه ها و درایوها مراجعه کنید.
تاریخچه تجدید نظر
رکورد تغییرات فقط در محتوای فایل، نه فراداده فایل. برای جزئیات بیشتر درباره بازبینیها، به نمای کلی تغییرات و تجدیدنظرها مراجعه کنید.
تصویر کوچک
نمایش گرافیکی یک فایل Drive به طور خودکار برای بسیاری از انواع فایل های رایج تصاویر کوچک تولید می کند. برای میانبرها و سایر انواع فایلهایی که Drive نمیتواند ارائه کند، میتوانید یک تصویر کوچک ارائه کنید. برای اطلاعات بیشتر، آپلود ریز عکسها را ببینید.
سازماندهی پرونده
Drive API فایلها را در مکانهای ذخیرهسازی به نام spaces و مجموعههایی به نام corpora سازماندهی میکند.
فضاها
مکان های ذخیره سازی خاصی که از یکدیگر جدا هستند. تمام محتوای درایو در یکی از این دو فضای تعریف شده ذخیره میشود: drive و appDataFolder .
drive : شامل تمام فایلهای قابل مشاهده توسط کاربر است که در Drive ایجاد شدهاند. فایلهای PDF، اسناد، Google Docs، میانبرها و سایر محتوایی که کاربر آپلود میکند در فضای drive قرار دارد.
appDataFolder : شامل داده های برنامه هر کاربر است. برنامهها معمولاً فایلهای پیکربندی و سایر دادههایی را ذخیره میکنند که قرار نیست مستقیماً توسط کاربران قابل دسترسی باشند.
فایل ها نمی توانند بین spaces حرکت کنند.
Corpora
مجموعه فایلهایی که برای محدود کردن دامنه جستجوی فایلها و پوشهها استفاده میشوند. مجموعههای درایو عبارتند از: user ، domain ، drive و allDrives .
user : شامل تمام فایلهایی است که توسط کاربر در «درایو من» ایجاد شده و توسط کاربر باز شده و در «اشتراکگذاری شده با من» مستقیماً با کاربر به اشتراک گذاشته شده است.
drive : شامل تمام فایلهای موجود در یک درایو مشترک است، همانطور که در driveId نشان داده شده است.
domain : شامل تمام فایل های قابل جستجو به اشتراک گذاشته شده با دامنه کاربر است.
allDrives : شامل همه فایلها در درایوهای مشترک که کاربر در آن عضو است، و همه فایلهای موجود در «درایو من» و «اشتراکگذاری شده با من». از allDrives corpora با احتیاط استفاده کنید زیرا دامنه وسیعی دارد و می تواند بر عملکرد تأثیر بگذارد. در صورت امکان، از user یا drive به جای allDrives برای کارایی استفاده کنید.
با تغییر مجوزها و مالکیت، فایلها میتوانند آزادانه بین corpora حرکت کنند.
موضوعات مرتبط
در اینجا چند مرحله بعدی وجود دارد که ممکن است بردارید:
تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]