Truy cập các tệp trên Drive được chia sẻ bằng đường liên kết bằng khoá tài nguyên

Bạn có thể chia sẻ tệp và thư mục trên Google Drive với người khác bằng Giao diện người dùng của Drive hoặc thông qua API Google Drive. Khi chia sẻ từ Drive, bạn có thể kiểm soát việc mọi người có thể chỉnh sửa, nhận xét hay chỉ được mở tệp.

Khoá tài nguyên giúp bảo vệ tệp của bạn khỏi bị truy cập ngoài ý muốn. Khoá tài nguyên là một tham số bổ sung được truyền để người dùng có thể truy cập vào một số tệp nhất định đã được chia sẻ bằng đường liên kết. Những người dùng chưa từng xem tệp đó phải cung cấp khoá tài nguyên để có quyền truy cập. Những người đã xem tệp gần đây hoặc có quyền truy cập trực tiếp sẽ không cần khoá tài nguyên để truy cập vào tệp.

Chỉ những người dùng có thể truy cập vào tệp thông qua tài nguyên type=user hoặc type=group permissions mới có thể tìm thấy tệp trên Drive được chia sẻ bằng đường liên kết. Các yêu cầu của người dùng chỉ có quyền truy cập vào các tệp được chia sẻ qua đường liên kết này bằng quyền type=domain hoặc type=anyone có thể yêu cầu khoá tài nguyên.

Để biết thêm thông tin về quyền, hãy xem phần Chia sẻ tệp, thư mục và ổ đĩa. Để xem danh sách đầy đủ các vai trò và thao tác mà mỗi vai trò cho phép, hãy xem bài viết Vai trò và quyền.

Đọc khoá tài nguyên trong tệp

API Drive trả về khoá tài nguyên của tệp trên trường resourceKey chỉ có thể đọc của tài nguyên files.

Nếu tệp là lối tắt trên Drive, thì khoá tài nguyên cho mục tiêu của lối tắt sẽ được trả về trên trường shortcutDetails.targetResourceKey chỉ có thể đọc.

Các trường trong tài nguyên files trả về URL, chẳng hạn như exportLinks, webContentLink và webViewLink, cũng bao gồm resourceKey. Các ứng dụng tích hợp với giao diện người dùng Drive cũng có thể dùng resourceKeys trong tham số state. Để biết thêm thông tin, hãy xem phần Tải xuống và xuất tệp.

Đặt khoá tài nguyên trên yêu cầu

Khoá tài nguyên cho mọi tệp được tham chiếu theo các yêu cầu đến API Drive đều được đặt trên tiêu đề HTTP X-Goog-Drive-Resource-Keys.

Các yêu cầu gửi tới API Drive có thể chỉ định một hoặc nhiều khoá tài nguyên bằng tiêu đề HTTP X-Goog-Drive-Resource-Keys.

Cú pháp

Mã tệp và cặp khoá tài nguyên được đặt trên tiêu đề bằng dấu gạch chéo lên (/). Tiêu đề được tạo bằng cách kết hợp tất cả các cặp khoá tài nguyên và mã nhận dạng tệp bằng các dòng phân cách bằng dấu phẩy (,).

Ví dụ: hãy xem xét một yêu cầu di chuyển tệp fileId1 từ thư mục fileId2 sang thư mục fileId3. Giả sử khoá tài nguyên cho 3 tệp này lần lượt là resourceKey1, resourceKey2 và resourceKey3. Tiêu đề được tạo từ các giá trị này bằng dấu gạch chéo và dấu phẩy phân cách là:

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3