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

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

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

  • 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 حاوی پیوندهایی به هدف نشان داده می‌شوند.

برای اطلاعات بیشتر، به یافتن فایل‌ها و پوشه‌ها با میانبرهای 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')))

Node.js 

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 کاربر فعلی ایجاد می‌شود و میانبرها فقط برای فایل‌ها یا پوشه‌هایی ایجاد می‌شوند که کاربر فعلی به آنها دسترسی دارد.

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

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

mimeType operator values

کجا:

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

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

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

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

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

  • 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 حاوی پیوندهایی به هدف نشان داده می‌شوند.

برای اطلاعات بیشتر، به یافتن فایل‌ها و پوشه‌ها با میانبرهای 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')))

Node.js 

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 کاربر فعلی ایجاد می‌شود و میانبرها فقط برای فایل‌ها یا پوشه‌هایی ایجاد می‌شوند که کاربر فعلی به آنها دسترسی دارد.

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

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

mimeType operator values

کجا:

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

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

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