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

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

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

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