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

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

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

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

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

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

• يمثّل الحقلان targetId وtargetMimeType جزءًا من الحقل shortcutDetails ضمن مورد file.

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

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

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

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

• في قسم تصدير بيانات حساب 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 هي عبارة طلب البحث أو الحقل المطلوب البحث عنه. للاطّلاع على عبارات طلب البحث التي يمكن استخدامها لفلترة مساحات التخزين السحابي المشتركة، يُرجى الرجوع إلى عبارات طلبات البحث.
• يحدد عامل التشغيل شرط عبارة طلب البحث. للاطّلاع على عوامل التشغيل التي يمكنك استخدامها مع كل عبارة طلب بحث، راجِع عوامل تشغيل طلب البحث.
• القيم هي القيم المحددة التي تريد استخدامها لتصفية نتائج البحث.

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

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