إنشاء اختصار إلى ملف Drive

الاختصارات هي ملفات تؤدي إلى ملفّات أو مجلّدات أخرى على Google Drive. تتسم الاختصارات بالخصائص التالية:

• نوع MIME application/vnd.google-apps.shortcut لمزيد من المعلومات، راجِع أنواع MIME المتوافقة في Google Workspace وGoogle Drive.

• تتضمن قائمة التحكم بالوصول (ACL) للاختصار قائمة التحكم بالوصول الخاصة بالمؤسسة الرئيسية. لا يمكن تغيير قائمة التحكّم في الوصول (ACL) للاختصار مباشرةً.

• targetId يشير إلى الملف أو المجلد المستهدف، ويُشار إليه أيضًا باسم "الهدف".

• targetMimeType يشير إلى نوع MIME للهدف. يُستخدَم الرمز targetMimeType لتحديد رمز النوع الذي سيتم عرضه. يتم نسخ نوع MIME للهدف إلى الحقل "targetMimeType" عند إنشاء الاختصار.

• حقلَا targetId وtargetMimeType هما جزء من حقل shortcutDetails ضمن مورد الملف.

• لا يمكن أن يتضمّن الاختصار سوى عنصر رئيسي واحد. إذا كان ملف الاختصار مطلوبًا في مواقع أخرى في Drive، يمكن نسخ ملف الاختصار إلى المواقع الإضافية.

• عند حذف الهدف أو عندما يفقد المستخدم الحالي إمكانية الوصول إلى الهدف، يتعطّل اختصار المستخدم الذي يشير إلى الهدف.

• يمكن أن يختلف عنوان الاختصار عن الوجهة. عند إنشاء اختصار، يتم استخدام عنوان الهدف كعنوان الاختصار. بعد الإنشاء، يمكن تغيير عنوان الاختصار وعنوان الهدف بشكل مستقل. إذا تم تغيير اسم الهدف، تحتفظ الاختصارات التي تم إنشاؤها سابقًا بالعنوان القديم.

• يمكن أن يصبح نوع MIME للاختصار قديمًا. على الرغم من أنّه من النادر أن يتغيّر نوع MIME لملف ملفّ أرشيف ثنائي، إلا أنّ أي اختصارات تشير إلى الملف المعدَّل تحتفظ بنوع MIME الأصلي. على سبيل المثال، إذا حمّلت ملف JPG إلى Drive، ثم حمّلت ملف AVI، يرصد Drive التغيير ويُعدِّل الصورة المصغّرة للملف الفعلي. ومع ذلك، سيظل الاختصار يتضمّن ملفًا شخصيًا مصغرًا بتنسيق JPG.

• في تصدير data بيانات حساب Google المعروفة أيضًا باسم 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')))

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: اسم هذا الاختصار

يتم تلقائيًا إنشاء الاختصار في "ملفاتي" لدى المستخدم الحالي ولا يتم إنشاء الاختصارات إلا للملفات أو المجلدات التي يمكن للمستخدم الحالي الوصول إليها.

البحث عن اختصار

للبحث عن اختصار، استخدِم سلسلة الطلب q مع files.list لفلترة الاختصارات التي تريد عرضها.

mimeType operator values

المكان:

• query_term هي عبارة طلب البحث أو الحقل الذي يتم البحث فيه. للاطّلاع على عبارات طلب البحث التي يمكن استخدامها لفلترة مساحات التخزين السحابي المشتركة، يُرجى الرجوع إلى عبارات طلبات البحث.
• يحدّد operator شرط عبارة الاستعلام. للاطّلاع على عوامل التشغيل التي يمكنك استخدامها مع كل عبارة طلب بحث، يُرجى الرجوع إلى عوامل تشغيل طلبات البحث.
• القيم هي القيم المحدّدة التي تريد استخدامها لفلترة نتائج البحث.

على سبيل المثال، تعمل سلسلة طلب البحث التالية على تصفية البحث لعرض جميع الاختصارات إلى ملفات جداول البيانات:

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