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 bạn 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 không 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 thông 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 một liên kết. Người dùng chưa từng xem tệp này phải cung cấp khoá tài nguyên để có quyền truy cập. Những người gần đây đã xem hoặc có quyền truy cập trực tiếp, mà không cần có khoá tài nguyên để truy cập vào tệp.

Chỉ có thể tìm thấy tệp trên Drive được chia sẻ bằng một đường liên kết bằng người dùng có thể truy cập vào tệp nhờ type=user hoặc type=group Tài nguyên permissions. Yêu cầu của người dùng chỉ có quyền truy cập vào những tệp được chia sẻ liên kết này bằng type=domain hoặc Quyền 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à hoạt động mà mỗi quyền sẽ được phép, hãy xem Vai trò & quyền truy cập.

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

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

Nếu tệp là lối tắt Drive, khoá tài nguyên cho đích đến của lối tắt được trả về ở chế độ chỉ đọc Trường shortcutDetails.targetResourceKey.

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 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 yêu cầu đến API Drive đượ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 gạch chéo lên (/). Tiêu đề này được tạo bằng cách kết hợp tất cả mã tệp và tài nguyên cặp khoá bằng dấu phẩy (,) được phân tách.

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à resourceKey1, resourceKey2 và resourceKey3 tương ứng. 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 dấu phẩy là:

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