Package Classes (0.11.13)

Summary of entries of Classes for discoveryengine.

Classes

Service for performing CRUD operations on Controls. Controls allow for custom logic to be implemented in the serving path. Controls need to be attached to a Serving Config to be considered during a request.

ControlServiceClient

ListControlsAsyncPager

A pager for iterating through list_controls requests.

This class thinly wraps an initial ListControlsResponse object, and provides an __aiter__ method to iterate through its controls field.

If there are more pages, the __aiter__ method will make additional ListControls requests and continue to iterate through the controls field on the corresponding responses.

All the usual ListControlsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListControlsPager

A pager for iterating through list_controls requests.

This class thinly wraps an initial ListControlsResponse object, and provides an __iter__ method to iterate through its controls field.

If there are more pages, the __iter__ method will make additional ListControls requests and continue to iterate through the controls field on the corresponding responses.

All the usual ListControlsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ConversationalSearchServiceAsyncClient

Service for conversational search.

ConversationalSearchServiceClient

Service for conversational search.

ListConversationsAsyncPager

A pager for iterating through list_conversations requests.

This class thinly wraps an initial ListConversationsResponse object, and provides an __aiter__ method to iterate through its conversations field.

If there are more pages, the __aiter__ method will make additional ListConversations requests and continue to iterate through the conversations field on the corresponding responses.

All the usual ListConversationsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListConversationsPager

A pager for iterating through list_conversations requests.

This class thinly wraps an initial ListConversationsResponse object, and provides an __iter__ method to iterate through its conversations field.

If there are more pages, the __iter__ method will make additional ListConversations requests and continue to iterate through the conversations field on the corresponding responses.

All the usual ListConversationsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSessionsAsyncPager

A pager for iterating through list_sessions requests.

This class thinly wraps an initial ListSessionsResponse object, and provides an __aiter__ method to iterate through its sessions field.

If there are more pages, the __aiter__ method will make additional ListSessions requests and continue to iterate through the sessions field on the corresponding responses.

All the usual ListSessionsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSessionsPager

A pager for iterating through list_sessions requests.

This class thinly wraps an initial ListSessionsResponse object, and provides an __iter__ method to iterate through its sessions field.

If there are more pages, the __iter__ method will make additional ListSessions requests and continue to iterate through the sessions field on the corresponding responses.

All the usual ListSessionsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

DataStoreServiceAsyncClient

Service for managing DataStore configuration.

DataStoreServiceClient

Service for managing DataStore configuration.

ListDataStoresAsyncPager

A pager for iterating through list_data_stores requests.

This class thinly wraps an initial ListDataStoresResponse object, and provides an __aiter__ method to iterate through its data_stores field.

If there are more pages, the __aiter__ method will make additional ListDataStores requests and continue to iterate through the data_stores field on the corresponding responses.

All the usual ListDataStoresResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListDataStoresPager

A pager for iterating through list_data_stores requests.

This class thinly wraps an initial ListDataStoresResponse object, and provides an __iter__ method to iterate through its data_stores field.

If there are more pages, the __iter__ method will make additional ListDataStores requests and continue to iterate through the data_stores field on the corresponding responses.

All the usual ListDataStoresResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

DocumentServiceAsyncClient

Service for ingesting Document information of the customer's website.

DocumentServiceClient

Service for ingesting Document information of the customer's website.

ListDocumentsAsyncPager

A pager for iterating through list_documents requests.

This class thinly wraps an initial ListDocumentsResponse object, and provides an __aiter__ method to iterate through its documents field.

If there are more pages, the __aiter__ method will make additional ListDocuments requests and continue to iterate through the documents field on the corresponding responses.

All the usual ListDocumentsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListDocumentsPager

A pager for iterating through list_documents requests.

This class thinly wraps an initial ListDocumentsResponse object, and provides an __iter__ method to iterate through its documents field.

If there are more pages, the __iter__ method will make additional ListDocuments requests and continue to iterate through the documents field on the corresponding responses.

All the usual ListDocumentsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

EngineServiceAsyncClient

Service for managing Engine configuration.

EngineServiceClient

Service for managing Engine configuration.

ListEnginesAsyncPager

A pager for iterating through list_engines requests.

This class thinly wraps an initial ListEnginesResponse object, and provides an __aiter__ method to iterate through its engines field.

If there are more pages, the __aiter__ method will make additional ListEngines requests and continue to iterate through the engines field on the corresponding responses.

All the usual ListEnginesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListEnginesPager

A pager for iterating through list_engines requests.

This class thinly wraps an initial ListEnginesResponse object, and provides an __iter__ method to iterate through its engines field.

If there are more pages, the __iter__ method will make additional ListEngines requests and continue to iterate through the engines field on the corresponding responses.

All the usual ListEnginesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

GroundedGenerationServiceAsyncClient

Service for grounded generation.

GroundedGenerationServiceClient

Service for grounded generation.

ProjectServiceAsyncClient

Service for operations on the Project.

ProjectServiceClient

Service for operations on the Project.

RankServiceAsyncClient

Service for ranking text records.

RankServiceClient

Service for ranking text records.

RecommendationServiceAsyncClient

Service for making recommendations.

RecommendationServiceClient

Service for making recommendations.

SchemaServiceAsyncClient

Service for managing Schemas.

SchemaServiceClient

Service for managing Schemas.

ListSchemasAsyncPager

A pager for iterating through list_schemas requests.

This class thinly wraps an initial ListSchemasResponse object, and provides an __aiter__ method to iterate through its schemas field.

If there are more pages, the __aiter__ method will make additional ListSchemas requests and continue to iterate through the schemas field on the corresponding responses.

All the usual ListSchemasResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSchemasPager

A pager for iterating through list_schemas requests.

This class thinly wraps an initial ListSchemasResponse object, and provides an __iter__ method to iterate through its schemas field.

If there are more pages, the __iter__ method will make additional ListSchemas requests and continue to iterate through the schemas field on the corresponding responses.

All the usual ListSchemasResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

SearchServiceAsyncClient

Service for search.

SearchServiceClient

Service for search.

SearchAsyncPager

A pager for iterating through search requests.

This class thinly wraps an initial SearchResponse object, and provides an __aiter__ method to iterate through its results field.

If there are more pages, the __aiter__ method will make additional Search requests and continue to iterate through the results field on the corresponding responses.

All the usual SearchResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

SearchPager

A pager for iterating through search requests.

This class thinly wraps an initial SearchResponse object, and provides an __iter__ method to iterate through its results field.

If there are more pages, the __iter__ method will make additional Search requests and continue to iterate through the results field on the corresponding responses.

All the usual SearchResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

SiteSearchEngineServiceAsyncClient

Service for managing site search related resources.

SiteSearchEngineServiceClient

Service for managing site search related resources.

FetchDomainVerificationStatusAsyncPager

A pager for iterating through fetch_domain_verification_status requests.

This class thinly wraps an initial FetchDomainVerificationStatusResponse object, and provides an __aiter__ method to iterate through its target_sites field.

If there are more pages, the __aiter__ method will make additional FetchDomainVerificationStatus requests and continue to iterate through the target_sites field on the corresponding responses.

All the usual FetchDomainVerificationStatusResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

FetchDomainVerificationStatusPager

A pager for iterating through fetch_domain_verification_status requests.

This class thinly wraps an initial FetchDomainVerificationStatusResponse object, and provides an __iter__ method to iterate through its target_sites field.

If there are more pages, the __iter__ method will make additional FetchDomainVerificationStatus requests and continue to iterate through the target_sites field on the corresponding responses.

ListTargetSitesAsyncPager

A pager for iterating through list_target_sites requests.

This class thinly wraps an initial ListTargetSitesResponse object, and provides an __aiter__ method to iterate through its target_sites field.

If there are more pages, the __aiter__ method will make additional ListTargetSites requests and continue to iterate through the target_sites field on the corresponding responses.

All the usual ListTargetSitesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListTargetSitesPager

A pager for iterating through list_target_sites requests.

This class thinly wraps an initial ListTargetSitesResponse object, and provides an __iter__ method to iterate through its target_sites field.

If there are more pages, the __iter__ method will make additional ListTargetSites requests and continue to iterate through the target_sites field on the corresponding responses.

All the usual ListTargetSitesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

UserEventServiceAsyncClient

Service for ingesting end user actions on a website to Discovery Engine API.

UserEventServiceClient

Service for ingesting end user actions on a website to Discovery Engine API.

Answer

Defines an answer.

AnswerSkippedReason

An enum for answer skipped reasons.

    Google skips the answer if there are no
    high-relevance search results.
POTENTIAL_POLICY_VIOLATION (4):
    The potential policy violation case.

    Google skips the answer if there is a potential
    policy violation detected. This includes content
    that may be violent or toxic.

Citation

Citation info for a segment.

CitationSource

Citation source.

QueryUnderstandingInfo

Query understanding information.

QueryClassificationInfo

Query classification information.

Type

Query classification types.

Reference

Reference.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ChunkInfo

Chunk information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DocumentMetadata

Document metadata.

UnstructuredDocumentInfo

Unstructured document information.

ChunkContent

Chunk content.

State

Enumeration of the state of the answer generation.

Step

Step information.

Action

Action.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Observation

Observation.

SearchResult

ChunkInfo

Chunk information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SnippetInfo

Snippet information.

SearchAction

Search action.

State

Enumeration of the state of the step.

AnswerQueryRequest

Request message for ConversationalSearchService.AnswerQuery method.

AnswerGenerationSpec

Answer generation specification.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ModelSpec

Answer Generation Model specification.

PromptSpec

Answer generation prompt specification.

QueryUnderstandingSpec

Query understanding specification.

QueryClassificationSpec

Query classification specification.

Type

Query classification types.

QueryRephraserSpec

Query rephraser specification.

RelatedQuestionsSpec

SafetySpec

Safety specification.

SearchSpec

Search specification.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SearchParams

Search parameters.

SearchResultList

Search result list.

SearchResult

Search result.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ChunkInfo

Chunk information.

UnstructuredDocumentInfo

Unstructured document information.

DocumentContext

Document context.

ExtractiveAnswer

Extractive answer. Guide <https://cloud.google.com/generative-ai-app-builder/docs/snippets#get-answers>__

ExtractiveSegment

Extractive segment. Guide <https://cloud.google.com/generative-ai-app-builder/docs/snippets#extractive-segments>__

AnswerQueryResponse

Response message for ConversationalSearchService.AnswerQuery method.

BatchCreateTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.

BatchCreateTargetSitesRequest

Request message for SiteSearchEngineService.BatchCreateTargetSites method.

BatchCreateTargetSitesResponse

Response message for SiteSearchEngineService.BatchCreateTargetSites method.

BatchVerifyTargetSitesMetadata

Metadata related to the progress of the SiteSearchEngineService.BatchVerifyTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.

BatchVerifyTargetSitesRequest

Request message for SiteSearchEngineService.BatchVerifyTargetSites method.

BatchVerifyTargetSitesResponse

Response message for SiteSearchEngineService.BatchVerifyTargetSites method.

BigQuerySource

BigQuery source import data from.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

BigtableOptions

The Bigtable Options object that contains information to support the import.

BigtableColumn

The column of the Bigtable.

BigtableColumnFamily

The column family of the Bigtable.

Encoding

The encoding mode of a Bigtable column or column family.

FamiliesEntry

The abstract base class for a message.

Type

The type of values in a Bigtable column or column family. The values are expected to be encoded using HBase Bytes.toBytes <https://hbase.apache.org/apidocs/org/apache/hadoop/hbase/util/Bytes.html>__ function when the encoding value is set to BINARY.

BigtableSource

The Cloud Bigtable source for importing data.

CheckGroundingRequest

Request message for GroundedGenerationService.CheckGrounding method.

UserLabelsEntry

The abstract base class for a message.

CheckGroundingResponse

Response message for the GroundedGenerationService.CheckGrounding method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Claim

Text and citation info for a claim in the answer candidate.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CheckGroundingSpec

Specification for the grounding check.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CloudSqlSource

Cloud SQL source import data from.

CollectUserEventRequest

Request message for CollectUserEvent method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CompleteQueryRequest

Request message for CompletionService.CompleteQuery method.

CompleteQueryResponse

Response message for CompletionService.CompleteQuery method.

QuerySuggestion

Suggestions as search queries.

CompletionInfo

Detailed completion information including completion attribution token and clicked completion info.

Condition

Defines circumstances to be checked before allowing a behavior

QueryTerm

Matcher for search request query

