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

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

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

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

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

  • 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 لإنشاء اختصار.

توضّح الأمثلة التالية كيفية إنشاء اختصار باستخدام مكتبة برامج:

Python

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

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

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

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

mimeType operator values

المكان:

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

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

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