יצירת קיצור דרך לקובץ ב-Drive

קיצורי דרך הם קבצים שמקשרים לקבצים או לתיקיות אחרים ב-Google Drive. מאפיינים של קיצורי דרך:

• סוג MIME‏ application/vnd.google-apps.shortcut. מידע נוסף זמין במאמר סוגי MIME שנתמכים ב-Google Workspace וב-Google Drive.

• רשימת ה-ACL של קיצור הדרך יורשת את רשימת ה-ACL של ההורה. אי אפשר לשנות ישירות את רשימת בקרת הגישה (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 כדי ליצור קיצור דרך.

בדוגמאות הבאות מוסבר איך ליצור קיצור דרך באמצעות ספריית לקוח:

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 הוא מונח השאילתה או השדה שרוצים לחפש. כדי לראות את מונחי השאילתות שאפשר להשתמש בהם לסינון תיקיות באחסון השיתופי, אפשר לעיין במונחי שאילתות לחיפוש.
• ‫operator מציין את התנאי למונח השאילתה. כדי לראות באילו אופרטורים אפשר להשתמש עם כל מונח שאילתה, אפשר לעיין במאמר בנושא אופרטורים של שאילתות.
• ערכים הם הערכים הספציפיים שרוצים להשתמש בהם כדי לסנן את תוצאות החיפוש.

לדוגמה, מחרוזת השאילתה הבאה מסננת את החיפוש כדי להחזיר את כל קיצורי הדרך לקבצים של גיליונות אלקטרוניים:

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