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

קיצורי דרך הם קבצים שמקשרים לתיקיות או לקבצים אחרים ב-Google Drive. לקיצורי דרך יש את המאפיינים הבאים:

  • סוג MIME של application/vnd.google-apps.shortcut. לקבלת מידע נוסף, Google Workspace MIME נתמך על ידי 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: השם של קיצור הדרך הזה.

כברירת מחדל, קיצור הדרך נוצר בכרטיסייה 'שלי' של המשתמש הנוכחי Drive וקיצורי דרך נוצרים רק עבור קבצים או תיקיות עבור שלמשתמש הנוכחי יש גישה אליו.

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

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