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

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

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

• ترث قائمة التحكّم بالوصول الخاصة بالاختصار قائمة التحكّم بالوصول الخاصة بالعنصر الرئيسي. لا يمكن تغيير قائمة التحكّم في الوصول (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 لإنشاء اختصار.

ملاحظة: إذا كنت تستخدم الإصدار 2 من واجهة برمجة التطبيقات، استخدِم files.insert.

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

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

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

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