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 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ỉ 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 xem tệp trước đó phải cung cấp khoá tài nguyên để có quyền truy cập. Những người gần đây đã xem tệp hoặc có quyền truy cập trực tiếp, 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 được chia sẻ bằng đường liên kết. Yêu cầu của những người dùng chỉ có quyền truy cập vào các tệp được chia sẻ liên kết này bằng quyền type=domain hoặc type=anyone có thể cần có 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. Để biết danh sách đầy đủ các vai trò và những thao tác được phép của từng vai trò, hãy xem phần 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 một 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 Drive, thì khoá tài nguyên cho đích đến của lối tắt sẽ được trả về trong 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ể sử 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

Cặp khoá tài nguyên và mã tệp được đặt trên tiêu đề bằng dấu phân cách 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 thông qua các dòng phân cách bằng dấu phẩy (,).

Ví dụ: hãy xem xét yêu cầu di chuyển tệp fileId1 từ thư mục fileId2 sang thư mục fileId3. Giả sử các 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 lên và dấu phân tách là:

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