יצירת קיצור דרך לקובץ ב-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'