All requests to the Deep Review API must be authenticated and authorized. This page describes the supported OAuth 2.0 scopes, credentials, and Bring-Your-Own-Key (BYOK) Gemini API key options.
OAuth 2.0 Scopes
The Deep Review API is a public Google API and supports the following OAuth 2.0 scopes across all endpoints:
| Scope | Description |
|---|---|
https://www.googleapis.com/auth/drive.file |
Authorizes managing manuscripts and reviews in the Deep Review API, as well as importing user-selected files from Google Drive. |
https://www.googleapis.com/auth/cloud-platform |
Authorizes managing manuscripts and reviews in the Deep Review API using Google Cloud credentials. |
Application Default Credentials (ADC)
For local development or testing scripts, set your active Google Cloud project,
enable the Deep Review API, and configure Application Default Credentials with
both the cloud-platform and drive.file scopes:
gcloud config set project YOUR_PROJECT_ID
gcloud services enable deepreview.googleapis.com
gcloud auth application-default login --scopes=https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/drive.file
When invoking REST endpoints directly, include your access token and billable project in request headers:
curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "x-goog-user-project: $(gcloud config get-value project)" \
https://deepreview.googleapis.com/v1/documents
Bring Your Own Key (BYOK) Gemini API Key
If you prefer to bill LLM inference calls directly to your own Google AI Studio
account, you can provide an optional geminiApiKey in the runConfig
payload when calling CreateReview:
{
"runConfig": {
"topology": "MID",
"geminiApiKey": "AIzaSy..."
}
}