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ẻ trên Drive, bạn có thể kiểm soát việc liệu 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. 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 vào tệp đó sẽ không cần khoá tài nguyên để truy cập vào tệp.

Người dùng chỉ có thể tìm thấy tệp trên Drive được chia sẻ bằng đường liên kết nếu họ có thể truy cập vào tệp đó thông qua tài nguyên type=user hoặc type=group permissions. 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ẻ qua đường liên kết này bằng quyền type=domain hoặc type=anyone có thể cần đến khoá tài nguyên.

Để biết thêm thông tin về các quyền, hãy xem bài viết Chia sẻ tệp, thư mục và ổ đĩa. Để xem danh sách đầy đủ các vai trò và 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 từ tệp

Drive API trả về khoá tài nguyên của một tệp trên trường resourceKey chỉ đọ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 đích của lối tắt sẽ được trả về trên trường shortcutDetails.targetResourceKey chỉ đọ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. Những ứ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 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 mà các yêu cầu đến Drive API tham chiếu đều được đặt trên tiêu đề HTTP X-Goog-Drive-Resource-Keys.

Các yêu cầu đối với Drive API 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 cặp mã nhận dạng tệp và khoá tài nguyên được đặt trên tiêu đề bằng dấu gạch chéo (/) làm dấu phân cách. 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 dấu phân cách là 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ử 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