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

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

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

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

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

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

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

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

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