TimeRange

Used for time-dependent conditions.

Control

Defines a conditioned behavior to employ during serving. Must be attached to a [ServingConfig][] to be considered at serving time. Permitted actions dependent on SolutionType.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

BoostAction

Adjusts order of products in returned list.

FilterAction

Specified which products may be included in results. Uses same filter as boost.

RedirectAction

Redirects a shopper to the provided URI.

SynonymsAction

Creates a set of terms that will act as synonyms of one another. Example: "happy" will also be considered as "glad", "glad" will also be considered as "happy".

Conversation

External conversation proto definition.

State

Enumeration of the state of the conversation.

ConversationContext

Defines context of the conversation

ConversationMessage

Defines a conversation message.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ConverseConversationRequest

Request message for ConversationalSearchService.ConverseConversation method.

UserLabelsEntry

The abstract base class for a message.

ConverseConversationResponse

Response message for ConversationalSearchService.ConverseConversation method.

CreateControlRequest

Request for CreateControl method.

CreateConversationRequest

Request for CreateConversation method.

CreateDataStoreMetadata

Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.

CreateDataStoreRequest

Request for DataStoreService.CreateDataStore method.

CreateDocumentRequest

Request message for DocumentService.CreateDocument method.

CreateEngineMetadata

Metadata related to the progress of the EngineService.CreateEngine operation. This will be returned by the google.longrunning.Operation.metadata field.

CreateEngineRequest

Request for EngineService.CreateEngine method.

CreateSchemaMetadata

Metadata for Create Schema LRO.

CreateSchemaRequest

Request message for SchemaService.CreateSchema method.

CreateSessionRequest

Request for CreateSession method.

CreateTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.CreateTargetSite operation. This will be returned by the google.longrunning.Operation.metadata field.

CreateTargetSiteRequest

Request message for SiteSearchEngineService.CreateTargetSite method.

CustomAttribute

A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent.

DataStore

DataStore captures global settings and configs at the DataStore level.

ContentConfig

Content config of the data store.

DeleteControlRequest

Request for DeleteControl method.

DeleteConversationRequest

Request for DeleteConversation method.

DeleteDataStoreMetadata

Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.

DeleteDataStoreRequest

Request message for DataStoreService.DeleteDataStore method.

DeleteDocumentRequest

Request message for DocumentService.DeleteDocument method.

DeleteEngineMetadata

Metadata related to the progress of the EngineService.DeleteEngine operation. This will be returned by the google.longrunning.Operation.metadata field.

DeleteEngineRequest

Request message for EngineService.DeleteEngine method.

DeleteSchemaMetadata

Metadata for DeleteSchema LRO.

DeleteSchemaRequest

Request message for SchemaService.DeleteSchema method.

DeleteSessionRequest

Request for DeleteSession method.

DeleteTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.DeleteTargetSite operation. This will be returned by the google.longrunning.Operation.metadata field.

DeleteTargetSiteRequest

Request message for SiteSearchEngineService.DeleteTargetSite method.

DisableAdvancedSiteSearchMetadata

Metadata related to the progress of the SiteSearchEngineService.DisableAdvancedSiteSearch operation. This will be returned by the google.longrunning.Operation.metadata field.

DisableAdvancedSiteSearchRequest

Request message for SiteSearchEngineService.DisableAdvancedSiteSearch method.

DisableAdvancedSiteSearchResponse

Response message for SiteSearchEngineService.DisableAdvancedSiteSearch method.

Document

Document captures all raw metadata information of items to be recommended or searched.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Content

Unstructured data linked to this document.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DocumentInfo

Detailed document information associated with a user event.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DocumentProcessingConfig

A singleton resource of DataStore. It's empty when DataStore is created, which defaults to digital parser. The first call to [DataStoreService.UpdateDocumentProcessingConfig][] method will initialize the config.

ParsingConfig

Related configurations applied to a specific type of document parser.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DigitalParsingConfig

The digital parsing configurations for documents.

OcrParsingConfig

The OCR parsing configurations for documents.

ParsingConfigOverridesEntry

The abstract base class for a message.

EnableAdvancedSiteSearchMetadata

Metadata related to the progress of the SiteSearchEngineService.EnableAdvancedSiteSearch operation. This will be returned by the google.longrunning.Operation.metadata field.

EnableAdvancedSiteSearchRequest

Request message for SiteSearchEngineService.EnableAdvancedSiteSearch method.

EnableAdvancedSiteSearchResponse

Response message for SiteSearchEngineService.EnableAdvancedSiteSearch method.

Engine

Metadata that describes the training and serving parameters of an Engine.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ChatEngineConfig

Configurations for a Chat Engine.

AgentCreationConfig

Configurations for generating a Dialogflow agent.

Note that these configurations are one-time consumed by and passed to Dialogflow service. It means they cannot be retrieved using EngineService.GetEngine or EngineService.ListEngines API after engine creation.

ChatEngineMetadata

Additional information of a Chat Engine. Fields in this message are output only.

CommonConfig

Common configurations for an Engine.

SearchEngineConfig

Configurations for a Search Engine.

FactChunk

Fact Chunk.

SourceMetadataEntry

The abstract base class for a message.

FetchDomainVerificationStatusRequest

Request message for SiteSearchEngineService.FetchDomainVerificationStatus method.

FetchDomainVerificationStatusResponse

Response message for SiteSearchEngineService.FetchDomainVerificationStatus method.

FhirStoreSource

Cloud FhirStore source import data from.

FirestoreSource

Firestore source import data from.

GcsSource

Cloud Storage location for input content.

GetAnswerRequest

Request for GetAnswer method.

GetControlRequest

Request for GetControl method.

GetConversationRequest

Request for GetConversation method.

GetDataStoreRequest

Request message for DataStoreService.GetDataStore method.

GetDocumentRequest

Request message for DocumentService.GetDocument method.

GetEngineRequest

Request message for EngineService.GetEngine method.

GetSchemaRequest

Request message for SchemaService.GetSchema method.

GetSessionRequest

Request for GetSession method.

GetSiteSearchEngineRequest

Request message for SiteSearchEngineService.GetSiteSearchEngine method.

GetTargetSiteRequest

Request message for SiteSearchEngineService.GetTargetSite method.

GroundingFact

Grounding Fact.

AttributesEntry

The abstract base class for a message.

ImportDocumentsMetadata

Metadata related to the progress of the ImportDocuments operation. This is returned by the google.longrunning.Operation.metadata field.

ImportDocumentsRequest

Request message for Import methods.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

InlineSource

The inline source for the input config for ImportDocuments method.

ReconciliationMode

Indicates how imported documents are reconciled with the existing documents created or imported before.

ImportDocumentsResponse

Response of the ImportDocumentsRequest. If the long running operation is done, then this message is returned by the google.longrunning.Operations.response field if the operation was successful.

ImportErrorConfig

Configuration of destination for Import related errors.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ImportSuggestionDenyListEntriesMetadata

Metadata related to the progress of the ImportSuggestionDenyListEntries operation. This is returned by the google.longrunning.Operation.metadata field.

ImportSuggestionDenyListEntriesRequest

Request message for CompletionService.ImportSuggestionDenyListEntries method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

InlineSource

The inline source for SuggestionDenyListEntry.

ImportSuggestionDenyListEntriesResponse

Response message for CompletionService.ImportSuggestionDenyListEntries method.

ImportUserEventsMetadata

Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.

ImportUserEventsRequest

Request message for the ImportUserEvents request.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

InlineSource

The inline source for the input config for ImportUserEvents method.

ImportUserEventsResponse

Response of the ImportUserEventsRequest. If the long running operation was successful, then this message is returned by the google.longrunning.Operations.response field if the operation was successful.

IndustryVertical

The industry vertical associated with the DataStore.

Interval

A floating point interval.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ListControlsRequest

Request for ListControls method.

ListControlsResponse

Response for ListControls method.

ListConversationsRequest

Request for ListConversations method.

ListConversationsResponse

Response for ListConversations method.

ListDataStoresRequest

Request message for DataStoreService.ListDataStores method.

ListDataStoresResponse

Response message for DataStoreService.ListDataStores method.

ListDocumentsRequest

Request message for DocumentService.ListDocuments method.

ListDocumentsResponse

Response message for DocumentService.ListDocuments method.

ListEnginesRequest

Request message for EngineService.ListEngines method.

ListEnginesResponse

Response message for EngineService.ListEngines method.

ListSchemasRequest

Request message for SchemaService.ListSchemas method.

ListSchemasResponse

Response message for SchemaService.ListSchemas method.

ListSessionsRequest

Request for ListSessions method.

ListSessionsResponse

Response for ListSessions method.

ListTargetSitesRequest

Request message for SiteSearchEngineService.ListTargetSites method.

ListTargetSitesResponse

Response message for SiteSearchEngineService.ListTargetSites method.

MediaInfo

Media-specific user event information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

PageInfo

Detailed page information.

PanelInfo

Detailed panel information associated with a user event.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Project

Metadata and configurations for a Google Cloud project in the service.

ServiceTerms

Metadata about the terms of service.

State

The agreement states this terms of service.

ServiceTermsMapEntry

The abstract base class for a message.

ProvisionProjectMetadata

Metadata associated with a project provision operation.

ProvisionProjectRequest

Request for ProjectService.ProvisionProject method.

PurgeDocumentsMetadata

Metadata related to the progress of the PurgeDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.

PurgeDocumentsRequest

Request message for DocumentService.PurgeDocuments method.

PurgeDocumentsResponse

Response message for DocumentService.PurgeDocuments method. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.

PurgeSuggestionDenyListEntriesMetadata

Metadata related to the progress of the PurgeSuggestionDenyListEntries operation. This is returned by the google.longrunning.Operation.metadata field.

PurgeSuggestionDenyListEntriesRequest

Request message for CompletionService.PurgeSuggestionDenyListEntries method.

PurgeSuggestionDenyListEntriesResponse

Response message for CompletionService.PurgeSuggestionDenyListEntries method.

Query

Defines a user inputed query.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

RankRequest

Request message for RankService.Rank method.

UserLabelsEntry

The abstract base class for a message.

RankResponse

Response message for RankService.Rank method.

RankingRecord

Record message for RankService.Rank method.

RecommendRequest

Request message for Recommend method.

ParamsEntry

The abstract base class for a message.

UserLabelsEntry

The abstract base class for a message.

RecommendResponse

Response message for Recommend method.

RecommendationResult

RecommendationResult represents a generic recommendation result with associated metadata.

MetadataEntry

The abstract base class for a message.

RecrawlUrisMetadata

Metadata related to the progress of the SiteSearchEngineService.RecrawlUris operation. This will be returned by the google.longrunning.Operation.metadata field.

RecrawlUrisRequest

Request message for SiteSearchEngineService.RecrawlUris method.

RecrawlUrisResponse

Response message for SiteSearchEngineService.RecrawlUris method.

FailureInfo

Details about why a particular URI failed to be crawled. Each FailureInfo contains one FailureReason per CorpusType.

FailureReason

Details about why crawling failed for a particular CorpusType, e.g., DESKTOP and MOBILE crawling may fail for different reasons.

CorpusType

CorpusType for the failed crawling operation.

Reply

Defines a reply message to user.

Schema

Defines the structure and layout of a type of document data.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SearchAddOn

Add-on that provides additional functionality for search.

SearchInfo

Detailed search information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SearchRequest

Request message for SearchService.Search method.

BoostSpec

Boost specification to boost certain documents.

ConditionBoostSpec

Boost applies to documents which match a condition.

ContentSearchSpec

A specification for configuring the behavior of content search.

ExtractiveContentSpec

A specification for configuring the extractive content in a search response.

SnippetSpec

A specification for configuring snippets in a search response.

SummarySpec

A specification for configuring a summary returned in a search response.

ModelPromptSpec

Specification of the prompt to use with the model.

ModelSpec

Specification of the model.

DataStoreSpec

A struct to define data stores to filter on in a search call and configurations for those data stores. A maximum of 1 DataStoreSpec per data_store is allowed. Otherwise, an INVALID_ARGUMENT error is returned.

FacetSpec

A facet specification to perform faceted search.

FacetKey

Specifies how a facet is computed.

ImageQuery

Specifies the image query input.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ParamsEntry

The abstract base class for a message.

QueryExpansionSpec

Specification to determine under which conditions query expansion should occur.

Condition

Enum describing under which condition query expansion should occur.

SpellCorrectionSpec

The specification for query spell correction.

Mode

Enum describing under which mode spell correction should occur.

