Skip to content

Google: Starts an approval on a file For more information, see Manage approvals (https: developers google com workspace drive api guides approvals) — request body — body

Starts an approval on a file. For more information, see [Manage approvals](https://developers.google.com/workspace/drive/api/guides/approvals).: request body, field body. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Starts an approval on a file For more information, see Manage approvals (https: developers google com workspace drive api guides approvals) — request body — body

FieldTypePresenceDescription and constraints
$objectRootAllows creating an approval on a file.
dueTimestringOptionalOptional. The time that the approval is due.
Format: google-datetime
fileContentChangeBehaviorstringOptionalOptional. The behavior of the approval when the file content changes.
One of: FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED, RESET_APPROVAL, NO_APPROVAL_ACTION
lockFilebooleanOptionalOptional. Whether to lock the file when starting the approval.
messagestringOptionalOptional. A message to send to reviewers when notifying them of the approval request.
reviewerEmailsarrayOptionalRequired. The emails of the users who are set to review the approval.
reviewerEmails[]stringEach item

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.