קיצורי דרך הם קבצים שמקשרים לתיקיות או לקבצים אחרים ב-Google Drive. לקיצורי דרך יש את המאפיינים הבאים:
סוג MIME של
application/vnd.google-apps.shortcut
. למידע נוסף, ראו סוגי MIME נתמכים ב-Google Workspace וב-Google Drive.רשימת ה-ACL של קיצור הדרך יורשת את רשימת ה-ACL של ההורה. אי אפשר לשנות ישירות את ה-ACL של קיצור הדרך.
targetId
שמצביע לקובץ היעד או לתיקייה, שמכונה גם target (יעד).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: השם של קיצור הדרך הזה.
כברירת מחדל, קיצור הדרך נוצר ב'אחסון שלי' של המשתמש הנוכחי, וקיצורי הדרך נוצרים רק לקבצים או לתיקיות שלמשתמש הנוכחי יש גישה אליהם.
חיפוש קיצור דרך
כדי לחפש קיצור דרך, משתמשים במחרוזת השאילתה q
עם files.list
כדי לסנן את קיצורי הדרך לחזרה.
mimeType operator values
כאשר:
- query_term את המונח או השדה של השאילתה שיש לחפש. במונחים של שאילתות חיפוש תוכלו לראות את מונחי השאילתות שאפשר להשתמש בהן לסינון תיקיות אחסון שיתופי.
- אופרטור מציין את התנאי עבור מונח השאילתה. כדי לראות באילו אופרטורים אפשר להשתמש עם כל מונח שאילתה, קראו את המאמר אופרטורים של שאילתות.
- values הם הערכים הספציפיים שאתם רוצים להשתמש בהם כדי לסנן את תוצאות החיפוש.
לדוגמה, מחרוזת השאילתה הבאה מסננת את החיפוש כדי להחזיר את כל קיצורי הדרך לקבצים של גיליונות אלקטרוניים:
q: mimeType='application/vnd.google-apps.shortcut' AND shortcutDetails.targetMimeType='application/vnd.google-apps.spreadsheet'