管理核准

本文說明如何透過 Google Drive API 管理核准。

您可以在 Google 雲端硬碟中查看內容核准狀態。Google Drive API 提供 approvals 資源,方便您取得及列出核准狀態。approvals 資源的方法適用於 Google 雲端硬碟、Google 文件和其他 Google Workspace 編輯器中的項目。

無論是合約審查或正式文件發布前,您都可以透過這項程序在正式審查情境中尋找核准。核准會追蹤審查狀態 (例如「進行中」、「已核准」或「已拒絕」) 和相關審查人員。核准功能非常適合用來驗證內容,並記錄審查者。

如要查看檔案的核准狀態,您必須具備檔案中繼資料的讀取權限。詳情請參閱「角色和權限」。

使用 fields 參數

如要指定要在回應中傳回的欄位,可以使用 approvals 資源的任何方法,設定 fields system 參數。如果省略 fields 參數,伺服器會傳回方法專屬的預設欄位集。如要傳回不同欄位,請參閱「傳回特定欄位」。

取得核准

如要取得檔案的核准,請使用 approvals 資源的 get 方法,並搭配 fileIdapprovalId 路徑參數。如果您不知道核准 ID,可以使用 list 方法列出核准項目

回應主體包含 approvals 資源的例項。

列出核准

如要列出檔案的核准項目,請呼叫 approvals 資源上的 list 方法,並加入 fileId 路徑參數。

回應主體包含檔案的核准清單。items 欄位包含每個核准的相關資訊,以 approvals 資源的形式呈現。

approvals 資源也包含 Status 物件,其中詳述核准狀態,以及 ReviewerResponse 物件,其中詳述特定審查員核准的回應。這項回覆會以 Response 物件表示。

您也可以傳遞下列查詢參數,自訂核准的分頁或篩選條件:

  • pageSize:每頁要傳回的核准數量上限。如果您未設定 pageSize,伺服器最多會傳回 100 個核准項目。

  • pageToken:屬於接收自前一個清單呼叫的網頁權杖。這個權杖用於擷取後續頁面。應設為先前回應中的 nextPageToken 值。