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

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

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

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

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

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

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

• لا يمكن أن يتضمن الاختصار أكثر من عنصر رئيسي واحد. إذا كان ملف الاختصار مطلوبًا في مواقع 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'