이 문서에서는 Google Drive API에서 승인을 관리하는 방법을 설명합니다.
Google Drive에서 콘텐츠 승인을 확인할 수 있습니다. Google Drive API는 승인 상태를 가져오고 나열할 수 있도록 approvals 리소스를 제공합니다. approvals 리소스의 메서드는 Drive, Google Docs, 기타 Google Workspace 편집기의 항목에서 작동합니다.
이 절차를 사용하여 계약 검토 또는 게시 전 공식 문서와 같은 정식 검토 상황에서 승인을 찾을 수 있습니다. 승인은 검토 상태 (예: 진행 중, 승인됨, 거부됨)와 관련 검토자를 모두 추적합니다. 승인은 콘텐츠를 검증하고 검토자 기록을 유지하는 데 유용한 방법입니다.
파일의 승인을 보려면 파일의 메타데이터를 읽을 권한이 있어야 합니다. 자세한 내용은 역할 및 권한을 참고하세요.
fields 매개변수 사용
응답에서 반환할 필드를 지정하려면 approvals 리소스의 메서드를 사용하여 fields 시스템 매개변수를 설정하면 됩니다. fields 매개변수를 생략하면 서버는 메서드에 특정한 기본 필드 집합을 반환합니다. 다른 필드를 반환하려면 특정 필드 반환을 참고하세요.
승인 받기
파일에 대한 승인을 받으려면 fileId 및 approvalId 경로 매개변수와 함께 approvals 리소스에서 get 메서드를 사용합니다. 승인 ID를 모르는 경우 list 메서드를 사용하여 승인을 나열할 수 있습니다.
응답 본문에는 approvals 리소스의 인스턴스가 포함됩니다.
승인 나열
파일의 승인을 나열하려면 approvals 리소스에서 list 메서드를 호출하고 fileId 경로 매개변수를 포함합니다.
응답 본문은 파일에 대한 승인 목록으로 구성됩니다. items 필드에는 approvals 리소스 형식의 각 승인에 관한 정보가 포함됩니다.
approvals 리소스에는 승인 상태를 자세히 설명하는 Status 객체와 특정 검토자가 승인한 내용에 대한 응답을 자세히 설명하는 ReviewerResponse 객체도 포함됩니다. 이 검토자의 응답은 Response 객체로 표현됩니다.
다음 쿼리 매개변수를 전달하여 승인 페이지를 맞춤설정하거나 필터링할 수도 있습니다.
pageSize: 페이지당 반환할 최대 승인 수입니다.pageSize를 설정하지 않으면 서버에서 최대 100개의 승인을 반환합니다.pageToken: 이전 목록 호출에서 수신된 페이지 토큰입니다. 이 토큰은 후속 페이지를 가져오는 데 사용됩니다. 이 값은 이전 응답의nextPageToken값으로 설정해야 합니다.