یک میانبر برای فایل Drive ایجاد کنید

میانبرها فایل‌هایی هستند که به فایل‌ها یا پوشه‌های دیگر در گوگل درایو لینک می‌شوند. میانبرها این ویژگی‌ها را دارند:

• یک نوع MIME از application/vnd.google-apps.shortcut . برای اطلاعات بیشتر، به انواع MIME پشتیبانی‌شده توسط Google Workspace و Google Drive مراجعه کنید.

• ACL مربوط به یک میانبر، ACL مربوط به والد را به ارث می‌برد. ACL میانبر را نمی‌توان مستقیماً تغییر داد.

• یک targetId که به فایل یا پوشه هدف اشاره می‌کند، که به آن "target" نیز گفته می‌شود.

• یک targetMimeType که نوع MIME را برای هدف نشان می‌دهد. targetMimeType برای تعیین نوع آیکونی که باید نمایش داده شود استفاده می‌شود. نوع MIME هدف هنگام ایجاد میانبر در فیلد targetMimeType کپی می‌شود.

• فیلدهای targetId و targetMimeType بخشی از فیلد shortcutDetails در منبع فایل هستند.

• یک میانبر فقط می‌تواند یک والد داشته باشد. اگر به یک فایل میانبر در مکان‌های دیگر درایو نیاز باشد، می‌توان فایل میانبر را در مکان‌های اضافی کپی کرد.

• وقتی هدف حذف می‌شود، یا وقتی کاربر فعلی دسترسی به هدف را از دست می‌دهد، میانبر کاربر که به هدف اشاره می‌کند، از بین می‌رود.

• عنوان یک میانبر می‌تواند با عنوان هدف متفاوت باشد. وقتی یک میانبر ایجاد می‌شود، عنوان هدف به عنوان عنوان میانبر استفاده می‌شود. پس از ایجاد، عنوان میانبر و عنوان هدف می‌توانند به طور مستقل تغییر کنند. اگر نام هدف تغییر کند، میانبرهای ایجاد شده قبلی عنوان قدیمی را حفظ می‌کنند.

• نوع MIME یک میانبر می‌تواند قدیمی شود. اگرچه نادر است، اما نوع MIME یک فایل blob هنگام آپلود یک نسخه از نوع متفاوت تغییر می‌کند، اما هر میانبری که به فایل به‌روزرسانی‌شده اشاره می‌کند، نوع MIME اصلی را حفظ می‌کند. به عنوان مثال، اگر یک فایل JPG را در Drive آپلود کنید، سپس یک نسخه AVI را آپلود کنید، Drive تغییر را شناسایی کرده و تصویر کوچک فایل واقعی را به‌روزرسانی می‌کند. با این حال، میانبر همچنان یک تصویر کوچک JPG خواهد داشت.

• در «خروجی داده‌های حساب گوگل» که با نام «خروجی گوگل» نیز شناخته می‌شود، میانبرها به صورت فایل‌های نشانک نت‌اسکیپ نمایش داده می‌شوند که حاوی پیوندهایی به هدف هستند.

برای اطلاعات بیشتر، به «یافتن فایل‌ها و پوشه‌ها با میانبرهای Google Drive» مراجعه کنید.

ایجاد یک میانبر

برای ایجاد یک میانبر، نوع MIME را روی application/vnd.google-apps.shortcut تنظیم کنید، targetId را روی فایل یا پوشه‌ای که میانبر باید به آن لینک شود تنظیم کنید و برای ایجاد میانبر، files.create را فراخوانی کنید.

مثال‌های زیر نحوه ایجاد یک میانبر با استفاده از یک کتابخانه کلاینت را نشان می‌دهند:

file_metadata = {
    'name': 'FILE_NAME',
    'mimeType': 'text/plain'
}
file = drive_service.files().create(body=file_metadata, fields='id').execute()
print('File ID: %s' % file.get('id'))
shortcut_metadata = {
     'Name': 'SHORTCUT_NAME',
     'mimeType': 'application/vnd.google-apps.shortcut',
     'shortcutDetails': {
        'targetId': file.get('id')
     }
}
shortcut = drive_service.files().create(body=shortcut_metadata,
                                    fields='id,shortcutDetails').execute()
print('File ID: %s, Shortcut Target ID: %s, Shortcut Target MIME type: %s' % (
    shortcut.get('id'),
    shortcut.get('shortcutDetails').get('targetId'),
    shortcut.get('shortcutDetails').get('targetMimeType')))

var fileMetadata = {
  'name': 'FILE_NAME',
  'mimeType': 'text/plain'
};
drive.files.create({
  'resource': fileMetadata,
  'fields': 'id'
}, function (err, file) {
  if (err) {
    // Handle error
    console.error(err);
  } else {
    console.log('File Id: ' + file.id);
    shortcutMetadata = {
      'name': 'SHORTCUT_NAME',
      'mimeType': 'application/vnd.google-apps.shortcut'
      'shortcutDetails': {
        'targetId': file.id
      }
    };
    drive.files.create({
      'resource': shortcutMetadata,
      'fields': 'id,name,mimeType,shortcutDetails'
    }, function(err, shortcut) {
      if (err) {
        // Handle error
        console.error(err);
      } else {
        console.log('Shortcut Id: ' + shortcut.id +
                    ', Name: ' + shortcut.name +
                    ', target Id: ' + shortcut.shortcutDetails.targetId +
                    ', target MIME type: ' + shortcut.shortcutDetails.targetMimeType);
      }
    }
  }
});

موارد زیر را جایگزین کنید:

• FILE_NAME : نام فایلی که نیاز به میانبر دارد.
• SHORTCUT_NAME : نام این میانبر.

به طور پیش‌فرض، میانبر در My Drive کاربر فعلی ایجاد می‌شود و میانبرها فقط برای فایل‌ها یا پوشه‌هایی ایجاد می‌شوند که کاربر فعلی به آنها دسترسی دارد.

جستجوی میانبر

برای جستجوی یک میانبر، از رشته پرس‌وجوی q به همراه files.list برای فیلتر کردن میانبرهای برگشتی استفاده کنید.

mimeType operator values

کجا:

• query_term عبارت یا فیلد پرس‌وجو برای جستجو است. برای مشاهده عبارات پرس‌وجو که می‌توانند برای فیلتر کردن درایوهای مشترک استفاده شوند، به Search query terms مراجعه کنید.
• عملگر ` `شرط را برای عبارت پرس‌وجو مشخص می‌کند. برای مشاهده‌ی عملگرهایی که می‌توانید با هر عبارت پرس‌وجو استفاده کنید، به ``عملگرهای پرس‌وجو`` مراجعه کنید.
• مقادیر ، مقادیر خاصی هستند که می‌خواهید برای فیلتر کردن نتایج جستجوی خود از آنها استفاده کنید.

برای مثال، رشته پرس‌وجوی زیر جستجو را فیلتر می‌کند تا همه میانبرها را به فایل‌های صفحه گسترده برگرداند:

q: mimeType='application/vnd.google-apps.shortcut' AND shortcutDetails.targetMimeType='application/vnd.google-apps.spreadsheet'