UserLabelsEntry

The abstract base class for a message.

SearchResponse

Response message for SearchService.Search method.

A facet result.

FacetValue

A facet value which contains value names and their count.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

QueryExpansionInfo

Information describing query expansion including whether expansion has occurred.

SearchResult

Represents the search results.

Summary

Summary of the top N search results specified by the summary spec.

Citation

Citation info for a segment.

CitationMetadata

Citation metadata.

CitationSource

Citation source.

Reference

Document reference.

ChunkContent

Chunk content.

SafetyAttributes

Safety Attribute categories and their associated confidence scores.

SummarySkippedReason

An Enum for summary-skipped reasons.

    Only populated when
    <xref uid="google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec.SummarySpec.ignore_adversarial_query">SummarySpec.ignore_adversarial_query</xref>
    is set to `true`.
NON_SUMMARY_SEEKING_QUERY_IGNORED (2):
    The non-summary seeking query ignored case.

    Only populated when
    <xref uid="google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec.SummarySpec.ignore_non_summary_seeking_query">SummarySpec.ignore_non_summary_seeking_query</xref>
    is set to `true`.
OUT_OF_DOMAIN_QUERY_IGNORED (3):
    The out-of-domain query ignored case.

    Google skips the summary if there are no
    high-relevance search results. For example, the
    data store contains facts about company A but
    the user query is asking questions about company
    B.
POTENTIAL_POLICY_VIOLATION (4):
    The potential policy violation case.

    Google skips the summary if there is a potential
    policy violation detected. This includes content
    that may be violent or toxic.
LLM_ADDON_NOT_ENABLED (5):
    The LLM addon not enabled case.

    Google skips the summary if the LLM addon is not
    enabled.

SummaryWithMetadata

Summary with metadata information.

SearchTier

Tiers of search features. Different tiers might have different pricing. To learn more, check the pricing documentation.

SearchUseCase

Defines a further subdivision of SolutionType. Specifically applies to SOLUTION_TYPE_SEARCH.

Session

External session proto definition.

State

Enumeration of the state of the session.

Turn

Represents a turn, including a query from the user and a answer from service.

SiteSearchEngine

SiteSearchEngine captures DataStore level site search persisting configurations. It is a singleton value per data store.

SiteVerificationInfo

Verification information for target sites in advanced site search.

SiteVerificationState

Site verification state.

SolutionType

The type of solution.

SpannerSource

The Spanner source for importing data

SuggestionDenyListEntry

Suggestion deny list entry identifying the phrase to block from suggestions and the applied operation for the phrase.

MatchOperator

Operator for matching with the generated suggestions.

TargetSite

A target site for the SiteSearchEngine.

FailureReason

Site search indexing failure reasons.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

QuotaFailure

Failed due to insufficient quota.

IndexingStatus

Target site indexing status enumeration.

    1. target site deleted if unindexing is
        successful;
    2. state reverts to SUCCEEDED if the unindexing
        fails.

Type

Possible target site types.

TextInput

Defines text input.

TransactionInfo

A transaction represents the entire purchase transaction.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

UpdateControlRequest

Request for UpdateControl method.

UpdateConversationRequest

Request for UpdateConversation method.

UpdateDataStoreRequest

Request message for DataStoreService.UpdateDataStore method.

UpdateDocumentRequest

Request message for DocumentService.UpdateDocument method.

UpdateEngineRequest

Request message for EngineService.UpdateEngine method.

UpdateSchemaMetadata

Metadata for UpdateSchema LRO.

UpdateSchemaRequest

Request message for SchemaService.UpdateSchema method.

UpdateSessionRequest

Request for UpdateSession method.

UpdateTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.UpdateTargetSite operation. This will be returned by the google.longrunning.Operation.metadata field.

UpdateTargetSiteRequest

Request message for SiteSearchEngineService.UpdateTargetSite method.

UserEvent

UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website.

AttributesEntry

The abstract base class for a message.

UserInfo

Information of an end user.

WriteUserEventRequest

Request message for WriteUserEvent method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

AclConfigServiceAsyncClient

Service for managing Acl Configuration.

AclConfigServiceClient

Service for managing Acl Configuration.

ChunkServiceAsyncClient

Service for displaying processed Chunk information of the customer's unstructured data.

ChunkServiceClient

Service for displaying processed Chunk information of the customer's unstructured data.

ListChunksAsyncPager

A pager for iterating through list_chunks requests.

This class thinly wraps an initial ListChunksResponse object, and provides an __aiter__ method to iterate through its chunks field.

If there are more pages, the __aiter__ method will make additional ListChunks requests and continue to iterate through the chunks field on the corresponding responses.

All the usual ListChunksResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListChunksPager

A pager for iterating through list_chunks requests.

This class thinly wraps an initial ListChunksResponse object, and provides an __iter__ method to iterate through its chunks field.

If there are more pages, the __iter__ method will make additional ListChunks requests and continue to iterate through the chunks field on the corresponding responses.

All the usual ListChunksResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

CompletionServiceAsyncClient

Service for Auto-Completion.

CompletionServiceClient

Service for Auto-Completion.

ControlServiceAsyncClient

ControlServiceClient

ListControlsAsyncPager

A pager for iterating through list_controls requests.

This class thinly wraps an initial ListControlsResponse object, and provides an __aiter__ method to iterate through its controls field.

If there are more pages, the __aiter__ method will make additional ListControls requests and continue to iterate through the controls field on the corresponding responses.

All the usual ListControlsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListControlsPager

A pager for iterating through list_controls requests.

This class thinly wraps an initial ListControlsResponse object, and provides an __iter__ method to iterate through its controls field.

If there are more pages, the __iter__ method will make additional ListControls requests and continue to iterate through the controls field on the corresponding responses.

All the usual ListControlsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ConversationalSearchServiceAsyncClient

Service for conversational search.

ConversationalSearchServiceClient

Service for conversational search.

ListConversationsAsyncPager

A pager for iterating through list_conversations requests.

This class thinly wraps an initial ListConversationsResponse object, and provides an __aiter__ method to iterate through its conversations field.

If there are more pages, the __aiter__ method will make additional ListConversations requests and continue to iterate through the conversations field on the corresponding responses.

All the usual ListConversationsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListConversationsPager

A pager for iterating through list_conversations requests.

This class thinly wraps an initial ListConversationsResponse object, and provides an __iter__ method to iterate through its conversations field.

If there are more pages, the __iter__ method will make additional ListConversations requests and continue to iterate through the conversations field on the corresponding responses.

All the usual ListConversationsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSessionsAsyncPager

A pager for iterating through list_sessions requests.

This class thinly wraps an initial ListSessionsResponse object, and provides an __aiter__ method to iterate through its sessions field.

If there are more pages, the __aiter__ method will make additional ListSessions requests and continue to iterate through the sessions field on the corresponding responses.

All the usual ListSessionsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSessionsPager

A pager for iterating through list_sessions requests.

This class thinly wraps an initial ListSessionsResponse object, and provides an __iter__ method to iterate through its sessions field.

If there are more pages, the __iter__ method will make additional ListSessions requests and continue to iterate through the sessions field on the corresponding responses.

All the usual ListSessionsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

DataStoreServiceAsyncClient

Service for managing DataStore configuration.

DataStoreServiceClient

Service for managing DataStore configuration.

ListDataStoresAsyncPager

A pager for iterating through list_data_stores requests.

This class thinly wraps an initial ListDataStoresResponse object, and provides an __aiter__ method to iterate through its data_stores field.

If there are more pages, the __aiter__ method will make additional ListDataStores requests and continue to iterate through the data_stores field on the corresponding responses.

All the usual ListDataStoresResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListDataStoresPager

A pager for iterating through list_data_stores requests.

This class thinly wraps an initial ListDataStoresResponse object, and provides an __iter__ method to iterate through its data_stores field.

If there are more pages, the __iter__ method will make additional ListDataStores requests and continue to iterate through the data_stores field on the corresponding responses.

All the usual ListDataStoresResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

DocumentServiceAsyncClient

Service for ingesting Document information of the customer's website.

DocumentServiceClient

Service for ingesting Document information of the customer's website.

ListDocumentsAsyncPager

A pager for iterating through list_documents requests.

This class thinly wraps an initial ListDocumentsResponse object, and provides an __aiter__ method to iterate through its documents field.

If there are more pages, the __aiter__ method will make additional ListDocuments requests and continue to iterate through the documents field on the corresponding responses.

All the usual ListDocumentsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListDocumentsPager

A pager for iterating through list_documents requests.

This class thinly wraps an initial ListDocumentsResponse object, and provides an __iter__ method to iterate through its documents field.

If there are more pages, the __iter__ method will make additional ListDocuments requests and continue to iterate through the documents field on the corresponding responses.

All the usual ListDocumentsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

EngineServiceAsyncClient

Service for managing Engine configuration.

EngineServiceClient

Service for managing Engine configuration.

ListEnginesAsyncPager

A pager for iterating through list_engines requests.

This class thinly wraps an initial ListEnginesResponse object, and provides an __aiter__ method to iterate through its engines field.

If there are more pages, the __aiter__ method will make additional ListEngines requests and continue to iterate through the engines field on the corresponding responses.

All the usual ListEnginesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListEnginesPager

A pager for iterating through list_engines requests.

This class thinly wraps an initial ListEnginesResponse object, and provides an __iter__ method to iterate through its engines field.

If there are more pages, the __iter__ method will make additional ListEngines requests and continue to iterate through the engines field on the corresponding responses.

All the usual ListEnginesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

EstimateBillingServiceAsyncClient

Service for managing billing estimations resources.

EstimateBillingServiceClient

Service for managing billing estimations resources.

GroundedGenerationServiceAsyncClient

Service for grounded generation.

GroundedGenerationServiceClient

Service for grounded generation.

ProjectServiceAsyncClient

Service for operations on the Project.

ProjectServiceClient

Service for operations on the Project.

RankServiceAsyncClient

Service for ranking text records.

RankServiceClient

Service for ranking text records.

RecommendationServiceAsyncClient

Service for making recommendations.

RecommendationServiceClient

Service for making recommendations.

SchemaServiceAsyncClient

Service for managing Schemas.

SchemaServiceClient

Service for managing Schemas.

ListSchemasAsyncPager

A pager for iterating through list_schemas requests.

This class thinly wraps an initial ListSchemasResponse object, and provides an __aiter__ method to iterate through its schemas field.

If there are more pages, the __aiter__ method will make additional ListSchemas requests and continue to iterate through the schemas field on the corresponding responses.

All the usual ListSchemasResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSchemasPager

A pager for iterating through list_schemas requests.

This class thinly wraps an initial ListSchemasResponse object, and provides an __iter__ method to iterate through its schemas field.

If there are more pages, the __iter__ method will make additional ListSchemas requests and continue to iterate through the schemas field on the corresponding responses.

All the usual ListSchemasResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

SearchServiceAsyncClient

Service for search.

SearchServiceClient

Service for search.

SearchAsyncPager

A pager for iterating through search requests.

This class thinly wraps an initial SearchResponse object, and provides an __aiter__ method to iterate through its results field.

If there are more pages, the __aiter__ method will make additional Search requests and continue to iterate through the results field on the corresponding responses.

All the usual SearchResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

SearchPager

A pager for iterating through search requests.

This class thinly wraps an initial SearchResponse object, and provides an __iter__ method to iterate through its results field.

If there are more pages, the __iter__ method will make additional Search requests and continue to iterate through the results field on the corresponding responses.

All the usual SearchResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

SearchTuningServiceAsyncClient

Service for search tuning.

SearchTuningServiceClient

Service for search tuning.

ServingConfigServiceAsyncClient

Service for operations related to ServingConfig.

ServingConfigServiceClient

Service for operations related to ServingConfig.

ListServingConfigsAsyncPager

A pager for iterating through list_serving_configs requests.

This class thinly wraps an initial ListServingConfigsResponse object, and provides an __aiter__ method to iterate through its serving_configs field.

If there are more pages, the __aiter__ method will make additional ListServingConfigs requests and continue to iterate through the serving_configs field on the corresponding responses.

All the usual ListServingConfigsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListServingConfigsPager

A pager for iterating through list_serving_configs requests.

This class thinly wraps an initial ListServingConfigsResponse object, and provides an __iter__ method to iterate through its serving_configs field.

If there are more pages, the __iter__ method will make additional ListServingConfigs requests and continue to iterate through the serving_configs field on the corresponding responses.

