ACL برای میانبر، ACL والد را به ارث می برد. ACL میانبر را نمی توان مستقیماً تغییر داد.
یک targetId که به فایل یا پوشه مورد نظر اشاره می کند که به آن "هدف" نیز گفته می شود.
یک targetMimeType که نوع MIME را برای هدف نشان می دهد. targetMimeType برای تعیین نوع نماد برای نمایش استفاده می شود. هنگام ایجاد میانبر، نوع MIME هدف در قسمت targetMimeType کپی می شود.
فیلدهای targetId و targetMimeType بخشی از قسمت shortcutDetails در منبع فایل هستند.
یک میانبر فقط می تواند یک والد داشته باشد. اگر فایل میانبر در سایر مکان‌های Drive مورد نیاز است، فایل میانبر را می‌توان در مکان‌های دیگر کپی کرد.
هنگامی که هدف حذف می شود، یا زمانی که کاربر فعلی دسترسی به هدف را از دست می دهد، میانبر کاربر که به هدف اشاره می کند شکسته می شود.
عنوان میانبر می تواند با هدف متفاوت باشد. هنگامی که یک میانبر ایجاد می شود، عنوان هدف به عنوان عنوان میانبر استفاده می شود. پس از ایجاد، عنوان میانبر و عنوان هدف را می توان به طور مستقل تغییر داد. اگر نام هدف تغییر کند، میانبرهای ایجاد شده قبلی عنوان قدیمی را حفظ می کنند.
نوع MIME یک میانبر ممکن است کهنه شود. در حالی که نادر است، نوع MIME یک فایل blob با آپلود نسخه دیگری تغییر می کند، اما هر میانبر که به فایل به روز شده اشاره می کند، نوع MIME اصلی را حفظ می کند. برای مثال، اگر یک فایل JPG را در Drive آپلود کنید، سپس یک نسخه AVI را آپلود کنید، Drive تغییر را شناسایی کرده و تصویر کوچک فایل واقعی را به‌روزرسانی می‌کند. با این حال، میانبر همچنان یک تصویر کوچک JPG دارد.
در Google Account Data Export که با نام Google Takeout نیز شناخته می‌شود، میانبرها به صورت فایل‌های نشانک Netscape حاوی پیوندهایی به هدف نشان داده می‌شوند.
برای ایجاد میانبر، نوع MIME را روی application/vnd.google-apps.shortcut تنظیم کنید، targetId را روی فایل یا پوشه ای که میانبر باید به آن پیوند دهد تنظیم کنید، و برای ایجاد میانبر، files.create را فراخوانی کنید.
مثال های زیر نحوه ایجاد میانبر با استفاده از کتابخانه مشتری را نشان می دهد:
به طور پیش‌فرض، میانبر در My Drive کاربر فعلی ایجاد می‌شود و میانبرها فقط برای فایل‌ها یا پوشه‌هایی ایجاد می‌شوند که کاربر فعلی به آنها دسترسی دارد.
جستجوی میانبر
برای جستجوی میانبر، از رشته query q با files.list استفاده کنید تا میانبرهای بازگشتی را فیلتر کنید.
mimeType operator values
کجا:
query_term عبارت یا فیلدی است که باید در آن جستجو کرد. برای مشاهده عبارت‌های درخواستی که می‌توانند برای فیلتر کردن درایوهای مشترک استفاده شوند، به عبارت جستجوی جستجو مراجعه کنید.
عملگر شرط را برای عبارت پرس و جو مشخص می کند. برای مشاهده اینکه کدام عملگرها را می توانید با هر عبارت جستجو استفاده کنید، به عملگرهای Query مراجعه کنید.
مقادیر مقادیر خاصی هستند که می خواهید برای فیلتر کردن نتایج جستجوی خود استفاده کنید.
به عنوان مثال، رشته پرس و جو زیر جستجو را فیلتر می کند تا همه میانبرها را به فایل های صفحه گسترده بازگرداند:
تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Create a shortcut to a Drive file\n\n*Shortcuts* are files that link to other files or folders on Google Drive.\nShortcuts have these characteristics:\n\n- An `application/vnd.google-apps.shortcut` MIME type. For more information,\n see [Google Workspace \\& Google Drive supported MIME\n types](/workspace/drive/api/guides/mime-types).\n\n- The ACL for a shortcut inherits the ACL of the parent. The shortcut's ACL\n cannot be changed directly.\n\n- A `targetId` pointing to the target file or folder, also referred to as the\n \"target.\"\n\n- A `targetMimeType` indicating the MIME type for the target. The\n `targetMimeType` is used to determine the type icon to display. The target's\n MIME type is copied to the `targetMimeType` field when the shortcut is\n created.\n\n- The `targetId` and `targetMimeType` fields are part of the `shortcutDetails`\n field within the [file](/workspace/drive/api/reference/rest/v3/files) resource.\n\n- A shortcut can only have one parent. If a shortcut file is required in other\n Drive locations, the shortcut file can be copied to the\n additional locations.\n\n- When the target is deleted, or when the current user loses access to the\n target, the user's shortcut pointing to the target breaks.\n\n- The title of a shortcut can differ from the target. When a shortcut is\n created, the title of the target is used as the title of the shortcut. After\n creation, the shortcut's title and target's title can be changed\n independently. If the target's name is changed, previously created shortcuts\n retain the old title.\n\n- The MIME type of a shortcut can become stale. While rare, a blob file's MIME\n type changes when a revision of a different type is uploaded, but any\n shortcuts pointing to the updated file retain the original MIME type. For\n example, if you upload a JPG file to Drive, then upload an\n AVI revision, Drive identifies the change and updates the\n thumbnail for the actual file. However, the shortcut continues to have a JPG\n thumbnail.\n\n- In [Google Account Data\n Export](https://support.google.com/accounts/answer/3024190)\n also known as Google Takeout, shortcuts are represented as Netscape\n bookmark files containing links to the target.\n\nFor more information, see [Find files \\& folders with Google Drive\nshortcuts](https://support.google.com/drive/answer/9700156)\n.\n| **Important:** Previously, shortcuts were the term for files that pointed to content stored by an application. That type of \"shortcut\" was renamed to *third-party shortcut* . For further information, see [Create a shortcut file to\n| content stored by your app](/workspace/drive/api/guides/third-party-shortcuts).\n\nCreate a shortcut\n-----------------\n\nTo create a shortcut, set the MIME type to\n`application/vnd.google-apps.shortcut`, set the `targetId` to the file or folder\nthe shortcut should link to, and call [`files.create`](/workspace/drive/api/reference/rest/v3/files/create) to create a shortcut.\n| **Note:** If you're using V2 of the API, use [`files.insert`](/workspace/drive/api/v2/reference/files/insert).\n\nThe following examples show how to create a shortcut using a client library: \n\n### Python\n\n file_metadata = {\n 'name': '\u003cvar translate=\"no\"\u003eFILE_NAME\u003c/var\u003e',\n 'mimeType': 'text/plain'\n }\n file = drive_service.files().create(body=file_metadata, fields='id').execute()\n print('File ID: %s' % file.get('id'))\n shortcut_metadata = {\n 'Name': '\u003cvar translate=\"no\"\u003eSHORTCUT_NAME\u003c/var\u003e',\n 'mimeType': 'application/vnd.google-apps.shortcut',\n 'shortcutDetails': {\n 'targetId': file.get('id')\n }\n }\n shortcut = drive_service.files().create(body=shortcut_metadata,\n fields='id,shortcutDetails').execute()\n print('File ID: %s, Shortcut Target ID: %s, Shortcut Target MIME type: %s' % (\n shortcut.get('id'),\n shortcut.get('shortcutDetails').get('targetId'),\n shortcut.get('shortcutDetails').get('targetMimeType')))\n\n### Node.js\n\n var fileMetadata = {\n 'name': '\u003cvar translate=\"no\"\u003eFILE_NAME\u003c/var\u003e',\n 'mimeType': 'text/plain'\n };\n drive.files.create({\n 'resource': fileMetadata,\n 'fields': 'id'\n }, function (err, file) {\n if (err) {\n // Handle error\n console.error(err);\n } else {\n console.log('File Id: ' + file.id);\n shortcutMetadata = {\n 'name': '\u003cvar translate=\"no\"\u003eSHORTCUT_NAME\u003c/var\u003e',\n 'mimeType': 'application/vnd.google-apps.shortcut'\n 'shortcutDetails': {\n 'targetId': file.id\n }\n };\n drive.files.create({\n 'resource': shortcutMetadata,\n 'fields': 'id,name,mimeType,shortcutDetails'\n }, function(err, shortcut) {\n if (err) {\n // Handle error\n console.error(err);\n } else {\n console.log('Shortcut Id: ' + shortcut.id +\n ', Name: ' + shortcut.name +\n ', target Id: ' + shortcut.shortcutDetails.targetId +\n ', target MIME type: ' + shortcut.shortcutDetails.targetMimeType);\n }\n }\n }\n });\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eFILE_NAME\u003c/var\u003e: the file name requiring a shortcut.\n- \u003cvar translate=\"no\"\u003eSHORTCUT_NAME\u003c/var\u003e: the name for this shortcut.\n\nBy default, the shortcut is created on the current user's My\nDrive and shortcuts are only created for files or folders for\nwhich the current user has access.\n\nSearch for a shortcut\n---------------------\n\nTo search for a shortcut, use the query string `q` with\n[`files.list`](/workspace/drive/api/v3/reference/files/list) to filter the shortcuts to\nreturn.\n\n`mimeType `*operator values*\n\nWhere:\n\n- *query_term* is the query term or field to search upon. To view the query terms that can be used to filter shared drives, refer to [Search query\n terms](/workspace/drive/api/guides/ref-search-terms#file_properties).\n- *operator* specifies the condition for the query term. To view which operators you can use with each query term, refer to [Query operators](/workspace/drive/api/guides/ref-search-terms#operators).\n- *values* are the specific values you want to use to filter your search results.\n\nFor example, the following query string filters the search to return all\nshortcuts to spreadsheet files: \n\n q: mimeType='application/vnd.google-apps.shortcut' AND shortcutDetails.targetMimeType='application/vnd.google-apps.spreadsheet'"]]
