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

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

• نوع MIME لـ application/vnd.google-apps.shortcut.

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

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

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

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

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

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

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

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