All the usual ListServingConfigsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

SiteSearchEngineServiceAsyncClient

Service for managing site search related resources.

SiteSearchEngineServiceClient

Service for managing site search related resources.

FetchDomainVerificationStatusAsyncPager

A pager for iterating through fetch_domain_verification_status requests.

This class thinly wraps an initial FetchDomainVerificationStatusResponse object, and provides an __aiter__ method to iterate through its target_sites field.

If there are more pages, the __aiter__ method will make additional FetchDomainVerificationStatus requests and continue to iterate through the target_sites field on the corresponding responses.

FetchDomainVerificationStatusPager

A pager for iterating through fetch_domain_verification_status requests.

This class thinly wraps an initial FetchDomainVerificationStatusResponse object, and provides an __iter__ method to iterate through its target_sites field.

If there are more pages, the __iter__ method will make additional FetchDomainVerificationStatus requests and continue to iterate through the target_sites field on the corresponding responses.

ListTargetSitesAsyncPager

A pager for iterating through list_target_sites requests.

This class thinly wraps an initial ListTargetSitesResponse object, and provides an __aiter__ method to iterate through its target_sites field.

If there are more pages, the __aiter__ method will make additional ListTargetSites requests and continue to iterate through the target_sites field on the corresponding responses.

All the usual ListTargetSitesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListTargetSitesPager

A pager for iterating through list_target_sites requests.

This class thinly wraps an initial ListTargetSitesResponse object, and provides an __iter__ method to iterate through its target_sites field.

If there are more pages, the __iter__ method will make additional ListTargetSites requests and continue to iterate through the target_sites field on the corresponding responses.

All the usual ListTargetSitesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

UserEventServiceAsyncClient

Service for ingesting end user actions on a website to Discovery Engine API.

UserEventServiceClient

Service for ingesting end user actions on a website to Discovery Engine API.

AclConfig

Access Control Configuration.

Answer

Defines an answer.

AnswerSkippedReason

An enum for answer skipped reasons.

    Google skips the answer if there are no
    high-relevance search results.
POTENTIAL_POLICY_VIOLATION (4):
    The potential policy violation case.

    Google skips the answer if there is a potential
    policy violation detected. This includes content
    that may be violent or toxic.

Citation

Citation info for a segment.

CitationSource

Citation source.

QueryUnderstandingInfo

Query understanding information.

QueryClassificationInfo

Query classification information.

Type

Query classification types.

Reference

Reference.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ChunkInfo

Chunk information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DocumentMetadata

Document metadata.

UnstructuredDocumentInfo

Unstructured document information.

ChunkContent

Chunk content.

State

Enumeration of the state of the answer generation.

Step

Step information.

Action

Action.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Observation

Observation.

SearchResult

ChunkInfo

Chunk information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SnippetInfo

Snippet information.

SearchAction

Search action.

State

Enumeration of the state of the step.

AnswerQueryRequest

Request message for ConversationalSearchService.AnswerQuery method.

AnswerGenerationSpec

Answer generation specification.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ModelSpec

Answer Generation Model specification.

PromptSpec

Answer generation prompt specification.

QueryUnderstandingSpec

Query understanding specification.

QueryClassificationSpec

Query classification specification.

Type

Query classification types.

QueryRephraserSpec

Query rephraser specification.

RelatedQuestionsSpec

SafetySpec

Safety specification.

SearchSpec

Search specification.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SearchParams

Search parameters.

SearchResultList

Search result list.

SearchResult

Search result.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ChunkInfo

Chunk information.

UnstructuredDocumentInfo

Unstructured document information.

DocumentContext

Document context.

ExtractiveAnswer

Extractive answer. Guide <https://cloud.google.com/generative-ai-app-builder/docs/snippets#get-answers>__

ExtractiveSegment

Extractive segment. Guide <https://cloud.google.com/generative-ai-app-builder/docs/snippets#extractive-segments>__

AnswerQueryResponse

Response message for ConversationalSearchService.AnswerQuery method.

BatchCreateTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.

BatchCreateTargetSitesRequest

Request message for SiteSearchEngineService.BatchCreateTargetSites method.

BatchCreateTargetSitesResponse

Response message for SiteSearchEngineService.BatchCreateTargetSites method.

BatchVerifyTargetSitesMetadata

Metadata related to the progress of the SiteSearchEngineService.BatchVerifyTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.

BatchVerifyTargetSitesRequest

Request message for SiteSearchEngineService.BatchVerifyTargetSites method.

BatchVerifyTargetSitesResponse

Response message for SiteSearchEngineService.BatchVerifyTargetSites method.

BigQuerySource

BigQuery source import data from.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

BigtableOptions

The Bigtable Options object that contains information to support the import.

BigtableColumn

The column of the Bigtable.

BigtableColumnFamily

The column family of the Bigtable.

Encoding

The encoding mode of a Bigtable column or column family.

FamiliesEntry

The abstract base class for a message.

Type

BigtableSource

The Cloud Bigtable source for importing data.

CheckGroundingRequest

Request message for GroundedGenerationService.CheckGrounding method.

UserLabelsEntry

The abstract base class for a message.

CheckGroundingResponse

Response message for the GroundedGenerationService.CheckGrounding method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Claim

Text and citation info for a claim in the answer candidate.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CheckGroundingSpec

Specification for the grounding check.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Chunk

Chunk captures all raw metadata information of items to be recommended or searched in the chunk mode.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ChunkMetadata

Metadata of the current chunk. This field is only populated on SearchService.Search API.

DocumentMetadata

Document metadata contains the information of the document of the current chunk.

PageSpan

Page span of the chunk.

CloudSqlSource

Cloud SQL source import data from.

CollectUserEventRequest

Request message for CollectUserEvent method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CompleteQueryRequest

Request message for CompletionService.CompleteQuery method.

CompleteQueryResponse

Response message for CompletionService.CompleteQuery method.

QuerySuggestion

Suggestions as search queries.

CompletionInfo

Detailed completion information including completion attribution token and clicked completion info.

Condition

Defines circumstances to be checked before allowing a behavior

QueryTerm

Matcher for search request query

TimeRange

Used for time-dependent conditions.

Control

Defines a conditioned behavior to employ during serving. Must be attached to a ServingConfig to be considered at serving time. Permitted actions dependent on SolutionType.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

BoostAction

Adjusts order of products in returned list.

FilterAction

Specified which products may be included in results. Uses same filter as boost.

RedirectAction

Redirects a shopper to the provided URI.

SynonymsAction

Creates a set of terms that will act as synonyms of one another. Example: "happy" will also be considered as "glad", "glad" will also be considered as "happy".

Conversation

External conversation proto definition.

State

Enumeration of the state of the conversation.

ConversationContext

Defines context of the conversation

ConversationMessage

Defines a conversation message.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ConverseConversationRequest

Request message for ConversationalSearchService.ConverseConversation method.

UserLabelsEntry

The abstract base class for a message.

ConverseConversationResponse

Response message for ConversationalSearchService.ConverseConversation method.

CreateControlRequest

Request for CreateControl method.

CreateConversationRequest

Request for CreateConversation method.

CreateDataStoreMetadata

Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.

CreateDataStoreRequest

Request for DataStoreService.CreateDataStore method.

CreateDocumentRequest

Request message for DocumentService.CreateDocument method.

CreateEngineMetadata

Metadata related to the progress of the EngineService.CreateEngine operation. This will be returned by the google.longrunning.Operation.metadata field.

CreateEngineRequest

Request for EngineService.CreateEngine method.

CreateSchemaMetadata

Metadata for Create Schema LRO.

CreateSchemaRequest

Request message for SchemaService.CreateSchema method.

CreateSessionRequest

Request for CreateSession method.

CreateTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.CreateTargetSite operation. This will be returned by the google.longrunning.Operation.metadata field.

CreateTargetSiteRequest

Request message for SiteSearchEngineService.CreateTargetSite method.

CustomAttribute

A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent.

CustomFineTuningSpec

Defines custom fine tuning spec.

CustomTuningModel

Metadata that describes a custom tuned model.

ModelState

The state of the model.

DataStore

DataStore captures global settings and configs at the DataStore level.

ContentConfig

Content config of the data store.

DeleteControlRequest

Request for DeleteControl method.

DeleteConversationRequest

Request for DeleteConversation method.

DeleteDataStoreMetadata

Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.

DeleteDataStoreRequest

Request message for DataStoreService.DeleteDataStore method.

DeleteDocumentRequest

Request message for DocumentService.DeleteDocument method.

DeleteEngineMetadata

Metadata related to the progress of the EngineService.DeleteEngine operation. This will be returned by the google.longrunning.Operation.metadata field.

DeleteEngineRequest

Request message for EngineService.DeleteEngine method.

DeleteSchemaMetadata

Metadata for DeleteSchema LRO.

DeleteSchemaRequest

Request message for SchemaService.DeleteSchema method.

DeleteSessionRequest

Request for DeleteSession method.

DeleteTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.DeleteTargetSite operation. This will be returned by the google.longrunning.Operation.metadata field.

DeleteTargetSiteRequest

Request message for SiteSearchEngineService.DeleteTargetSite method.

DisableAdvancedSiteSearchMetadata

Metadata related to the progress of the SiteSearchEngineService.DisableAdvancedSiteSearch operation. This will be returned by the google.longrunning.Operation.metadata field.

DisableAdvancedSiteSearchRequest

Request message for SiteSearchEngineService.DisableAdvancedSiteSearch method.

DisableAdvancedSiteSearchResponse

Response message for SiteSearchEngineService.DisableAdvancedSiteSearch method.

Document

Document captures all raw metadata information of items to be recommended or searched.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

AclInfo

ACL Information of the Document.

AccessRestriction

AclRestriction to model complex inheritance restrictions.

Example: Modeling a "Both Permit" inheritance, where to access a child document, user needs to have access to parent document.

Document Hierarchy - Space_S --> Page_P.

Readers: Space_S: group_1, user_1 Page_P: group_2, group_3, user_2

Space_S ACL Restriction - { "acl_info": { "readers": [ { "principals": [ { "group_id": "group_1" }, { "user_id": "user_1" } ] } ] } }

Page_P ACL Restriction. { "acl_info": { "readers": [ { "principals": [ { "group_id": "group_2" }, { "group_id": "group_3" }, { "user_id": "user_2" } ], }, { "principals": [ { "group_id": "group_1" }, { "user_id": "user_1" } ], } ] } }

Content

Unstructured data linked to this document.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DocumentInfo

Detailed document information associated with a user event.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DocumentProcessingConfig

A singleton resource of DataStore. It's empty when DataStore is created, which defaults to digital parser. The first call to DataStoreService.UpdateDocumentProcessingConfig method will initialize the config.

ChunkingConfig

Configuration for chunking config.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

LayoutBasedChunkingConfig

Configuration for the layout based chunking.

ParsingConfig

Related configurations applied to a specific type of document parser.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DigitalParsingConfig

The digital parsing configurations for documents.

LayoutParsingConfig

The layout parsing configurations for documents.

OcrParsingConfig

The OCR parsing configurations for documents.

ParsingConfigOverridesEntry

The abstract base class for a message.

DoubleList

Double list.

EmbeddingConfig

Defines embedding config, used for bring your own embeddings feature.

EnableAdvancedSiteSearchMetadata

Metadata related to the progress of the SiteSearchEngineService.EnableAdvancedSiteSearch operation. This will be returned by the google.longrunning.Operation.metadata field.

EnableAdvancedSiteSearchRequest

Request message for SiteSearchEngineService.EnableAdvancedSiteSearch method.

EnableAdvancedSiteSearchResponse

Response message for SiteSearchEngineService.EnableAdvancedSiteSearch method.

Engine

Metadata that describes the training and serving parameters of an Engine.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ChatEngineConfig

Configurations for a Chat Engine.

AgentCreationConfig

Configurations for generating a Dialogflow agent.

ChatEngineMetadata

Additional information of a Chat Engine. Fields in this message are output only.

CommonConfig

Common configurations for an Engine.

MediaRecommendationEngineConfig

Additional config specs for a Media Recommendation engine.

OptimizationObjectiveConfig

Custom threshold for cvr optimization_objective.

TrainingState

The training state of the engine.

RecommendationMetadata

Additional information of a recommendation engine.

DataState

Describes whether this engine have sufficient training data to be continuously trained.

ServingState

The serving state of the recommendation engine.

SearchEngineConfig

Configurations for a Search Engine.

SimilarDocumentsEngineConfig

Additional config specs for a similar-items engine.

