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 từng xem tệp này phải cung cấp khoá tài nguyên để có được quyền truy cập. Những người mới xem tệp hoặc có quyền truy cập trực tiếp sẽ không cần có 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 đó trên Drive mới tìm thấy được tệp được chia sẻ thông qua một đường liên kết 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ẻ đường liên kết này bằng cách sử dụ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à bộ nhớ. Để biết danh sách đầy đủ các vai trò và các thao tác mà từng vai trò được phép, 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ề trên trường shortcutDetails.targetResourceKey chỉ có thể đọc.

Các trường trong tài nguyên files trả về các URL, chẳng hạn như exportLinks, webContentLink và webViewLink, cũng có 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 bài viết Tải xuống và xuất tệp.

Thiết lập khoá tài nguyên trên yêu cầu

Khoá tài nguyên của mọi tệp được tham chiếu đến 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 có 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 phân tách 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ả các cặp khoá tài nguyên và mã tệp, được phân tá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ử khoá tài nguyên của 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 cách sử dụ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