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

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

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

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