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

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

• نوع MIME application/vnd.google-apps.shortcut لمزيد من المعلومات راجع Google Workspace بروتوكول MIME المتوافق مع 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 لإنشاء اختصار.

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

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

بشكل افتراضي، يتم إنشاء الاختصار في مجلد يتم إنشاء Drive والاختصارات فقط للملفات أو المجلدات الخاصة بـ التي يمكن للمستخدم الحالي الوصول إليها

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

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

mimeType operator values

المكان:

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

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

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