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, xem Google Workspace và MIME được Google Drive hỗ trợ .

  • ACL cho lối tắt kế thừa ACL của tổ chức mẹ. ACL của lối tắt không thể thay đổi trực tiếp.

  • 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 của mục tiêu. Chiến lược phát hành đĩa đơn targetMimeType dùng để xác định biểu tượng loại sẽ hiển thị. Loại MIME đượ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 shortcutDetails trong tài nguyên tệp.

  • Mỗi lối tắt chỉ được có một cha mẹ. Nếu tệp lối tắt được yêu cầu trong Vị trí trong Drive, bạn có thể sao chép tệp lối tắt vào các vị trí khác.

  • 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 target, phím tắt của người dùng trỏ đến điểm ngắt đích.

  • Tiêu đề của lối tắt có thể khác với mục tiêu. Khi một lối tắt do tạo, tiêu đề của mục tiêu sẽ được dùng làm tiêu đề cho lối tắt. Sau tạo, thì bạn có thể thay đổi tiêu đề lối tắt và tiêu đề đích của lối tắt 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 đã tạo trước đó giữ lại tiêu đề cũ.

  • Loại MIME của lối tắt có thể đã lỗi thời. Mặc dù hiếm khi xảy ra nhưng MIME của tệp blob sẽ thay đổi khi bản sửa đổi thuộc một loại khác được tải lên, nhưng bất kỳ các lối tắt trỏ đến tệp đã cập nhật sẽ 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, Drive sẽ xác định sự thay đổi và cập nhật hình thu nhỏ của tệp thực. Tuy nhiên, lối tắt tiếp tục có JPG hình thu nhỏ.

  • Trong mục Dữ liệu Tài khoản Google Xuất còn được gọi là Google Takeout, các lối tắt được biểu thị là Netscape các tệp dấu trang chứa 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 Google Drive lối tắt của Google.

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 lối tắt sẽ 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 yêu cầu 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 trang Drive và lối tắt chỉ được tạo cho 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 lối tắt, hãy sử dụng chuỗi truy vấn q với files.list để lọc lối tắt lợi nhuận.

mimeType operator values

Trong trường hợp:

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

Ví dụ: chuỗi truy vấn sau đây sẽ lọc 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'