EstimateDataSizeMetadata

Metadata related to the progress of the EstimateDataSize operation. This is returned by the google.longrunning.Operation.metadata field.

EstimateDataSizeRequest

Request message for EstimateBillingService.EstimateDataSize method

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

FileDataSource

Data source contains files either in Cloud Storage or BigQuery.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

WebsiteDataSource

Data source is a set of website patterns that we crawl to get the total number of websites.

EstimatorUriPattern

URI patterns that we use to crawl.

EstimateDataSizeResponse

Response of the EstimateDataSize request. If the long running operation was successful, then this message is returned by the google.longrunning.Operations.response field if the operation was successful.

FactChunk

Fact Chunk.

SourceMetadataEntry

The abstract base class for a message.

FetchDomainVerificationStatusRequest

Request message for SiteSearchEngineService.FetchDomainVerificationStatus method.

FetchDomainVerificationStatusResponse

Response message for SiteSearchEngineService.FetchDomainVerificationStatus method.

FhirStoreSource

Cloud FhirStore source import data from.

FieldConfig

Configurations for fields of a schema. For example, configuring a field is indexable, or searchable.

AdvancedSiteSearchDataSource

Optional source of the advanced site search field.

CompletableOption

The setting of Completable options in schema.

DynamicFacetableOption

The status of the dynamic facetable option of a schema field.

FieldType

Field value type in the Schema.

    -  `id`: a string representing the location id
    -  `longitude`: a number representing the longitude
       coordinate of the location
    -  `latitude`: a number repesenting the latitude
       coordinate of the location
    -  `address`: a string representing the full address of
       the location

    `latitude` and `longitude` must always be provided
    together. At least one of a) `address` or b)
    `latitude`-`longitude` pair must be provided.
DATETIME (7):
    Field value type is Datetime. Datetime can be expressed as
    either:

    -  a number representing milliseconds-since-the-epoch
    -  a string representing milliseconds-since-the-epoch. e.g.
       `"1420070400001"`
    -  a string representing the `ISO
       8601 <https://en.wikipedia.org/wiki/ISO_8601>`__ date or
       date and time. e.g. `"2015-01-01"` or
       `"2015-01-01T12:10:30Z"`

FilterableOption

Sets the filterable option for schema fields.

IndexableOption

The setting of Indexable options in schema.

RetrievableOption

The setting of Retrievable options in schema.

SearchableOption

The setting of Searchable options in schema.

FirestoreSource

Firestore source import data from.

GcsSource

Cloud Storage location for input content.

GetAclConfigRequest

Request message for GetAclConfigRequest method.

GetAnswerRequest

Request for GetAnswer method.

GetChunkRequest

Request message for ChunkService.GetChunk method.

GetControlRequest

Request for GetControl method.

GetConversationRequest

Request for GetConversation method.

GetDataStoreRequest

Request message for DataStoreService.GetDataStore method.

GetDocumentProcessingConfigRequest

Request for DataStoreService.GetDocumentProcessingConfig method.

GetDocumentRequest

Request message for DocumentService.GetDocument method.

GetEngineRequest

Request message for EngineService.GetEngine method.

GetProcessedDocumentRequest

Request message for DocumentService.GetDocument method.

ProcessedDocumentFormat

The format of the returned processed document. If unspecified, defaults to JSON.

ProcessedDocumentType

The type of processing to return in the response.

GetProjectRequest

Request message for ProjectService.GetProject method.

GetSchemaRequest

Request message for SchemaService.GetSchema method.

GetServingConfigRequest

Request for GetServingConfig method.

GetSessionRequest

Request for GetSession method.

GetSiteSearchEngineRequest

Request message for SiteSearchEngineService.GetSiteSearchEngine method.

GetTargetSiteRequest

Request message for SiteSearchEngineService.GetTargetSite method.

GroundingFact

Grounding Fact.

AttributesEntry

The abstract base class for a message.

GuidedSearchSpec

Defines guided search spec.

IdpConfig

Identity Provider Config.

ExternalIdpConfig

Third party IDP Config.

IdpType

Identity Provider Type.

ImportDocumentsMetadata

Metadata related to the progress of the ImportDocuments operation. This is returned by the google.longrunning.Operation.metadata field.

ImportDocumentsRequest

Request message for Import methods.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

InlineSource

The inline source for the input config for ImportDocuments method.

ReconciliationMode

Indicates how imported documents are reconciled with the existing documents created or imported before.

ImportDocumentsResponse

Response of the ImportDocumentsRequest. If the long running operation is done, then this message is returned by the google.longrunning.Operations.response field if the operation was successful.

ImportErrorConfig

Configuration of destination for Import related errors.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ImportSuggestionDenyListEntriesMetadata

Metadata related to the progress of the ImportSuggestionDenyListEntries operation. This is returned by the google.longrunning.Operation.metadata field.

ImportSuggestionDenyListEntriesRequest

Request message for CompletionService.ImportSuggestionDenyListEntries method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

InlineSource

The inline source for SuggestionDenyListEntry.

ImportSuggestionDenyListEntriesResponse

Response message for CompletionService.ImportSuggestionDenyListEntries method.

ImportUserEventsMetadata

Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.

ImportUserEventsRequest

Request message for the ImportUserEvents request.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

InlineSource

The inline source for the input config for ImportUserEvents method.

ImportUserEventsResponse

IndustryVertical

The industry vertical associated with the DataStore.

Interval

A floating point interval.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ListChunksRequest

Request message for ChunkService.ListChunks method.

ListChunksResponse

Response message for ChunkService.ListChunks method.

ListControlsRequest

Request for ListControls method.

ListControlsResponse

Response for ListControls method.

ListConversationsRequest

Request for ListConversations method.

ListConversationsResponse

Response for ListConversations method.

ListCustomModelsRequest

Request message for SearchTuningService.ListCustomModels method.

ListCustomModelsResponse

Response message for SearchTuningService.ListCustomModels method.

ListDataStoresRequest

Request message for DataStoreService.ListDataStores method.

ListDataStoresResponse

Response message for DataStoreService.ListDataStores method.

ListDocumentsRequest

Request message for DocumentService.ListDocuments method.

ListDocumentsResponse

Response message for DocumentService.ListDocuments method.

ListEnginesRequest

Request message for EngineService.ListEngines method.

ListEnginesResponse

Response message for EngineService.ListEngines method.

ListSchemasRequest

Request message for SchemaService.ListSchemas method.

ListSchemasResponse

Response message for SchemaService.ListSchemas method.

ListServingConfigsRequest

Request for ListServingConfigs method.

ListServingConfigsResponse

Response for ListServingConfigs method.

ListSessionsRequest

Request for ListSessions method.

ListSessionsResponse

Response for ListSessions method.

ListTargetSitesRequest

Request message for SiteSearchEngineService.ListTargetSites method.

ListTargetSitesResponse

Response message for SiteSearchEngineService.ListTargetSites method.

MediaInfo

Media-specific user event information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

PageInfo

Detailed page information.

PanelInfo

Detailed panel information associated with a user event.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

PauseEngineRequest

Request for pausing training of an engine.

Principal

Principal identifier of a user or a group.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ProcessedDocument

Document captures all raw metadata information of items to be recommended or searched.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Project

Metadata and configurations for a Google Cloud project in the service.

ServiceTerms

Metadata about the terms of service.

State

The agreement states this terms of service.

ServiceTermsMapEntry

The abstract base class for a message.

ProvisionProjectMetadata

Metadata associated with a project provision operation.

ProvisionProjectRequest

Request for ProjectService.ProvisionProject method.

PurgeDocumentsMetadata

Metadata related to the progress of the PurgeDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.

PurgeDocumentsRequest

Request message for DocumentService.PurgeDocuments method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

PurgeDocumentsResponse

Response message for DocumentService.PurgeDocuments method. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.

PurgeErrorConfig

Configuration of destination for Purge related errors.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

PurgeSuggestionDenyListEntriesMetadata

Metadata related to the progress of the PurgeSuggestionDenyListEntries operation. This is returned by the google.longrunning.Operation.metadata field.

PurgeSuggestionDenyListEntriesRequest

Request message for CompletionService.PurgeSuggestionDenyListEntries method.

PurgeSuggestionDenyListEntriesResponse

Response message for CompletionService.PurgeSuggestionDenyListEntries method.

PurgeUserEventsMetadata

Metadata related to the progress of the PurgeUserEvents operation. This will be returned by the google.longrunning.Operation.metadata field.

PurgeUserEventsRequest

Request message for PurgeUserEvents method.

PurgeUserEventsResponse

Response of the PurgeUserEventsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.

Query

Defines a user inputed query.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

RankRequest

Request message for RankService.Rank method.

UserLabelsEntry

The abstract base class for a message.

RankResponse

Response message for RankService.Rank method.

RankingRecord

Record message for RankService.Rank method.

RecommendRequest

Request message for Recommend method.

ParamsEntry

The abstract base class for a message.

UserLabelsEntry

The abstract base class for a message.

RecommendResponse

Response message for Recommend method.

RecommendationResult

RecommendationResult represents a generic recommendation result with associated metadata.

MetadataEntry

The abstract base class for a message.

RecrawlUrisMetadata

Metadata related to the progress of the SiteSearchEngineService.RecrawlUris operation. This will be returned by the google.longrunning.Operation.metadata field.

RecrawlUrisRequest

Request message for SiteSearchEngineService.RecrawlUris method.

RecrawlUrisResponse

Response message for SiteSearchEngineService.RecrawlUris method.

FailureInfo

Details about why a particular URI failed to be crawled. Each FailureInfo contains one FailureReason per CorpusType.

FailureReason

Details about why crawling failed for a particular CorpusType, e.g., DESKTOP and MOBILE crawling may fail for different reasons.

CorpusType

CorpusType for the failed crawling operation.

Reply

Defines a reply message to user.

Reference

Defines reference in reply.

ReportConsentChangeRequest

Request for ReportConsentChange method.

ConsentChangeAction

Type of consent acknowledgement (accept / reject).

At this moment, only ACCEPT action is supported.

ResumeEngineRequest

Request for resuming training of an engine.

Schema

Defines the structure and layout of a type of document data.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SearchAddOn

Add-on that provides additional functionality for search.

SearchInfo

Detailed search information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SearchRequest

Request message for SearchService.Search method.

BoostSpec

Boost specification to boost certain documents.

ConditionBoostSpec

Boost applies to documents which match a condition.

BoostControlSpec

Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above.

AttributeType

The attribute(or function) for which the custom ranking is to be applied.

ControlPoint

The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).

InterpolationType

The interpolation type to be applied. Default will be linear (Piecewise Linear).

ContentSearchSpec

A specification for configuring the behavior of content search.

ChunkSpec

Specifies the chunk spec to be returned from the search response. Only available if the SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS

ExtractiveContentSpec

A specification for configuring the extractive content in a search response.

SearchResultMode

Specifies the search result mode. If unspecified, the search result mode defaults to DOCUMENTS.

SnippetSpec

A specification for configuring snippets in a search response.

SummarySpec

A specification for configuring a summary returned in a search response.

ModelPromptSpec

Specification of the prompt to use with the model.

ModelSpec

Specification of the model.

DataStoreSpec

EmbeddingSpec

The specification that uses customized query embedding vector to do semantic document retrieval.

EmbeddingVector

Embedding vector.

FacetSpec

A facet specification to perform faceted search.

FacetKey

Specifies how a facet is computed.

ImageQuery

Specifies the image query input.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ParamsEntry

The abstract base class for a message.

QueryExpansionSpec

Specification to determine under which conditions query expansion should occur.

Condition

Enum describing under which condition query expansion should occur.

SpellCorrectionSpec

The specification for query spell correction.

Mode

Enum describing under which mode spell correction should occur.

UserLabelsEntry

The abstract base class for a message.

SearchResponse

Response message for SearchService.Search method.

A facet result.

FacetValue

A facet value which contains value names and their count.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

GeoSearchDebugInfo

Debug information specifically related to forward geocoding issues arising from Geolocation Search.

GuidedSearchResult

Guided search result. The guided search helps user to refine the search results and narrow down to the real needs from a broaded search results.

RefinementAttribute

Useful attribute for search result refinements.

QueryExpansionInfo

Information describing query expansion including whether expansion has occurred.

SearchResult

Represents the search results.

ModelScoresEntry

The abstract base class for a message.

Summary

Summary of the top N search results specified by the summary spec.

Citation

Citation info for a segment.

CitationMetadata

Citation metadata.

