建立雲端硬碟檔案的捷徑

捷徑是連結至 Google 雲端硬碟中其他檔案或資料夾的檔案。 快速鍵具有下列特徵：

  • application/vnd.google-apps.shortcut MIME 類型。詳情請參閱「Google Workspace 和 Google 雲端硬碟支援的 MIME 類型」。

  • 捷徑的 ACL 會沿用父項的 ACL。捷徑的 ACL 無法直接變更。

  • 指向目標檔案或資料夾的 targetId，也稱為「目標」。

  • targetMimeType：指出目標的 MIME 類型。targetMimeType 用於判斷要顯示的類型圖示。建立捷徑時，目標的 MIME 類型會複製到 targetMimeType 欄位。

  • targetId 和 targetMimeType 欄位是 檔案資源中 shortcutDetails 欄位的一部分。

  • 捷徑只能有一個上層項目。如果其他雲端硬碟位置需要捷徑檔案，可以將捷徑檔案複製到其他位置。

  • 如果目標遭到刪除，或目前使用者失去目標的存取權，指向目標的使用者捷徑就會失效。

  • 捷徑的標題可以與目標不同。建立捷徑時，系統會使用目標的標題做為捷徑標題。建立捷徑後，你可以分別變更捷徑和目標的標題。如果目標名稱變更，先前建立的捷徑會保留舊名稱。

  • 捷徑的 MIME 類型可能會過時。雖然很少發生，但如果上傳不同類型的修訂版本，Blob 檔案的 MIME 類型就會變更，不過指向更新後檔案的任何捷徑都會保留原始 MIME 類型。舉例來說，如果將 JPG 檔案上傳至雲端硬碟，然後上傳 AVI 修訂版本，雲端硬碟會識別這項變更，並更新實際檔案的縮圖。不過，捷徑仍會顯示 JPG 縮圖。

  • 在 Google 帳戶資料匯出 (又稱 Google 匯出) 中，捷徑會以 Netscape 書籤檔案表示，內含目標的連結。

詳情請參閱「使用 Google 雲端硬碟捷徑尋找檔案和資料夾」。

建立捷徑

如要建立捷徑，請將 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 是要搜尋的查詢字詞或欄位。如要查看可用於篩選共用雲端硬碟的查詢字詞，請參閱「搜尋查詢字詞」。
  • 運算子會指定查詢字詞的條件。如要查看每個查詢字詞可使用的運算子，請參閱「查詢運算子」。
  • 值：用於篩選搜尋結果的特定值。

舉例來說，下列查詢字串會篩選搜尋結果，只傳回試算表檔案的所有捷徑：

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