יצירת קיצור דרך לקובץ ב-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 כדי ליצור את קיצור הדרך.

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

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

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

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