CitationSource

Citation source.

Reference

Document reference.

ChunkContent

Chunk content.

SafetyAttributes

Safety Attribute categories and their associated confidence scores.

SummarySkippedReason

An Enum for summary-skipped reasons.

    Only populated when
    <xref uid="google.cloud.discoveryengine.v1alpha.SearchRequest.ContentSearchSpec.SummarySpec.ignore_adversarial_query">SummarySpec.ignore_adversarial_query</xref>
    is set to `true`.
NON_SUMMARY_SEEKING_QUERY_IGNORED (2):
    The non-summary seeking query ignored case.

    Only populated when
    <xref uid="google.cloud.discoveryengine.v1alpha.SearchRequest.ContentSearchSpec.SummarySpec.ignore_non_summary_seeking_query">SummarySpec.ignore_non_summary_seeking_query</xref>
    is set to `true`.
OUT_OF_DOMAIN_QUERY_IGNORED (3):
    The out-of-domain query ignored case.

    Google skips the summary if there are no
    high-relevance search results. For example, the
    data store contains facts about company A but
    the user query is asking questions about company
    B.
POTENTIAL_POLICY_VIOLATION (4):
    The potential policy violation case.

    Google skips the summary if there is a potential
    policy violation detected. This includes content
    that may be violent or toxic.
LLM_ADDON_NOT_ENABLED (5):
    The LLM addon not enabled case.

    Google skips the summary if the LLM addon is not
    enabled.

SummaryWithMetadata

Summary with metadata information.

SearchTier

Tiers of search features. Different tiers might have different pricing. To learn more, check the pricing documentation.

SearchUseCase

Defines a further subdivision of SolutionType. Specifically applies to SOLUTION_TYPE_SEARCH.

ServingConfig

Configures metadata that is used to generate serving time results (e.g. search results or recommendation predictions). The ServingConfig is passed in the search and predict request and generates results.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

GenericConfig

Specifies the configurations needed for Generic Discovery.Currently we support:

content_search_spec: configuration for generic content search.

MediaConfig

Specifies the configurations needed for Media Discovery. Currently we support:

demote_content_watched: Threshold for watched content demotion. Customers can specify if using watched content demotion or use viewed detail page. Using the content watched demotion, customers need to specify the watched minutes or percentage exceeds the threshold, the content will be demoted in the recommendation result.
promote_fresh_content: cutoff days for fresh content promotion. Customers can specify if using content freshness promotion. If the content was published within the cutoff days, the content will be promoted in the recommendation result. Can only be set if SolutionType is SOLUTION_TYPE_RECOMMENDATION.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Session

External session proto definition.

State

Enumeration of the state of the session.

Turn

Represents a turn, including a query from the user and a answer from service.

SiteSearchEngine

SiteSearchEngine captures DataStore level site search persisting configurations. It is a singleton value per data store.

SiteVerificationInfo

Verification information for target sites in advanced site search.

SiteVerificationState

Site verification state.

SolutionType

The type of solution.

SpannerSource

The Spanner source for importing data

SuggestionDenyListEntry

Suggestion deny list entry identifying the phrase to block from suggestions and the applied operation for the phrase.

MatchOperator

Operator for matching with the generated suggestions.

TargetSite

A target site for the SiteSearchEngine.

FailureReason

Site search indexing failure reasons.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

QuotaFailure

Failed due to insufficient quota.

IndexingStatus

Target site indexing status enumeration.

    1. target site deleted if unindexing is
        successful;
    2. state reverts to SUCCEEDED if the unindexing
        fails.

Type

Possible target site types.

TextInput

Defines text input.

TrainCustomModelMetadata

Metadata related to the progress of the TrainCustomModel operation. This is returned by the google.longrunning.Operation.metadata field.

TrainCustomModelRequest

Request message for SearchTuningService.TrainCustomModel method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

GcsTrainingInput

Cloud Storage training data input.

TrainCustomModelResponse

Response of the TrainCustomModelRequest. This message is returned by the google.longrunning.Operations.response field.

MetricsEntry

The abstract base class for a message.

TransactionInfo

A transaction represents the entire purchase transaction.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

TuneEngineMetadata

Metadata associated with a tune operation.

TuneEngineRequest

Request to manually start a tuning process now (instead of waiting for the periodically scheduled tuning to happen).

TuneEngineResponse

Response associated with a tune operation.

UpdateAclConfigRequest

Request message for UpdateAclConfig method.

UpdateControlRequest

Request for UpdateControl method.

UpdateConversationRequest

Request for UpdateConversation method.

UpdateDataStoreRequest

Request message for DataStoreService.UpdateDataStore method.

UpdateDocumentProcessingConfigRequest

Request for DataStoreService.UpdateDocumentProcessingConfig method.

UpdateDocumentRequest

Request message for DocumentService.UpdateDocument method.

UpdateEngineRequest

Request message for EngineService.UpdateEngine method.

UpdateSchemaMetadata

Metadata for UpdateSchema LRO.

UpdateSchemaRequest

Request message for SchemaService.UpdateSchema method.

UpdateServingConfigRequest

Request for UpdateServingConfig method.

UpdateSessionRequest

Request for UpdateSession method.

UpdateTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.UpdateTargetSite operation. This will be returned by the google.longrunning.Operation.metadata field.

UpdateTargetSiteRequest

Request message for SiteSearchEngineService.UpdateTargetSite method.

UserEvent

UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website.

AttributesEntry

The abstract base class for a message.

UserInfo

Information of an end user.

WriteUserEventRequest

Request message for WriteUserEvent method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CompletionServiceAsyncClient

Service for Auto-Completion.

CompletionServiceClient

Service for Auto-Completion.

ControlServiceAsyncClient

ControlServiceClient

ListControlsAsyncPager

A pager for iterating through list_controls requests.

This class thinly wraps an initial ListControlsResponse object, and provides an __aiter__ method to iterate through its controls field.

If there are more pages, the __aiter__ method will make additional ListControls requests and continue to iterate through the controls field on the corresponding responses.

All the usual ListControlsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListControlsPager

A pager for iterating through list_controls requests.

This class thinly wraps an initial ListControlsResponse object, and provides an __iter__ method to iterate through its controls field.

If there are more pages, the __iter__ method will make additional ListControls requests and continue to iterate through the controls field on the corresponding responses.

All the usual ListControlsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ConversationalSearchServiceAsyncClient

Service for conversational search.

ConversationalSearchServiceClient

Service for conversational search.

ListConversationsAsyncPager

A pager for iterating through list_conversations requests.

This class thinly wraps an initial ListConversationsResponse object, and provides an __aiter__ method to iterate through its conversations field.

If there are more pages, the __aiter__ method will make additional ListConversations requests and continue to iterate through the conversations field on the corresponding responses.

All the usual ListConversationsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListConversationsPager

A pager for iterating through list_conversations requests.

This class thinly wraps an initial ListConversationsResponse object, and provides an __iter__ method to iterate through its conversations field.

If there are more pages, the __iter__ method will make additional ListConversations requests and continue to iterate through the conversations field on the corresponding responses.

All the usual ListConversationsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSessionsAsyncPager

A pager for iterating through list_sessions requests.

This class thinly wraps an initial ListSessionsResponse object, and provides an __aiter__ method to iterate through its sessions field.

If there are more pages, the __aiter__ method will make additional ListSessions requests and continue to iterate through the sessions field on the corresponding responses.

All the usual ListSessionsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSessionsPager

A pager for iterating through list_sessions requests.

This class thinly wraps an initial ListSessionsResponse object, and provides an __iter__ method to iterate through its sessions field.

If there are more pages, the __iter__ method will make additional ListSessions requests and continue to iterate through the sessions field on the corresponding responses.

All the usual ListSessionsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

DataStoreServiceAsyncClient

Service for managing DataStore configuration.

DataStoreServiceClient

Service for managing DataStore configuration.

ListDataStoresAsyncPager

A pager for iterating through list_data_stores requests.

This class thinly wraps an initial ListDataStoresResponse object, and provides an __aiter__ method to iterate through its data_stores field.

If there are more pages, the __aiter__ method will make additional ListDataStores requests and continue to iterate through the data_stores field on the corresponding responses.

All the usual ListDataStoresResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListDataStoresPager

A pager for iterating through list_data_stores requests.

This class thinly wraps an initial ListDataStoresResponse object, and provides an __iter__ method to iterate through its data_stores field.

If there are more pages, the __iter__ method will make additional ListDataStores requests and continue to iterate through the data_stores field on the corresponding responses.

All the usual ListDataStoresResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

DocumentServiceAsyncClient

Service for ingesting Document information of the customer's website.

DocumentServiceClient

Service for ingesting Document information of the customer's website.

ListDocumentsAsyncPager

A pager for iterating through list_documents requests.

This class thinly wraps an initial ListDocumentsResponse object, and provides an __aiter__ method to iterate through its documents field.

If there are more pages, the __aiter__ method will make additional ListDocuments requests and continue to iterate through the documents field on the corresponding responses.

All the usual ListDocumentsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListDocumentsPager

A pager for iterating through list_documents requests.

This class thinly wraps an initial ListDocumentsResponse object, and provides an __iter__ method to iterate through its documents field.

If there are more pages, the __iter__ method will make additional ListDocuments requests and continue to iterate through the documents field on the corresponding responses.

All the usual ListDocumentsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

EngineServiceAsyncClient

Service for managing Engine configuration.

EngineServiceClient

Service for managing Engine configuration.

ListEnginesAsyncPager

A pager for iterating through list_engines requests.

This class thinly wraps an initial ListEnginesResponse object, and provides an __aiter__ method to iterate through its engines field.

If there are more pages, the __aiter__ method will make additional ListEngines requests and continue to iterate through the engines field on the corresponding responses.

All the usual ListEnginesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListEnginesPager

A pager for iterating through list_engines requests.

This class thinly wraps an initial ListEnginesResponse object, and provides an __iter__ method to iterate through its engines field.

If there are more pages, the __iter__ method will make additional ListEngines requests and continue to iterate through the engines field on the corresponding responses.

All the usual ListEnginesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

GroundedGenerationServiceAsyncClient

Service for grounded generation.

GroundedGenerationServiceClient

Service for grounded generation.

ProjectServiceAsyncClient

Service for operations on the Project.

ProjectServiceClient

Service for operations on the Project.

RankServiceAsyncClient

Service for ranking text records.

RankServiceClient

Service for ranking text records.

RecommendationServiceAsyncClient

Service for making recommendations.

RecommendationServiceClient

Service for making recommendations.

SchemaServiceAsyncClient

Service for managing Schemas.

SchemaServiceClient

Service for managing Schemas.

ListSchemasAsyncPager

A pager for iterating through list_schemas requests.

This class thinly wraps an initial ListSchemasResponse object, and provides an __aiter__ method to iterate through its schemas field.

If there are more pages, the __aiter__ method will make additional ListSchemas requests and continue to iterate through the schemas field on the corresponding responses.

All the usual ListSchemasResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSchemasPager

A pager for iterating through list_schemas requests.

This class thinly wraps an initial ListSchemasResponse object, and provides an __iter__ method to iterate through its schemas field.

If there are more pages, the __iter__ method will make additional ListSchemas requests and continue to iterate through the schemas field on the corresponding responses.

All the usual ListSchemasResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

SearchServiceAsyncClient

Service for search.

SearchServiceClient

Service for search.

SearchAsyncPager

A pager for iterating through search requests.

This class thinly wraps an initial SearchResponse object, and provides an __aiter__ method to iterate through its results field.

If there are more pages, the __aiter__ method will make additional Search requests and continue to iterate through the results field on the corresponding responses.

All the usual SearchResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

SearchPager

A pager for iterating through search requests.

This class thinly wraps an initial SearchResponse object, and provides an __iter__ method to iterate through its results field.

If there are more pages, the __iter__ method will make additional Search requests and continue to iterate through the results field on the corresponding responses.

All the usual SearchResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

SearchTuningServiceAsyncClient

Service for search tuning.

SearchTuningServiceClient

Service for search tuning.

ServingConfigServiceAsyncClient

Service for operations related to ServingConfig.

ServingConfigServiceClient

Service for operations related to ServingConfig.

ListServingConfigsAsyncPager

A pager for iterating through list_serving_configs requests.

This class thinly wraps an initial ListServingConfigsResponse object, and provides an __aiter__ method to iterate through its serving_configs field.

If there are more pages, the __aiter__ method will make additional ListServingConfigs requests and continue to iterate through the serving_configs field on the corresponding responses.

