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