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

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

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

  • Danh sách kiểm soát quyền truy cập (ACL) cho một lối tắt sẽ kế thừa ACL của đơn vị tổ chức mẹ. Bạn không thể thay đổi trực tiếp Danh sách kiểm soát quyền truy cập (ACL) của lối tắt.

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

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

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

  • Một lối tắt chỉ có thể có một cha mẹ. Nếu cần phải có tệp lối tắt ở các vị trí khác trong Drive, thì tệp lối tắt đó có thể được sao chép vào các vị trí bổ sung.

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

  • Tiêu đề của lối tắt có thể khác với đích đến. 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, tiêu đề và tiêu đề của mục tiêu của lối tắt có thể được thay đổi một cách độc lập. Nếu tên của mục tiêu thay đổi, thì các lối tắt được 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, loại MIME của tệp blob sẽ thay đổi khi bản sửa đổi của một 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 gốc. 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, thì Drive sẽ xác định thay đổi đó và cập nhật hình thu nhỏ cho tệp thực tế. Tuy nhiên, lối tắt này vẫn tiếp tục có hình thu nhỏ JPG.

  • Trong mục Xuất dữ liệu của Tài khoản Google (còn gọi là Google Takeout), các lối tắt được biểu thị dưới dạng tệp dấu trang của 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 phần Tìm tệp và thư mục bằng lối tắt dành cho 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 cần liên kết đến và gọi files.create để tạo lối tắt.

Các ví dụ sau đây minh hoạ 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ế đoạn mã 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 được tạo trên Drive của tôi của người dùng hiện tại và lối tắt chỉ được tạo cho các 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 kiế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 để 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 phần Cụm từ tìm kiếm của cụm từ tìm kiếm.
  • toán tử chỉ định điều kiện cho cụm từ truy vấn. Để xem bạn có thể sử dụng những toán tử nào với mỗi cụm từ truy vấn, hãy tham khảo phần Toán tử truy vấn.
  • giá trị là các giá trị cụ thể mà bạn muốn sử dụng để lọc kết quả tìm kiếm.

Ví dụ: chuỗi truy vấn sau đây lọc lệnh tìm kiếm để trả về tất 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'