All the usual ListServingConfigsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListServingConfigsPager

A pager for iterating through list_serving_configs requests.

This class thinly wraps an initial ListServingConfigsResponse object, and provides an __iter__ method to iterate through its serving_configs field.

If there are more pages, the __iter__ method will make additional ListServingConfigs requests and continue to iterate through the serving_configs field on the corresponding responses.

All the usual ListServingConfigsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

SiteSearchEngineServiceAsyncClient

Service for managing site search related resources.

SiteSearchEngineServiceClient

Service for managing site search related resources.

FetchDomainVerificationStatusAsyncPager

A pager for iterating through fetch_domain_verification_status requests.

This class thinly wraps an initial FetchDomainVerificationStatusResponse object, and provides an __aiter__ method to iterate through its target_sites field.

If there are more pages, the __aiter__ method will make additional FetchDomainVerificationStatus requests and continue to iterate through the target_sites field on the corresponding responses.

FetchDomainVerificationStatusPager

A pager for iterating through fetch_domain_verification_status requests.

This class thinly wraps an initial FetchDomainVerificationStatusResponse object, and provides an __iter__ method to iterate through its target_sites field.

If there are more pages, the __iter__ method will make additional FetchDomainVerificationStatus requests and continue to iterate through the target_sites field on the corresponding responses.

ListTargetSitesAsyncPager

A pager for iterating through list_target_sites requests.

This class thinly wraps an initial ListTargetSitesResponse object, and provides an __aiter__ method to iterate through its target_sites field.

If there are more pages, the __aiter__ method will make additional ListTargetSites requests and continue to iterate through the target_sites field on the corresponding responses.

All the usual ListTargetSitesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListTargetSitesPager

A pager for iterating through list_target_sites requests.

This class thinly wraps an initial ListTargetSitesResponse object, and provides an __iter__ method to iterate through its target_sites field.

If there are more pages, the __iter__ method will make additional ListTargetSites requests and continue to iterate through the target_sites field on the corresponding responses.

All the usual ListTargetSitesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

UserEventServiceAsyncClient

Service for ingesting end user actions on a website to Discovery Engine API.

UserEventServiceClient

Service for ingesting end user actions on a website to Discovery Engine API.

Answer

Defines an answer.

AnswerSkippedReason

An enum for answer skipped reasons.

    Google skips the answer if there are no
    high-relevance search results.
POTENTIAL_POLICY_VIOLATION (4):
    The potential policy violation case.

    Google skips the answer if there is a potential
    policy violation detected. This includes content
    that may be violent or toxic.

Citation

Citation info for a segment.

CitationSource

Citation source.

QueryUnderstandingInfo

Query understanding information.

QueryClassificationInfo

Query classification information.

Type

Query classification types.

Reference

Reference.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ChunkInfo

Chunk information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DocumentMetadata

Document metadata.

UnstructuredDocumentInfo

Unstructured document information.

ChunkContent

Chunk content.

State

Enumeration of the state of the answer generation.

Step

Step information.

Action

Action.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Observation

Observation.

SearchResult

ChunkInfo

Chunk information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SnippetInfo

Snippet information.

SearchAction

Search action.

State

Enumeration of the state of the step.

AnswerQueryRequest

Request message for ConversationalSearchService.AnswerQuery method.

AnswerGenerationSpec

Answer generation specification.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ModelSpec

Answer Generation Model specification.

PromptSpec

Answer generation prompt specification.

QueryUnderstandingSpec

Query understanding specification.

QueryClassificationSpec

Query classification specification.

Type

Query classification types.

QueryRephraserSpec

Query rephraser specification.

RelatedQuestionsSpec

SafetySpec

Safety specification.

SearchSpec

Search specification.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SearchParams

Search parameters.

SearchResultList

Search result list.

SearchResult

Search result.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ChunkInfo

Chunk information.

UnstructuredDocumentInfo

Unstructured document information.

DocumentContext

Document context.

ExtractiveAnswer

Extractive answer. Guide <https://cloud.google.com/generative-ai-app-builder/docs/snippets#get-answers>__

ExtractiveSegment

Extractive segment. Guide <https://cloud.google.com/generative-ai-app-builder/docs/snippets#extractive-segments>__

AnswerQueryResponse

Response message for ConversationalSearchService.AnswerQuery method.

BatchCreateTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.

BatchCreateTargetSitesRequest

Request message for SiteSearchEngineService.BatchCreateTargetSites method.

BatchCreateTargetSitesResponse

Response message for SiteSearchEngineService.BatchCreateTargetSites method.

BatchVerifyTargetSitesMetadata

Metadata related to the progress of the SiteSearchEngineService.BatchVerifyTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.

BatchVerifyTargetSitesRequest

Request message for SiteSearchEngineService.BatchVerifyTargetSites method.

BatchVerifyTargetSitesResponse

Response message for SiteSearchEngineService.BatchVerifyTargetSites method.

BigQuerySource

BigQuery source import data from.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

BigtableOptions

The Bigtable Options object that contains information to support the import.

BigtableColumn

The column of the Bigtable.

BigtableColumnFamily

The column family of the Bigtable.

Encoding

The encoding mode of a Bigtable column or column family.

FamiliesEntry

The abstract base class for a message.

Type

BigtableSource

The Cloud Bigtable source for importing data.

CheckGroundingRequest

Request message for GroundedGenerationService.CheckGrounding method.

UserLabelsEntry

The abstract base class for a message.

CheckGroundingResponse

Response message for the GroundedGenerationService.CheckGrounding method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Claim

Text and citation info for a claim in the answer candidate.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CheckGroundingSpec

Specification for the grounding check.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CloudSqlSource

Cloud SQL source import data from.

CollectUserEventRequest

Request message for CollectUserEvent method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CompleteQueryRequest

Request message for CompletionService.CompleteQuery method.

CompleteQueryResponse

Response message for CompletionService.CompleteQuery method.

QuerySuggestion

Suggestions as search queries.

CompletionInfo

Detailed completion information including completion attribution token and clicked completion info.

Condition

Defines circumstances to be checked before allowing a behavior

QueryTerm

Matcher for search request query

TimeRange

Used for time-dependent conditions.

Control

Defines a conditioned behavior to employ during serving. Must be attached to a ServingConfig to be considered at serving time. Permitted actions dependent on SolutionType.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

BoostAction

Adjusts order of products in returned list.

FilterAction

Specified which products may be included in results. Uses same filter as boost.

RedirectAction

Redirects a shopper to the provided URI.

SynonymsAction

Creates a set of terms that will act as synonyms of one another. Example: "happy" will also be considered as "glad", "glad" will also be considered as "happy".

Conversation

External conversation proto definition.

State

Enumeration of the state of the conversation.

ConversationContext

Defines context of the conversation

ConversationMessage

Defines a conversation message.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ConverseConversationRequest

Request message for ConversationalSearchService.ConverseConversation method.

UserLabelsEntry

The abstract base class for a message.

ConverseConversationResponse

Response message for ConversationalSearchService.ConverseConversation method.

CreateControlRequest

Request for CreateControl method.

CreateConversationRequest

Request for CreateConversation method.

CreateDataStoreMetadata

Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.

CreateDataStoreRequest

Request for DataStoreService.CreateDataStore method.

CreateDocumentRequest

Request message for DocumentService.CreateDocument method.

CreateEngineMetadata

Metadata related to the progress of the EngineService.CreateEngine operation. This will be returned by the google.longrunning.Operation.metadata field.

CreateEngineRequest

Request for EngineService.CreateEngine method.

CreateSchemaMetadata

Metadata for Create Schema LRO.

CreateSchemaRequest

Request message for SchemaService.CreateSchema method.

CreateSessionRequest

Request for CreateSession method.

CreateTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.CreateTargetSite operation. This will be returned by the google.longrunning.Operation.metadata field.

CreateTargetSiteRequest

Request message for SiteSearchEngineService.CreateTargetSite method.

CustomAttribute

A custom attribute that is not explicitly modeled in a resource, e.g. UserEvent.

CustomTuningModel

Metadata that describes a custom tuned model.

ModelState

The state of the model.

DataStore

DataStore captures global settings and configs at the DataStore level.

ContentConfig

Content config of the data store.

DeleteControlRequest

Request for DeleteControl method.

DeleteConversationRequest

Request for DeleteConversation method.

DeleteDataStoreMetadata

Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.

DeleteDataStoreRequest

Request message for DataStoreService.DeleteDataStore method.

DeleteDocumentRequest

Request message for DocumentService.DeleteDocument method.

DeleteEngineMetadata

Metadata related to the progress of the EngineService.DeleteEngine operation. This will be returned by the google.longrunning.Operation.metadata field.

DeleteEngineRequest

Request message for EngineService.DeleteEngine method.

DeleteSchemaMetadata

Metadata for DeleteSchema LRO.

DeleteSchemaRequest

Request message for SchemaService.DeleteSchema method.

DeleteSessionRequest

Request for DeleteSession method.

DeleteTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.DeleteTargetSite operation. This will be returned by the google.longrunning.Operation.metadata field.

DeleteTargetSiteRequest

Request message for SiteSearchEngineService.DeleteTargetSite method.

DisableAdvancedSiteSearchMetadata

Metadata related to the progress of the SiteSearchEngineService.DisableAdvancedSiteSearch operation. This will be returned by the google.longrunning.Operation.metadata field.

DisableAdvancedSiteSearchRequest

Request message for SiteSearchEngineService.DisableAdvancedSiteSearch method.

DisableAdvancedSiteSearchResponse

Response message for SiteSearchEngineService.DisableAdvancedSiteSearch method.

Document

Document captures all raw metadata information of items to be recommended or searched.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Content

Unstructured data linked to this document.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DocumentInfo

Detailed document information associated with a user event.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DocumentProcessingConfig

ParsingConfig

Related configurations applied to a specific type of document parser.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

DigitalParsingConfig

The digital parsing configurations for documents.

OcrParsingConfig

The OCR parsing configurations for documents.

ParsingConfigOverridesEntry

The abstract base class for a message.

DoubleList

Double list.

EmbeddingConfig

Defines embedding config, used for bring your own embeddings feature.

EnableAdvancedSiteSearchMetadata

Metadata related to the progress of the SiteSearchEngineService.EnableAdvancedSiteSearch operation. This will be returned by the google.longrunning.Operation.metadata field.

EnableAdvancedSiteSearchRequest

Request message for SiteSearchEngineService.EnableAdvancedSiteSearch method.

EnableAdvancedSiteSearchResponse

Response message for SiteSearchEngineService.EnableAdvancedSiteSearch method.

Engine

Metadata that describes the training and serving parameters of an Engine.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ChatEngineConfig

Configurations for a Chat Engine.

AgentCreationConfig

Configurations for generating a Dialogflow agent.

ChatEngineMetadata

Additional information of a Chat Engine. Fields in this message are output only.

CommonConfig

Common configurations for an Engine.

SearchEngineConfig

Configurations for a Search Engine.

FactChunk

Fact Chunk.

SourceMetadataEntry

The abstract base class for a message.

FetchDomainVerificationStatusRequest

Request message for SiteSearchEngineService.FetchDomainVerificationStatus method.

FetchDomainVerificationStatusResponse

Response message for SiteSearchEngineService.FetchDomainVerificationStatus method.

FhirStoreSource

Cloud FhirStore source import data from.

FirestoreSource

Firestore source import data from.

GcsSource

Cloud Storage location for input content.

GetAnswerRequest

Request for GetAnswer method.

GetControlRequest

Request for GetControl method.

GetConversationRequest

Request for GetConversation method.

GetDataStoreRequest

Request message for DataStoreService.GetDataStore method.

GetDocumentRequest

Request message for DocumentService.GetDocument method.

GetEngineRequest

Request message for EngineService.GetEngine method.

GetSchemaRequest

Request message for SchemaService.GetSchema method.

GetServingConfigRequest

Request for GetServingConfig method.

GetSessionRequest

Request for GetSession method.

GetSiteSearchEngineRequest

Request message for SiteSearchEngineService.GetSiteSearchEngine method.

GetTargetSiteRequest

Request message for SiteSearchEngineService.GetTargetSite method.

GroundingFact

Grounding Fact.

AttributesEntry

The abstract base class for a message.

ImportDocumentsMetadata

Metadata related to the progress of the ImportDocuments operation. This is returned by the google.longrunning.Operation.metadata field.

ImportDocumentsRequest

Request message for Import methods.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

InlineSource

