الاختصارات هي ملفات ترتبط بملفات أو مجلدات أخرى على Google Drive. للاختصارات السمات التالية:
نوع MIME
application/vnd.google-apps.shortcut
لمزيد من المعلومات، يُرجى الاطّلاع على أنواع بروتوكولات MIME المتوافقة مع Google Workspace وGoogle Drive.تتضمن قائمة التحكم بالوصول (ACL) للاختصار قائمة التحكم بالوصول الخاصة بالمؤسسة الرئيسية. لا يمكن تغيير قائمة التحكم بالوصول للاختصار مباشرةً.
تمثّل هذه السمة
targetId
الذي يشير إلى الملف أو المجلد الهدف، ويُشار إليه أيضًا باسم "الهدف".تمثّل هذه السمة
targetMimeType
تشير إلى نوع MIME للهدف. يتم استخدامtargetMimeType
لتحديد رمز النوع الذي سيتم عرضه. يتم نسخ نوع MIME للهدف إلى الحقل "targetMimeType
" عند إنشاء الاختصار.يمثّل الحقلان
targetId
وtargetMimeType
جزءًا من الحقلshortcutDetails
ضمن مورد file.لا يمكن أن يكون للاختصار إلا أحد الوالدين. وإذا كان ملف الاختصار مطلوبًا في مواقع 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 هي عبارة طلب البحث أو الحقل المطلوب البحث عنه. للاطّلاع على عبارات طلب البحث التي يمكن استخدامها لفلترة مساحات التخزين السحابي المشتركة، يُرجى الرجوع إلى عبارات طلبات البحث.
- يحدد عامل التشغيل شرط عبارة طلب البحث. للاطّلاع على عوامل التشغيل التي يمكنك استخدامها مع كل عبارة طلب بحث، راجِع عوامل تشغيل طلب البحث.
- القيم هي القيم المحددة التي تريد استخدامها لتصفية نتائج البحث.
على سبيل المثال، تعمل سلسلة طلب البحث التالية على تصفية البحث لعرض جميع الاختصارات إلى ملفات جداول البيانات:
q: mimeType='application/vnd.google-apps.shortcut' AND shortcutDetails.targetMimeType='application/vnd.google-apps.spreadsheet'