Quản lý các đề xuất cấp quyền truy cập đang chờ xử lý

Đề xuất 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 vào một mục trên Google Drive cho người nhận.

Người phê duyệt có thể xem xét và xử lý tất cả các đề xuất quyền truy cập chưa được giải quyết trên các tệp 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 lập trình để tìm đề xuất quyền truy cập, sau đó giải quyết các đề xuất đó. Người phê duyệt cũng có thể xem các đề xuất ở dạng tổng hợp.

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 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 một 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 quyền truy cập:

  • Người yêu cầu: Người dùng bắt đầu đề xuất 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 trên một tệp nếu đề xuất quyền truy cập được cấp. 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 quyền truy cập. Thông thường, người phê duyệt là chủ sở hữu tài liệu hoặc 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 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 trường mặc định dành riêng cho phương thức đó. Để trả về các trường khác, hãy xem bài viết Trả về các trường cụ thể trường.

Nhận đề xuất quyền truy cập đang chờ xử lý

Để nhận đề xuất 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ã đề xuất, bạn có thể liệt kê các đề xuất quyền truy cập đang chờ xử lý bằng phương thức list.

Liệt kê các đề xuất quyền truy cập đang chờ xử lý

Để liệt kê tất cả các đề xuất 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à đưa tham số đường dẫn fileId vào.

Chỉ những người phê duyệt trên một tệp mới có thể liệt kê các đề xuất đang chờ xử lý trên một tệp. Người phê duyệt là người dùng có khả năng can_approve_access_proposals trên tệp. Nếu người yêu cầu không phải là người phê duyệt, thì một danh sách trống sẽ được trả về. Để biết thêm thông tin về capabilities, hãy xem Tìm hiểu về các khả 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 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 trường cho mỗi đề xuất. Ví dụ: một đề xuất có thể có đối tượng RoleAndView của role=reader và view=published, cộng với một đối tượng RoleAndView bổ sung chỉ có giá trị role=writer. Để biết thêm thông tin, hãy xem bài viết Chế độ xem.

Chuyển các tham số truy vấn sau đây để tuỳ chỉnh phân trang hoặc lọc các đề xuất quyền truy cập:

  • pageToken: Mã thông báo trang, nhận được 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 quyền truy cập tối đa cần trả về trên mỗi trang.

Giải quyết các đề xuất quyền truy cập đang chờ xử lý

Để giải quyết tất cả các đề xuất 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 resolve trên tài nguyên accessproposals và đưa tham số đường dẫn fileId và proposalId vào.

Phương thức resolve bao gồm tham số truy vấn action biểu thị hành động cần thực hiện trên đề 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 liệu đề xuất đó đang được chấp nhận hay bị từ chối.

Phương thức resolve cũng bao gồm các tham số truy vấn không bắt buộc của role và view. Các vai trò duy nhất được hỗ trợ là writer, commenter và reader. Nếu không chỉ định vai trò, thì vai trò mặc định là reader. Để biết thêm thông tin, hãy xem bài viết Vai trò và quyền. Tham số truy vấn không bắt buộc bổ sung của 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.

Giố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 Tìm hiểu về các khả năng của tệp.

Các đề xuất được giải quyết bằng cách sử dụng cùng một mẫu được liệt kê trong phần Các tình huống 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 có các vai trò khác nhau, thì đ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 một lúc, thì đề xuất có quyền cao hơn (ví dụ: role=writer so với role=reader) sẽ được áp dụng. Đề xuất 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, hành động chia sẻ sẽ hoàn tất. Đề xuất quyền truy cập đã giải quyết không còn được trả về thông qua phương thức list. 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 trên 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.