الاختصارات هي ملفات ترتبط بملفات أو مجلدات أخرى على 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
لإنشاء اختصار.
توضِّح الأمثلة التالية كيفية إنشاء اختصار باستخدام مكتبة برامج:
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: اسم هذا الاختصار
بشكل افتراضي، يتم إنشاء الاختصار في مجلد يتم إنشاء Drive والاختصارات فقط للملفات أو المجلدات الخاصة بـ التي يمكن للمستخدم الحالي الوصول إليها
البحث عن اختصار
للبحث عن اختصار، استخدِم سلسلة طلب البحث q
مع
files.list
لفلترة الاختصارات حسب
إرجاع.
mimeType operator values
المكان:
- query_term هي عبارة طلب البحث أو الحقل المطلوب البحث عنه. لعرض طلب البحث العبارات التي يمكن استخدامها لفلترة مساحات التخزين السحابي المشتركة، راجِع القسم طلب البحث. البنود.
- يحدد عامل التشغيل شرط عبارة طلب البحث. لعرض التي يمكنك استخدامها مع كل عبارة طلب بحث، راجِع عوامل تشغيل طلب البحث.
- القيم هي القيم المحددة التي تريد استخدامها لفلترة بحثك. نتائجك.
على سبيل المثال، تعمل سلسلة طلب البحث التالية على تصفية البحث لإرجاع جميع اختصارات لملفات جداول البيانات:
q: mimeType='application/vnd.google-apps.shortcut' AND shortcutDetails.targetMimeType='application/vnd.google-apps.spreadsheet'