blob: b8fe61415f67edc432195c05ffed16c0aac64602 [file] [log] [blame]
<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="discoveryengine_v1alpha.html">Discovery Engine API</a> . <a href="discoveryengine_v1alpha.projects.html">projects</a> . <a href="discoveryengine_v1alpha.projects.locations.html">locations</a> . <a href="discoveryengine_v1alpha.projects.locations.dataStores.html">dataStores</a> . <a href="discoveryengine_v1alpha.projects.locations.dataStores.branches.html">branches</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="discoveryengine_v1alpha.projects.locations.dataStores.branches.documents.html">documents()</a></code>
</p>
<p class="firstline">Returns the documents Resource.</p>
<p class="toc_element">
<code><a href="discoveryengine_v1alpha.projects.locations.dataStores.branches.operations.html">operations()</a></code>
</p>
<p class="firstline">Returns the operations Resource.</p>
<p class="toc_element">
<code><a href="#batchGetDocumentsMetadata">batchGetDocumentsMetadata(parent, matcher_fhirMatcher_fhirResources=None, matcher_urisMatcher_uris=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets index freshness metadata for Documents. Supported for website search only.</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="#get">get(name, view=None, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieves a Branch.</p>
<p class="toc_element">
<code><a href="#list">list(parent, view=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists all Branchs under the specified parent DataStore.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="batchGetDocumentsMetadata">batchGetDocumentsMetadata(parent, matcher_fhirMatcher_fhirResources=None, matcher_urisMatcher_uris=None, x__xgafv=None)</code>
<pre>Gets index freshness metadata for Documents. Supported for website search only.
Args:
parent: string, Required. The parent branch resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`. (required)
matcher_fhirMatcher_fhirResources: string, Required. The FHIR resources to match by. Format: projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}/fhir/{resource_type}/{fhir_resource_id} (repeated)
matcher_urisMatcher_uris: string, The exact URIs to match by. (repeated)
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 DocumentService.BatchGetDocumentsMetadata method.
&quot;documentsMetadata&quot;: [ # The metadata of the Documents.
{ # The metadata of a Document.
&quot;dataIngestionSource&quot;: &quot;A String&quot;, # The data ingestion source of the Document. Allowed values are: * `batch`: Data ingested via Batch API, e.g., ImportDocuments. * `streaming` Data ingested via Streaming API, e.g., FHIR streaming.
&quot;lastRefreshedTime&quot;: &quot;A String&quot;, # The timestamp of the last time the Document was last indexed.
&quot;matcherValue&quot;: { # The value of the matcher that was used to match the Document. # The value of the matcher that was used to match the Document.
&quot;fhirResource&quot;: &quot;A String&quot;, # Format: projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}/fhir/{resource_type}/{fhir_resource_id}
&quot;uri&quot;: &quot;A String&quot;, # If match by URI, the URI of the Document.
},
&quot;state&quot;: &quot;A String&quot;, # The state of the document.
},
],
}</pre>
</div>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="get">get(name, view=None, x__xgafv=None)</code>
<pre>Retrieves a Branch.
Args:
name: string, Required. The name of the branch to retrieve. Format: `projects/*/locations/global/dataStores/default_data_store/branches/some_branch_id`. &quot;default_branch&quot; can be used as a special branch_id, it returns the default branch that has been set for the document. (required)
view: string, The view to apply to the returned Branch. Defaults to Branch.BranchView.BASIC if unspecified.
Allowed values
BRANCH_VIEW_UNSPECIFIED - The value when it&#x27;s unspecified. This defaults to the BASIC view.
BRANCH_VIEW_BASIC - Includes basic metadata about the branch, but not statistical fields. See documentation of individual fields of Branch to know what is excluded.
BRANCH_VIEW_FULL - Includes all fields of a Branch.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A data branch that stores Documents.
&quot;branchStats&quot;: { # Statistics describing a branch. # Output only. Stistics describing a branch. This field is not populated in BranchView.BASIC view.
&quot;documentCounts&quot;: { # The number of documents in a given branch. The key is a group representing a set of documents, and the value is the number of document in that group. Note: keys in this map may change over time. Supported keys: [&#x27;all&#x27;].
&quot;a_key&quot;: &quot;A String&quot;,
},
},
&quot;displayName&quot;: &quot;A String&quot;, # Output only. Human readable name of the branch to display in the UI.
&quot;isDefault&quot;: True or False, # Output only. Indicates whether this branch is set as the default branch of its parent data store.
&quot;lastDocumentImportTime&quot;: &quot;A String&quot;, # Output only. Timestamp of last import through DocumentService.ImportDocuments. Empty value means no import has been made to this branch.
&quot;name&quot;: &quot;A String&quot;, # Immutable. Full resource name of the branch, such as `projects/*/locations/global/dataStores/data_store/branches/branch_id`.
}</pre>
</div>
<div class="method">
<code class="details" id="list">list(parent, view=None, x__xgafv=None)</code>
<pre>Lists all Branchs under the specified parent DataStore.
Args:
parent: string, Required. The parent data store resource name. (required)
view: string, The view to apply to the returned Branch. Defaults to Branch.BranchView.BASIC if unspecified.
Allowed values
BRANCH_VIEW_UNSPECIFIED - The value when it&#x27;s unspecified. This defaults to the BASIC view.
BRANCH_VIEW_BASIC - Includes basic metadata about the branch, but not statistical fields. See documentation of individual fields of Branch to know what is excluded.
BRANCH_VIEW_FULL - Includes all fields of a Branch.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response for BranchService.ListBranches method.
&quot;branches&quot;: [ # The Branches.
{ # A data branch that stores Documents.
&quot;branchStats&quot;: { # Statistics describing a branch. # Output only. Stistics describing a branch. This field is not populated in BranchView.BASIC view.
&quot;documentCounts&quot;: { # The number of documents in a given branch. The key is a group representing a set of documents, and the value is the number of document in that group. Note: keys in this map may change over time. Supported keys: [&#x27;all&#x27;].
&quot;a_key&quot;: &quot;A String&quot;,
},
},
&quot;displayName&quot;: &quot;A String&quot;, # Output only. Human readable name of the branch to display in the UI.
&quot;isDefault&quot;: True or False, # Output only. Indicates whether this branch is set as the default branch of its parent data store.
&quot;lastDocumentImportTime&quot;: &quot;A String&quot;, # Output only. Timestamp of last import through DocumentService.ImportDocuments. Empty value means no import has been made to this branch.
&quot;name&quot;: &quot;A String&quot;, # Immutable. Full resource name of the branch, such as `projects/*/locations/global/dataStores/data_store/branches/branch_id`.
},
],
}</pre>
</div>
</body></html>