Skip to content

Google: Gets an approval by ID For more information, see Manage approvals (https: developers google com workspace drive api guides approvals) — response body

Gets an approval by ID. For more information, see [Manage approvals](https://developers.google.com/workspace/drive/api/guides/approvals).: response body. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Gets an approval by ID For more information, see Manage approvals (https: developers google com workspace drive api guides approvals) — response body

FieldTypePresenceDescription and constraints
$objectRootMetadata for an approval. An approval is a review or approve process for a Drive item.
approvalIdstringOptionalThe approval ID.
completeTimestringOptionalThe time the approval was completed.
Format: google-datetime
createTimestringOptionalThe time the approval was created.
Format: google-datetime
dueTimestringOptionalThe time that the approval is due.
Format: google-datetime
fileContentChangeBehaviorstringOptionalThe behavior of the approval when the file content changes.
Known values: FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED, RESET_APPROVAL, NO_APPROVAL_ACTION
initiatorModelOptionalExpand Gets information about the user, the user’s Drive, and system capabilities. For more information, see [Return user info](https://developers.google.com/workspace/drive/api/guides/user-info). Required: The `fields` parameter must be set To return the exact fields you need, see Return specific fields (https: developers google com workspace drive api guides fields-parameter) — response body — user
The user that requested the approval.
kindstringOptionalThis is always drive#approval.
modifyTimestringOptionalThe most recent time the approval was modified.
Format: google-datetime
reviewerResponsesarrayOptionalThe responses made on the approval by reviewers.
reviewerResponses[]ModelEach itemExpand Gets an approval by ID For more information, see Manage approvals (https: developers google com workspace drive api guides approvals) — response body — reviewer Responses item
statusstringOptionalThe status of the approval at the time this resource was requested.
Known values: STATUS_UNSPECIFIED, IN_PROGRESS, APPROVED, CANCELLED, DECLINED
targetFileIdstringOptionalTarget file id of the approval.

Referenced models: Gets an approval by ID For more information, see Manage approvals (https: developers google com workspace drive api guides approvals) — response body — reviewer Responses item, Gets information about the user, the user’s Drive, and system capabilities. For more information, see [Return user info](https://developers.google.com/workspace/drive/api/guides/user-info). Required: The `fields` parameter must be set To return the exact fields you need, see Return specific fields (https: developers google com workspace drive api guides fields-parameter) — response body — user

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.