Tạo lối tắt đến tệp trên Drive

Lối tắt là những tệp liên kết đến các tệp hoặc thư mục khác trên Google Drive. Phím tắt có những đặc điểm sau:

  • Loại MIME application/vnd.google-apps.shortcut. Để biết thêm thông tin, hãy xem Các loại MIME được Google Workspace và Google Drive hỗ trợ.

  • ACL của một lối tắt sẽ kế thừa ACL của thư mục mẹ. Bạn không thể thay đổi danh sách kiểm soát truy cập (ACL) của lối tắt một cách trực tiếp.

  • Một targetId trỏ đến tệp hoặc thư mục đích, còn được gọi là "đích".

  • Một targetMimeType cho biết loại MIME của mục tiêu. targetMimeType được dùng để xác định biểu tượng loại cần hiển thị. Loại MIME của đích đến sẽ được sao chép vào trường targetMimeType khi lối tắt được tạo.

  • Các trường targetId và targetMimeType là một phần của trường shortcutDetails trong tài nguyên file.

  • Một lối tắt chỉ có thể có một thư mục mẹ. Nếu cần có tệp lối tắt ở các vị trí khác trên Drive, bạn có thể sao chép tệp lối tắt đó sang các vị trí khác.

  • Khi đích đến bị xoá hoặc khi người dùng hiện tại mất quyền truy cập vào đích đến, lối tắt của người dùng trỏ đến đích đến sẽ bị hỏng.

  • Tiêu đề của một lối tắt có thể khác với mục tiêu. Khi một lối tắt được tạo, tiêu đề của mục tiêu sẽ được dùng làm tiêu đề của lối tắt. Sau khi tạo, bạn có thể thay đổi tiêu đề của lối tắt và tiêu đề của mục tiêu một cách độc lập. Nếu tên của mục tiêu thay đổi, các lối tắt đã tạo trước đó sẽ giữ lại tiêu đề cũ.

  • Loại MIME của một lối tắt có thể trở nên lỗi thời. Mặc dù hiếm gặp, nhưng loại MIME của tệp blob sẽ thay đổi khi một phiên bản sửa đổi thuộc loại khác được tải lên, nhưng mọi lối tắt trỏ đến tệp đã cập nhật đều giữ lại loại MIME ban đầu. Ví dụ: nếu bạn tải một tệp JPG lên Drive, sau đó tải một bản sửa đổi AVI lên, Drive sẽ xác định được thay đổi và cập nhật hình thu nhỏ cho tệp thực tế. Tuy nhiên, lối tắt vẫn có hình thu nhỏ JPG.

  • Trong Google Account Data Export (Xuất dữ liệu trong Tài khoản Google), còn được gọi là Google Takeout, các lối tắt được biểu thị dưới dạng tệp dấu trang Netscape chứa các đường liên kết đến mục tiêu.

Để biết thêm thông tin, hãy xem bài viết Tìm tệp và thư mục bằng lối tắt trên Google Drive.

Tạo lối tắt

Để tạo lối tắt, hãy đặt loại MIME thành application/vnd.google-apps.shortcut, đặt targetId thành tệp hoặc thư mục mà lối tắt sẽ liên kết đến, rồi gọi files.create để tạo lối tắt.

Các ví dụ sau đây cho thấy cách tạo lối tắt bằng thư viện ứng dụng:

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);
      }
    }
  }
});

Thay thế nội dung sau:

  • FILE_NAME: tên tệp cần có lối tắt.
  • SHORTCUT_NAME: tên của lối tắt này.

Theo mặc định, lối tắt sẽ được tạo trên phần My Drive của người dùng hiện tại và lối tắt chỉ được tạo cho những tệp hoặc thư mục mà người dùng hiện tại có quyền truy cập.

Tìm lối tắt

Để tìm một phím tắt, hãy dùng chuỗi truy vấn q với files.list để lọc các phím tắt cần trả về.

mimeType operator values

Trong trường hợp:

  • query_term là cụm từ tìm kiếm hoặc trường cần tìm kiếm. Để xem các cụm từ tìm kiếm có thể dùng để lọc bộ nhớ dùng chung, hãy tham khảo Cụm từ tìm kiếm.
  • toán tử chỉ định điều kiện cho cụm từ tìm kiếm. Để xem những toán tử bạn có thể dùng với từng cụm từ tìm kiếm, hãy tham khảo Toán tử truy vấn.
  • giá trị là những giá trị cụ thể mà bạn muốn dùng để lọc kết quả tìm kiếm.

Ví dụ: chuỗi truy vấn sau sẽ lọc nội dung tìm kiếm để trả về tất cả các lối tắt đến tệp bảng tính:

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