יצירת קיצור דרך לקובץ ב-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: השם של קיצור הדרך הזה.

כברירת מחדל, קיצור הדרך נוצר ב'הדף שלי' של המשתמש הנוכחי, וניתן ליצור קיצורי דרך רק לקבצים או לתיקיות שיש למשתמש הנוכחי גישה אליהם.

חיפוש קיצור דרך

כדי לחפש קיצור דרך, משתמשים במחרוזת השאילתה 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'