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