The inline source for the input config for ImportDocuments method.

ReconciliationMode

Indicates how imported documents are reconciled with the existing documents created or imported before.

ImportDocumentsResponse

Response of the ImportDocumentsRequest. If the long running operation is done, then this message is returned by the google.longrunning.Operations.response field if the operation was successful.

ImportErrorConfig

Configuration of destination for Import related errors.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ImportSuggestionDenyListEntriesMetadata

Metadata related to the progress of the ImportSuggestionDenyListEntries operation. This is returned by the google.longrunning.Operation.metadata field.

ImportSuggestionDenyListEntriesRequest

Request message for CompletionService.ImportSuggestionDenyListEntries method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

InlineSource

The inline source for SuggestionDenyListEntry.

ImportSuggestionDenyListEntriesResponse

Response message for CompletionService.ImportSuggestionDenyListEntries method.

ImportUserEventsMetadata

Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.

ImportUserEventsRequest

Request message for the ImportUserEvents request.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

InlineSource

The inline source for the input config for ImportUserEvents method.

ImportUserEventsResponse

IndustryVertical

The industry vertical associated with the DataStore.

Interval

A floating point interval.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ListControlsRequest

Request for ListControls method.

ListControlsResponse

Response for ListControls method.

ListConversationsRequest

Request for ListConversations method.

ListConversationsResponse

Response for ListConversations method.

ListCustomModelsRequest

Request message for SearchTuningService.ListCustomModels method.

ListCustomModelsResponse

Response message for SearchTuningService.ListCustomModels method.

ListDataStoresRequest

Request message for DataStoreService.ListDataStores method.

ListDataStoresResponse

Response message for DataStoreService.ListDataStores method.

ListDocumentsRequest

Request message for DocumentService.ListDocuments method.

ListDocumentsResponse

Response message for DocumentService.ListDocuments method.

ListEnginesRequest

Request message for EngineService.ListEngines method.

ListEnginesResponse

Response message for EngineService.ListEngines method.

ListSchemasRequest

Request message for SchemaService.ListSchemas method.

ListSchemasResponse

Response message for SchemaService.ListSchemas method.

ListServingConfigsRequest

Request for ListServingConfigs method.

ListServingConfigsResponse

Response for ListServingConfigs method.

ListSessionsRequest

Request for ListSessions method.

ListSessionsResponse

Response for ListSessions method.

ListTargetSitesRequest

Request message for SiteSearchEngineService.ListTargetSites method.

ListTargetSitesResponse

Response message for SiteSearchEngineService.ListTargetSites method.

MediaInfo

Media-specific user event information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

PageInfo

Detailed page information.

PanelInfo

Detailed panel information associated with a user event.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

PauseEngineRequest

Request for pausing training of an engine.

Project

Metadata and configurations for a Google Cloud project in the service.

ServiceTerms

Metadata about the terms of service.

State

The agreement states this terms of service.

ServiceTermsMapEntry

The abstract base class for a message.

ProvisionProjectMetadata

Metadata associated with a project provision operation.

ProvisionProjectRequest

Request for ProjectService.ProvisionProject method.

PurgeDocumentsMetadata

Metadata related to the progress of the PurgeDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.

PurgeDocumentsRequest

Request message for DocumentService.PurgeDocuments method.

PurgeDocumentsResponse

Response message for DocumentService.PurgeDocuments method. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.

PurgeSuggestionDenyListEntriesMetadata

Metadata related to the progress of the PurgeSuggestionDenyListEntries operation. This is returned by the google.longrunning.Operation.metadata field.

PurgeSuggestionDenyListEntriesRequest

Request message for CompletionService.PurgeSuggestionDenyListEntries method.

PurgeSuggestionDenyListEntriesResponse

Response message for CompletionService.PurgeSuggestionDenyListEntries method.

Query

Defines a user inputed query.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

RankRequest

Request message for RankService.Rank method.

UserLabelsEntry

The abstract base class for a message.

RankResponse

Response message for RankService.Rank method.

RankingRecord

Record message for RankService.Rank method.

RecommendRequest

Request message for Recommend method.

ParamsEntry

The abstract base class for a message.

UserLabelsEntry

The abstract base class for a message.

RecommendResponse

Response message for Recommend method.

RecommendationResult

RecommendationResult represents a generic recommendation result with associated metadata.

MetadataEntry

The abstract base class for a message.

RecrawlUrisMetadata

Metadata related to the progress of the SiteSearchEngineService.RecrawlUris operation. This will be returned by the google.longrunning.Operation.metadata field.

RecrawlUrisRequest

Request message for SiteSearchEngineService.RecrawlUris method.

RecrawlUrisResponse

Response message for SiteSearchEngineService.RecrawlUris method.

FailureInfo

Details about why a particular URI failed to be crawled. Each FailureInfo contains one FailureReason per CorpusType.

FailureReason

Details about why crawling failed for a particular CorpusType, e.g., DESKTOP and MOBILE crawling may fail for different reasons.

CorpusType

CorpusType for the failed crawling operation.

Reply

Defines a reply message to user.

Reference

Defines reference in reply.

ResumeEngineRequest

Request for resuming training of an engine.

Schema

Defines the structure and layout of a type of document data.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SearchAddOn

Add-on that provides additional functionality for search.

SearchInfo

Detailed search information.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SearchRequest

Request message for SearchService.Search method.

BoostSpec

Boost specification to boost certain documents.

ConditionBoostSpec

Boost applies to documents which match a condition.

BoostControlSpec

Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above.

AttributeType

The attribute(or function) for which the custom ranking is to be applied.

ControlPoint

The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).

InterpolationType

The interpolation type to be applied. Default will be linear (Piecewise Linear).

ContentSearchSpec

A specification for configuring the behavior of content search.

ExtractiveContentSpec

A specification for configuring the extractive content in a search response.

SnippetSpec

A specification for configuring snippets in a search response.

SummarySpec

A specification for configuring a summary returned in a search response.

ModelPromptSpec

Specification of the prompt to use with the model.

ModelSpec

Specification of the model.

DataStoreSpec

EmbeddingSpec

The specification that uses customized query embedding vector to do semantic document retrieval.

EmbeddingVector

Embedding vector.

FacetSpec

A facet specification to perform faceted search.

FacetKey

Specifies how a facet is computed.

ImageQuery

Specifies the image query input.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ParamsEntry

The abstract base class for a message.

QueryExpansionSpec

Specification to determine under which conditions query expansion should occur.

Condition

Enum describing under which condition query expansion should occur.

SpellCorrectionSpec

The specification for query spell correction.

Mode

Enum describing under which mode spell correction should occur.

UserLabelsEntry

The abstract base class for a message.

SearchResponse

Response message for SearchService.Search method.

A facet result.

FacetValue

A facet value which contains value names and their count.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

GeoSearchDebugInfo

Debug information specifically related to forward geocoding issues arising from Geolocation Search.

GuidedSearchResult

Guided search result. The guided search helps user to refine the search results and narrow down to the real needs from a broaded search results.

RefinementAttribute

Useful attribute for search result refinements.

QueryExpansionInfo

Information describing query expansion including whether expansion has occurred.

SearchResult

Represents the search results.

ModelScoresEntry

The abstract base class for a message.

Summary

Summary of the top N search results specified by the summary spec.

Citation

Citation info for a segment.

CitationMetadata

Citation metadata.

CitationSource

Citation source.

Reference

Document reference.

ChunkContent

Chunk content.

SafetyAttributes

Safety Attribute categories and their associated confidence scores.

SummarySkippedReason

An Enum for summary-skipped reasons.

    Only populated when
    <xref uid="google.cloud.discoveryengine.v1beta.SearchRequest.ContentSearchSpec.SummarySpec.ignore_adversarial_query">SummarySpec.ignore_adversarial_query</xref>
    is set to `true`.
NON_SUMMARY_SEEKING_QUERY_IGNORED (2):
    The non-summary seeking query ignored case.

    Only populated when
    <xref uid="google.cloud.discoveryengine.v1beta.SearchRequest.ContentSearchSpec.SummarySpec.ignore_non_summary_seeking_query">SummarySpec.ignore_non_summary_seeking_query</xref>
    is set to `true`.
OUT_OF_DOMAIN_QUERY_IGNORED (3):
    The out-of-domain query ignored case.

    Google skips the summary if there are no
    high-relevance search results. For example, the
    data store contains facts about company A but
    the user query is asking questions about company
    B.
POTENTIAL_POLICY_VIOLATION (4):
    The potential policy violation case.

    Google skips the summary if there is a potential
    policy violation detected. This includes content
    that may be violent or toxic.
LLM_ADDON_NOT_ENABLED (5):
    The LLM addon not enabled case.

    Google skips the summary if the LLM addon is not
    enabled.

SummaryWithMetadata

Summary with metadata information.

SearchTier

Tiers of search features. Different tiers might have different pricing. To learn more, check the pricing documentation.

SearchUseCase

Defines a further subdivision of SolutionType. Specifically applies to SOLUTION_TYPE_SEARCH.

ServingConfig

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

GenericConfig

Specifies the configurations needed for Generic Discovery.Currently we support:

content_search_spec: configuration for generic content search.

MediaConfig

Specifies the configurations needed for Media Discovery. Currently we support:

demote_content_watched: Threshold for watched content demotion. Customers can specify if using watched content demotion or use viewed detail page. Using the content watched demotion, customers need to specify the watched minutes or percentage exceeds the threshold, the content will be demoted in the recommendation result.
promote_fresh_content: cutoff days for fresh content promotion. Customers can specify if using content freshness promotion. If the content was published within the cutoff days, the content will be promoted in the recommendation result. Can only be set if SolutionType is SOLUTION_TYPE_RECOMMENDATION.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Session

External session proto definition.

State

Enumeration of the state of the session.

Turn

Represents a turn, including a query from the user and a answer from service.

SiteSearchEngine

SiteSearchEngine captures DataStore level site search persisting configurations. It is a singleton value per data store.

SiteVerificationInfo

Verification information for target sites in advanced site search.

SiteVerificationState

Site verification state.

SolutionType

The type of solution.

SpannerSource

The Spanner source for importing data

SuggestionDenyListEntry

Suggestion deny list entry identifying the phrase to block from suggestions and the applied operation for the phrase.

MatchOperator

Operator for matching with the generated suggestions.

TargetSite

A target site for the SiteSearchEngine.

FailureReason

Site search indexing failure reasons.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

QuotaFailure

Failed due to insufficient quota.

IndexingStatus

Target site indexing status enumeration.

    1. target site deleted if unindexing is
        successful;
    2. state reverts to SUCCEEDED if the unindexing
        fails.

Type

Possible target site types.

TextInput

Defines text input.

TrainCustomModelMetadata

Metadata related to the progress of the TrainCustomModel operation. This is returned by the google.longrunning.Operation.metadata field.

TrainCustomModelRequest

Request message for SearchTuningService.TrainCustomModel method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

GcsTrainingInput

Cloud Storage training data input.

TrainCustomModelResponse

Response of the TrainCustomModelRequest. This message is returned by the google.longrunning.Operations.response field.

MetricsEntry

The abstract base class for a message.

TransactionInfo

A transaction represents the entire purchase transaction.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

TuneEngineMetadata

Metadata associated with a tune operation.

TuneEngineRequest

Request to manually start a tuning process now (instead of waiting for the periodically scheduled tuning to happen).

TuneEngineResponse

Response associated with a tune operation.

UpdateControlRequest

Request for UpdateControl method.

UpdateConversationRequest

Request for UpdateConversation method.

UpdateDataStoreRequest

Request message for DataStoreService.UpdateDataStore method.

UpdateDocumentRequest

Request message for DocumentService.UpdateDocument method.

UpdateEngineRequest

Request message for EngineService.UpdateEngine method.

UpdateSchemaMetadata

Metadata for UpdateSchema LRO.

UpdateSchemaRequest

Request message for SchemaService.UpdateSchema method.

UpdateServingConfigRequest

Request for UpdateServingConfig method.

UpdateSessionRequest

Request for UpdateSession method.

UpdateTargetSiteMetadata

Metadata related to the progress of the SiteSearchEngineService.UpdateTargetSite operation. This will be returned by the google.longrunning.Operation.metadata field.

UpdateTargetSiteRequest

Request message for SiteSearchEngineService.UpdateTargetSite method.

UserEvent

UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website.

AttributesEntry

The abstract base class for a message.

UserInfo

Information of an end user.

WriteUserEventRequest

Request message for WriteUserEvent method.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields