Quản lý yêu cầu phê duyệt

Tài liệu này giải thích cách quản lý các yêu cầu phê duyệt trong Google Drive API.

Bạn có thể tìm thấy các yêu cầu phê duyệt nội dung trong Google Drive. API Google Drive cung cấp tài nguyên approvals để bạn có thể nhận và liệt kê trạng thái phê duyệt của mình. Các phương thức của tài nguyên approvals hoạt động trên các mục trong Drive, Google Tài liệu và các trình chỉnh sửa khác của Google Workspace.

Bạn có thể sử dụng quy trình này để tìm các yêu cầu phê duyệt trong những trường hợp cần có quy trình xem xét chính thức, chẳng hạn như xem xét hợp đồng hoặc tài liệu chính thức trước khi xuất bản. Yêu cầu phê duyệt theo dõi trạng thái của cả quy trình xem xét (chẳng hạn như Đang tiến hành, Đã phê duyệt hoặc Từ chối) và những người đánh giá có liên quan. Phê duyệt là một cách hiệu quả để xác thực nội dung và lưu giữ hồ sơ của người đánh giá.

Để xem thông tin phê duyệt trên một tệp, bạn phải có quyền đọc siêu dữ liệu của tệp đó. Để biết thêm thông tin, hãy xem phần Vai trò và quyền.

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 tham số hệ thống fields bằng bất kỳ phương thức nào của tài nguyên approvals. 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. Để trả về các trường khác, hãy xem phần Trả về các trường cụ thể.

Nhận được sự phê duyệt

Để nhận được sự phê duyệt đối với một tệp, hãy sử dụng phương thức get trên tài nguyên approvals với các tham số đường dẫn fileId và approvalId. Nếu không biết mã phê duyệt, bạn có thể liệt kê các phê duyệt bằng phương thức list.

Nội dung phản hồi chứa một phiên bản của tài nguyên approvals.

Liệt kê các lượt phê duyệt

Để liệt kê các lượt phê duyệt trên một tệp, hãy gọi phương thức list trên tài nguyên approvals và thêm tham số đường dẫn fileId.

Nội dung phản hồi bao gồm danh sách các lượt phê duyệt trên tệp. Trường items chứa thông tin về từng lượt phê duyệt dưới dạng tài nguyên approvals.

Tài nguyên approvals cũng bao gồm một đối tượng Status trình bày chi tiết trạng thái phê duyệt, cũng như đối tượng ReviewerResponse trình bày chi tiết phản hồi đối với một yêu cầu phê duyệt do một người đánh giá cụ thể đưa ra. Phản hồi của người đánh giá này được biểu thị bằng đối tượng Response.

Bạn cũng có thể truyền các tham số truy vấn sau đây để tuỳ chỉnh việc phân trang hoặc lọc các yêu cầu phê duyệt:

  • pageSize: Số lượng phê duyệt tối đa cần trả về trên mỗi trang. Nếu bạn không đặt pageSize, máy chủ sẽ trả về tối đa 100 lượt phê duyệt.

  • pageToken: Mã thông báo trang, nhận được từ một lệnh gọi danh sách trước đó. Mã thông báo này được dùng để truy xuất trang tiếp theo. Bạn nên đặt giá trị này thành giá trị của nextPageToken trong một phản hồi trước đó.