Đề xuất cấp quyền truy cập là đề xuất của người yêu cầu gửi đến người phê duyệt để cấp quyền truy cập cho người nhận vào một mục trong Google Drive.
Người phê duyệt có thể xem xét và xử lý tất cả các đề xuất cấp quyền truy cập chưa được giải quyết trên các tệp trong Drive. Điều này có nghĩa là bạn có thể đẩy nhanh quy trình phê duyệt bằng cách truy vấn theo chương trình các đề xuất cấp quyền truy cập rồi giải quyết các đề xuất đó. Người phê duyệt cũng có thể xem các đề xuất theo nhóm.
API Google Drive cung cấp tài nguyên accessproposals để bạn có thể xem và giải quyết các đề xuất cấp quyền truy cập đang chờ xử lý. Các phương thức của tài nguyên accessproposals hoạt động trên các tệp, thư mục, các tệp trong bộ nhớ dùng chung nhưng không hoạt động trên bộ nhớ dùng chung.
Sau đây là các điều khoản dành riêng cho đề xuất cấp quyền truy cập:
- Người yêu cầu: Người dùng bắt đầu đề xuất cấp quyền truy cập vào một mục trên Drive.
- Người nhận: Người dùng nhận được các quyền bổ sung đối với một tệp nếu đề xuất cấp quyền truy cập được chấp nhận. Nhiều khi người nhận cũng là người yêu cầu nhưng không phải lúc nào cũng vậy.
- Người phê duyệt: Người dùng chịu trách nhiệm phê duyệt (hoặc từ chối) đề xuất cấp quyền truy cập. Điều này thường là do họ là chủ sở hữu của tài liệu hoặc họ có quyền chia sẻ tài liệu.
Sử dụng tham số fields
Nếu muốn chỉ định các trường cần trả về trong phản hồi, bạn có thể đặt fields tham số hệ thống fields bằng bất kỳ phương thức nào của tài nguyên accessproposals. Nếu bạn bỏ qua tham số fields, máy chủ sẽ trả về một tập hợp các trường mặc định dành riêng cho phương thức này. Để trả về các trường khác nhau, hãy xem phần Trả về các trường cụ thể.
Nhận đề xuất cấp quyền truy cập đang chờ xử lý
Để nhận được đề xuất cấp quyền truy cập, hãy sử dụng phương thức get trên tài nguyên accessproposals với các tham số đường dẫn fileId và proposalId. Nếu không biết mã nhận dạng đề xuất, bạn có thể liệt kê các đề xuất cấp quyền truy cập đang chờ xử lý bằng phương thức list.
Liệt kê các đề xuất cấp quyền truy cập đang chờ xử lý
Để liệt kê tất cả các đề xuất cấp quyền truy cập đang chờ xử lý trên một mục trên Drive, hãy gọi phương thức list trên tài nguyên accessproposals và thêm tham số đường dẫn fileId.
Chỉ người phê duyệt trên tệp mới có thể liệt kê các đề xuất đang chờ xử lý trên tệp. Người phê duyệt là người dùng có quyền can_approve_access_proposals đối với tệp. Nếu người yêu cầu không phải là người phê duyệt, thì hệ thống sẽ trả về một danh sách trống. Để biết thêm thông tin về capabilities, hãy xem bài viết Tìm hiểu các chức năng của tệp.
Nội dung phản hồi bao gồm một đối tượng accessproposals đại diện cho danh sách các đề xuất cấp quyền truy cập chưa được giải quyết trên tệp.
Đối tượng accessproposals bao gồm thông tin về từng đề xuất, chẳng hạn như người yêu cầu, người nhận và thông báo mà người yêu cầu đã thêm. Đối tượng này cũng bao gồm một đối tượng RoleAndView nhóm role được đề xuất của người yêu cầu với một view. Vì role là một trường lặp lại, nên có thể có nhiều giá trị cho mỗi đề xuất. Ví dụ: một đề xuất có thể có đối tượng RoleAndView là role=reader và view=published, cộng với một đối tượng RoleAndView khác chỉ có giá trị role=writer. Để biết thêm thông tin, hãy xem phần Lượt xem.
Truyền các tham số truy vấn sau để tuỳ chỉnh việc phân trang hoặc lọc các đề xuất truy cập:
pageToken: Mã thông báo trang, nhận được từ một lệnh gọi danh sách trước đó. Cung cấp mã thông báo này để truy xuất trang tiếp theo.pageSize: Số lượng đề xuất cấp quyền truy cập tối đa cần trả về cho mỗi trang.
Giải quyết các đề xuất cấp quyền truy cập đang chờ xử lý
Để giải quyết tất cả các đề xuất cấp quyền truy cập đang chờ xử lý trên một mục trong Drive, hãy gọi phương thức resolve trên tài nguyên accessproposals và thêm các tham số đường dẫn fileId và proposalId.
Phương thức resolve bao gồm một tham số truy vấn action biểu thị hành động cần thực hiện đối với đề xuất. Đối tượng Action theo dõi sự thay đổi trạng thái của đề xuất để chúng ta biết đề xuất đó có được chấp nhận hay không.
Phương thức resolve cũng bao gồm các tham số truy vấn không bắt buộc là role và view. Các vai trò duy nhất được hỗ trợ là writer, commenter và reader. Nếu bạn không chỉ định vai trò, thì vai trò mặc định sẽ là reader. Để biết thêm thông tin, hãy xem phần Vai trò và quyền. Một tham số truy vấn không bắt buộc khác là sendNotification cho phép bạn gửi thông báo qua email cho người yêu cầu khi đề xuất được chấp nhận hoặc bị từ chối.
Cũng như phương thức list, người dùng giải quyết đề xuất phải có khả năng can_approve_access_proposals trên tệp. Để biết thêm thông tin về capabilities, hãy xem bài viết Tìm hiểu các chức năng của tệp.
Các đề xuất được giải quyết bằng cách sử dụng các mẫu tương tự như được liệt kê trong phần Các trường hợp chia sẻ tài nguyên trên Drive. Nếu có nhiều đề xuất cho cùng một người dùng nhưng với các vai trò khác nhau, thì những điều sau đây sẽ áp dụng:
- Nếu một đề xuất được chấp nhận và một đề xuất bị từ chối, thì vai trò được chấp nhận sẽ áp dụng cho mục trên Drive.
- Nếu cả hai đề xuất đều được chấp nhận cùng lúc, thì đề xuất có quyền cao hơn (ví dụ:
role=writerso vớirole=reader) sẽ được áp dụng. Đề xuất cấp quyền truy cập khác sẽ bị xoá khỏi mục.
Sau khi gửi đề xuất đến phương thức resolve, thao tác chia sẻ sẽ hoàn tất. Đề xuất truy cập đã được giải quyết sẽ không còn được trả về thông qua phương thức list nữa. Sau khi đề xuất được chấp nhận, người dùng phải sử dụng tài nguyên permissions để cập nhật quyền đối với một tệp hoặc thư mục. Để biết thêm thông tin, hãy xem bài viết Cập nhật quyền.