blob: be2e64a40f8db831b6f7a611d5a4908ebaa3aab6 [file] [edit]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="deepreview_v1.html">Deep Review API</a> . <a href="deepreview_v1.documents.html">documents</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="deepreview_v1.documents.reviews.html">reviews()</a></code>
</p>
<p class="firstline">Returns the reviews Resource.</p>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#delete">delete(name, allowMissing=None, force=None, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes a document and its stored content. If `force` is set to `true`, any associated reviews are also deleted.</p>
<p class="toc_element">
<code><a href="#estimateReviewCost">estimateReviewCost(document, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Estimates what a review of a document would cost on the caller's Gemini API key. The estimate comes from what past reviews with the same model, depth, and thinking level cost, adjusted to this document's size and repriced at the Gemini API's current list prices. It covers one review attempt that runs to completion, and doesn't include retries after errors.</p>
<p class="toc_element">
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieves document metadata. The returned document includes its `latest_review_summary` when a review exists.</p>
<p class="toc_element">
<code><a href="#list">list(filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists documents for the authenticated caller with cursor pagination. Each returned document includes its `latest_review_summary` when a review exists.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="delete">delete(name, allowMissing=None, force=None, x__xgafv=None)</code>
<pre>Deletes a document and its stored content. If `force` is set to `true`, any associated reviews are also deleted.
Args:
name: string, Required. The resource name of the document to delete. (required)
allowMissing: boolean, Optional. If set to `true`, and the document is not found, the request succeeds.
force: boolean, Optional. If set to `true`, any child resources (e.g. review resources) are also deleted. If `false` and the document has existing reviews, the request fails with `FAILED_PRECONDITION`.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}</pre>
</div>
<div class="method">
<code class="details" id="estimateReviewCost">estimateReviewCost(document, body=None, x__xgafv=None)</code>
<pre>Estimates what a review of a document would cost on the caller&#x27;s Gemini API key. The estimate comes from what past reviews with the same model, depth, and thinking level cost, adjusted to this document&#x27;s size and repriced at the Gemini API&#x27;s current list prices. It covers one review attempt that runs to completion, and doesn&#x27;t include retries after errors.
Args:
document: string, Required. The document to review. (required)
body: object, The request body.
The object takes the form of:
{ # Request message for estimating what a review would cost.
&quot;review&quot;: { # An evaluation run of a document. # Required. The review to estimate, as it would be passed to `CreateReview`. Only its `run_config` is read, and `gemini_api_key` is ignored.
&quot;createTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this review attempt was initiated.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. Timestamp when the review reached a terminal state.
&quot;name&quot;: &quot;A String&quot;, # Identifier. Resource name in format `documents/{document}/reviews/{review}`.
&quot;progressPercent&quot;: 42, # Output only. Estimated completion progress percentage of the review in [0, 100].
&quot;result&quot;: { # Encapsulates the synthesized output or failure details of a single review execution. # Output only. Review output (markdown, errors, and future modalities).
&quot;anchoredComments&quot;: [ # Output only. Structured review comments anchored to specific locations in the document. At most 300 anchored comments are returned per review.
{ # A structured review comment anchored to a specific location in the document.
&quot;bodyMarkdown&quot;: &quot;A String&quot;, # Output only. Detailed markdown explanation of the review comment.
&quot;citationReport&quot;: { # Structured citation verification report for a single bibliography reference. # Output only. Optional structured citation verification report when this comment corresponds to a bibliography reference.
&quot;citationKey&quot;: &quot;A String&quot;, # Output only. Generated BibTeX citation key (e.g., &quot;smith2023deep&quot;).
&quot;entryType&quot;: &quot;A String&quot;, # Output only. BibTeX entry type (e.g., &quot;article&quot;, &quot;inproceedings&quot;, &quot;misc&quot;).
&quot;extractedMetadata&quot;: { # Structured bibliographic metadata for an extracted or retrieved work. # Output only. Metadata parsed from the paper&#x27;s bibliography entry.
&quot;authors&quot;: [ # Output only. Ordered list of authors.
{ # Author name components.
&quot;familyName&quot;: &quot;A String&quot;, # Output only. Author family name / surname (or organization name).
&quot;givenName&quot;: &quot;A String&quot;, # Output only. Author given name / initials.
},
],
&quot;doi&quot;: &quot;A String&quot;, # Output only. Digital Object Identifier (DOI).
&quot;journal&quot;: &quot;A String&quot;, # Output only. Journal, conference, or venue name.
&quot;pages&quot;: &quot;A String&quot;, # Output only. Page range or article number.
&quot;publicationDate&quot;: { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. Publication date (month and day left as 0 if just year).
&quot;day&quot;: 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn&#x27;t significant.
&quot;month&quot;: 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
&quot;year&quot;: 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
&quot;source&quot;: &quot;A String&quot;, # Output only. Source database for retrieved metadata (e.g., &quot;openalex&quot;, &quot;crossref&quot;). Empty on `extracted_metadata`.
&quot;title&quot;: &quot;A String&quot;, # Output only. Work title.
&quot;urls&quot;: [ # Output only. URLs associated with the reference.
&quot;A String&quot;,
],
&quot;volume&quot;: &quot;A String&quot;, # Output only. Volume identifier.
},
&quot;fieldComparisons&quot;: [ # Output only. Per-field comparisons (populated only when `retrieved_metadata` is present).
{ # Per-field comparison result between extracted and retrieved metadata.
&quot;detail&quot;: &quot;A String&quot;, # Output only. Human-readable comparison detail (e.g., &quot;extracted=2023, found=2024 (diff=1)&quot;).
&quot;fieldKey&quot;: &quot;A String&quot;, # Output only. Field key (&quot;title&quot;, &quot;authors&quot;, &quot;year&quot;, &quot;journal&quot;, &quot;volume&quot;, &quot;pages&quot;, &quot;doi&quot;).
&quot;match&quot;: True or False, # Output only. Whether the extracted and retrieved values matched.
},
],
&quot;finalVerdict&quot;: &quot;A String&quot;, # Output only. Final combined verdict after database lookup and search grounding.
&quot;firstAuthorFamilyNameMatch&quot;: True or False, # Output only. Whether the first author&#x27;s family name matched between extracted and retrieved metadata.
&quot;groundingUrls&quot;: [ # Output only. Web sources surfaced during Google Search grounding.
{ # Web source URL surfaced during Google Search grounding verification.
&quot;title&quot;: &quot;A String&quot;, # Output only. Source page title or domain.
&quot;url&quot;: &quot;A String&quot;, # Output only. Source URL.
},
],
&quot;lookupVerdict&quot;: &quot;A String&quot;, # Output only. Verdict from scholarly database lookup (OpenAlex / Crossref) before search grounding.
&quot;rawReference&quot;: &quot;A String&quot;, # Output only. Verbatim reference string extracted from the paper&#x27;s bibliography.
&quot;refNum&quot;: 42, # Output only. 1-indexed bibliography reference number in the paper.
&quot;retrievedBibtex&quot;: &quot;A String&quot;, # Output only. Formatted BibTeX entry for the verified `retrieved_metadata` when present. Empty when `retrieved_metadata` is absent.
&quot;retrievedMetadata&quot;: { # Structured bibliographic metadata for an extracted or retrieved work. # Output only. Metadata retrieved from OpenAlex / Crossref. Populated only when the retrieved work&#x27;s title matches the extracted title. Omitted when no candidate matches the title so unrelated papers are never displayed as candidates.
&quot;authors&quot;: [ # Output only. Ordered list of authors.
{ # Author name components.
&quot;familyName&quot;: &quot;A String&quot;, # Output only. Author family name / surname (or organization name).
&quot;givenName&quot;: &quot;A String&quot;, # Output only. Author given name / initials.
},
],
&quot;doi&quot;: &quot;A String&quot;, # Output only. Digital Object Identifier (DOI).
&quot;journal&quot;: &quot;A String&quot;, # Output only. Journal, conference, or venue name.
&quot;pages&quot;: &quot;A String&quot;, # Output only. Page range or article number.
&quot;publicationDate&quot;: { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. Publication date (month and day left as 0 if just year).
&quot;day&quot;: 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn&#x27;t significant.
&quot;month&quot;: 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
&quot;year&quot;: 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
&quot;source&quot;: &quot;A String&quot;, # Output only. Source database for retrieved metadata (e.g., &quot;openalex&quot;, &quot;crossref&quot;). Empty on `extracted_metadata`.
&quot;title&quot;: &quot;A String&quot;, # Output only. Work title.
&quot;urls&quot;: [ # Output only. URLs associated with the reference.
&quot;A String&quot;,
],
&quot;volume&quot;: &quot;A String&quot;, # Output only. Volume identifier.
},
&quot;searchMethod&quot;: &quot;A String&quot;, # Output only. Strategy that produced the scholarly database match (e.g., &quot;doi&quot;, &quot;title&quot;, &quot;title_author&quot;, &quot;autocomplete&quot;). Empty when no title-matching candidate was found.
&quot;searchRationale&quot;: &quot;A String&quot;, # Output only. Explanation from the Google Search grounding verification step (when run).
&quot;searchVerdict&quot;: &quot;A String&quot;, # Output only. Verdict from Google Search grounding verification (when run).
},
&quot;commentId&quot;: &quot;A String&quot;, # Output only. Unique identifier for the comment within the review.
&quot;location&quot;: { # A location targeting either a PDF page region/quote or text lines in the document. # Output only. Polymorphic location in the document where this comment is anchored.
&quot;pdf&quot;: { # Location anchor within a PDF document. # Output only. Location within a rendered PDF document.
&quot;boundingBoxes&quot;: [ # Output only. Normalized bounding boxes [0.0, 1.0] relative to page width and height. At most 50 bounding boxes are returned per anchored span.
{ # Bounding box in normalized [0.0, 1.0] page coordinates (origin top-left).
&quot;bottom&quot;: 3.14, # Output only. Bottom coordinate in [0.0, 1.0].
&quot;left&quot;: 3.14, # Output only. Left coordinate in [0.0, 1.0].
&quot;right&quot;: 3.14, # Output only. Right coordinate in [0.0, 1.0].
&quot;top&quot;: 3.14, # Output only. Top coordinate in [0.0, 1.0].
},
],
&quot;pageNumber&quot;: 42, # Output only. 1-indexed page number within the PDF document.
&quot;quoteSelector&quot;: { # W3C Web Annotation TextQuoteSelector for resilient text anchoring (see https://www.w3.org/TR/annotation-model/#text-quote-selector for details). # Output only. W3C Web Annotation TextQuoteSelector (https://www.w3.org/TR/annotation-model/#text-quote-selector) for exact text span highlighting.
&quot;exact&quot;: &quot;A String&quot;, # Output only. Verbatim substring extracted from the document character stream.
&quot;prefix&quot;: &quot;A String&quot;, # Output only. Characters immediately preceding `exact` for disambiguation.
&quot;suffix&quot;: &quot;A String&quot;, # Output only. Characters immediately following `exact` for disambiguation.
},
},
&quot;text&quot;: { # Location anchor within a plain-text, Markdown, or LaTeX source document. # Output only. Location within a plain-text, Markdown, or LaTeX source document.
&quot;firstColumn&quot;: 42, # Output only. Optional 1-indexed inclusive first column offset within `first_line`.
&quot;firstLine&quot;: 42, # Output only. 1-indexed inclusive first line number.
&quot;lastColumn&quot;: 42, # Output only. Optional 1-indexed inclusive last column offset within `last_line`.
&quot;lastLine&quot;: 42, # Output only. 1-indexed inclusive last line number.
&quot;quotedLinePreview&quot;: &quot;A String&quot;, # Output only. Verbatim snippet of the anchored source line(s).
},
},
&quot;severity&quot;: &quot;A String&quot;, # Output only. Severity classification of the comment.
&quot;suggestedEdit&quot;: &quot;A String&quot;, # Output only. Optional suggested replacement text or edit for the anchored span.
&quot;summary&quot;: &quot;A String&quot;, # Output only. Short one-line summary of the review comment.
},
],
&quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. Failure status details if review execution failed.
&quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
&quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
},
],
&quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
},
&quot;reviewMarkdown&quot;: &quot;A String&quot;, # Output only. Synthesized review report markdown.
},
&quot;runConfig&quot;: { # Configuration options for the multi-agent document review execution pipeline. # Optional. Run configuration parameters used for this review.
&quot;geminiApiKey&quot;: &quot;A String&quot;, # Optional. Input only. Developer Bring-Your-Own-Key Gemini API key. When provided, requests are billed to the caller&#x27;s Gemini API project. Input only; forwarded to the asynchronous review runner in the task payload and never persisted in database records or returned in review resources (see companion field `gemini_api_key_set`, AIP-147).
&quot;geminiApiKeySet&quot;: True or False, # Output only. Indicates whether a developer Bring-Your-Own-Key Gemini API key was provided for this review run.
&quot;model&quot;: &quot;A String&quot;, # Optional. The Gemini model identifier to use for the review. If omitted, the server uses its default model. Unsupported values return INVALID_ARGUMENT.
&quot;thinkingLevel&quot;: &quot;A String&quot;, # Optional. Reasoning effort level for model calls in the review pipeline. Defaults to `THINKING_LEVEL_MEDIUM` when omitted or `THINKING_LEVEL_UNSPECIFIED`. Non-`THINKING_LEVEL_MEDIUM` thinking levels require `gemini_api_key` when calling `CreateReview`; otherwise `CreateReview` returns `INVALID_ARGUMENT`.
&quot;topology&quot;: &quot;A String&quot;, # Optional. Review execution topology profile to use.
&quot;userPrompt&quot;: &quot;A String&quot;, # Optional. User-provided guidance, focus areas, or custom evaluation instructions passed to the review agents.
},
&quot;startTime&quot;: &quot;A String&quot;, # Output only. Timestamp when the worker started evaluation.
&quot;state&quot;: &quot;A String&quot;, # Output only. Current review lifecycle state.
},
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for estimating what a review would cost. When the cost can&#x27;t be estimated, for example because too few past reviews used the same model, depth, and thinking level, the costs are unset and `past_review_count` is 0.
&quot;highCost&quot;: { # Represents an amount of money with its currency type. # The 95th percentile of what comparable past reviews would cost for this document.
&quot;currencyCode&quot;: &quot;A String&quot;, # The three-letter currency code defined in ISO 4217.
&quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
&quot;units&quot;: &quot;A String&quot;, # The whole units of the amount. For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
},
&quot;lowCost&quot;: { # Represents an amount of money with its currency type. # The 20th percentile of what comparable past reviews would cost for this document.
&quot;currencyCode&quot;: &quot;A String&quot;, # The three-letter currency code defined in ISO 4217.
&quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
&quot;units&quot;: &quot;A String&quot;, # The whole units of the amount. For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
},
&quot;medianCost&quot;: { # Represents an amount of money with its currency type. # The median of what comparable past reviews would cost for this document.
&quot;currencyCode&quot;: &quot;A String&quot;, # The three-letter currency code defined in ISO 4217.
&quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
&quot;units&quot;: &quot;A String&quot;, # The whole units of the amount. For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
},
&quot;pastReviewCount&quot;: 42, # Number of past reviews the estimate is based on.
}</pre>
</div>
<div class="method">
<code class="details" id="get">get(name, x__xgafv=None)</code>
<pre>Retrieves document metadata. The returned document includes its `latest_review_summary` when a review exists.
Args:
name: string, Required. The resource name of the document to retrieve. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A document uploaded for automated review. Documents are immutable post-creation; to review a new version, create a new Document.
&quot;createTime&quot;: &quot;A String&quot;, # Output only. Timestamp when the document was initially created.
&quot;displayName&quot;: &quot;A String&quot;, # Optional. User-provided display title or filename for the document.
&quot;driveSource&quot;: { # Configuration for importing a document directly from Google Drive. # Optional. Reference to a Google Drive file to import.
&quot;fileId&quot;: &quot;A String&quot;, # Required. Immutable. The Google Drive file ID (e.g. &quot;1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms&quot;). For Google Drive shortcuts, callers must pass the resolved target file&#x27;s `file_id` and `resource_key`.
&quot;resourceKey&quot;: &quot;A String&quot;, # Optional. Input only. Immutable. Resource key (`^[a-zA-Z0-9_-]{1,128}$`) required to access certain older link-shared Google Drive files returned by the Google Drive Picker (for shortcuts, pass the resolved target file&#x27;s resource key). Never persisted in database records or returned in Document resources (see companion field `resource_key_set`, AIP-147).
&quot;resourceKeySet&quot;: True or False, # Output only. Indicates whether a resource key was provided for this Drive source.
&quot;revisionId&quot;: &quot;A String&quot;, # Optional. Input only. Immutable. Importing a specific revision is not currently supported; non-empty values return INVALID_ARGUMENT.
},
&quot;latestReviewSummary&quot;: { # Lightweight summary of a Review execution run for display in Document views. # Output only. Summary of the most recent review run for this document, if any. Populated by `GetDocument` and `ListDocuments`; unset on the document returned by `CreateDocument`, which has no reviews yet.
&quot;createTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this review attempt was initiated.
&quot;review&quot;: &quot;A String&quot;, # Output only. Resource name of the Review.
&quot;state&quot;: &quot;A String&quot;, # Output only. Current review lifecycle state.
},
&quot;name&quot;: &quot;A String&quot;, # Identifier. Resource name in format `documents/{document}`.
}</pre>
</div>
<div class="method">
<code class="details" id="list">list(filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists documents for the authenticated caller with cursor pagination. Each returned document includes its `latest_review_summary` when a review exists.
Args:
filter: string, Optional. Custom filter expressions are not currently supported; non-empty values return INVALID_ARGUMENT.
orderBy: string, Optional. Custom order_by expressions are not currently supported; non-empty values return INVALID_ARGUMENT.
pageSize: integer, Optional. The maximum number of documents to return in a single page. The server may return fewer than this value. If unspecified, at most 50 documents will be returned. The maximum value is 100; values above 100 will be coerced to 100.
pageToken: string, Optional. A page token received from a previous `ListDocuments` call.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for listing Document resources.
&quot;documents&quot;: [ # The list of Document resources.
{ # A document uploaded for automated review. Documents are immutable post-creation; to review a new version, create a new Document.
&quot;createTime&quot;: &quot;A String&quot;, # Output only. Timestamp when the document was initially created.
&quot;displayName&quot;: &quot;A String&quot;, # Optional. User-provided display title or filename for the document.
&quot;driveSource&quot;: { # Configuration for importing a document directly from Google Drive. # Optional. Reference to a Google Drive file to import.
&quot;fileId&quot;: &quot;A String&quot;, # Required. Immutable. The Google Drive file ID (e.g. &quot;1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms&quot;). For Google Drive shortcuts, callers must pass the resolved target file&#x27;s `file_id` and `resource_key`.
&quot;resourceKey&quot;: &quot;A String&quot;, # Optional. Input only. Immutable. Resource key (`^[a-zA-Z0-9_-]{1,128}$`) required to access certain older link-shared Google Drive files returned by the Google Drive Picker (for shortcuts, pass the resolved target file&#x27;s resource key). Never persisted in database records or returned in Document resources (see companion field `resource_key_set`, AIP-147).
&quot;resourceKeySet&quot;: True or False, # Output only. Indicates whether a resource key was provided for this Drive source.
&quot;revisionId&quot;: &quot;A String&quot;, # Optional. Input only. Immutable. Importing a specific revision is not currently supported; non-empty values return INVALID_ARGUMENT.
},
&quot;latestReviewSummary&quot;: { # Lightweight summary of a Review execution run for display in Document views. # Output only. Summary of the most recent review run for this document, if any. Populated by `GetDocument` and `ListDocuments`; unset on the document returned by `CreateDocument`, which has no reviews yet.
&quot;createTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this review attempt was initiated.
&quot;review&quot;: &quot;A String&quot;, # Output only. Resource name of the Review.
&quot;state&quot;: &quot;A String&quot;, # Output only. Current review lifecycle state.
},
&quot;name&quot;: &quot;A String&quot;, # Identifier. Resource name in format `documents/{document}`.
},
],
&quot;nextPageToken&quot;: &quot;A String&quot;, # A token to retrieve the next page of results, or empty if no further pages exist.
}</pre>
</div>
<div class="method">
<code class="details" id="list_next">list_next(previous_request, previous_response)</code>
<pre>Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call &#x27;execute()&#x27; on to request the next
page. Returns None if there are no more items in the collection.
</pre>
</div>
</body></html>