Skip to content

Commit 05fc216

Browse files
feat(discoveryengine): update the api
#### discoveryengine:v1 The following keys were added: - schemas.GoogleCloudDiscoveryengineV1AnswerQueryRequest.properties.endUserSpec.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1AnswerQueryRequestEndUserSpec (Total Keys: 13) #### discoveryengine:v1alpha The following keys were added: - schemas.GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest.properties.suggestionTypeSpecs (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestSuggestionTypeSpec (Total Keys: 5) - schemas.GoogleCloudDiscoveryengineV1alphaAnswerQueryRequest.properties.endUserSpec.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestEndUserSpec (Total Keys: 13) #### discoveryengine:v1beta The following keys were added: - schemas.GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest.properties.suggestionTypeSpecs (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestSuggestionTypeSpec (Total Keys: 5) - schemas.GoogleCloudDiscoveryengineV1betaAnswerQueryRequest.properties.endUserSpec.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1betaAnswerQueryRequestEndUserSpec (Total Keys: 13)
1 parent ec139e8 commit 05fc216

20 files changed

+544
-31
lines changed

docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html

+24
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,18 @@ <h3>Method Details</h3>
127127
},
128128
},
129129
&quot;asynchronousMode&quot;: True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
130+
&quot;endUserSpec&quot;: { # End user specification. # Optional. End user specification.
131+
&quot;endUserMetadata&quot;: [ # Optional. End user metadata.
132+
{ # End user metadata.
133+
&quot;chunkInfo&quot;: { # Chunk information. # Chunk information.
134+
&quot;content&quot;: &quot;A String&quot;, # Chunk textual content. It is limited to 8000 characters.
135+
&quot;documentMetadata&quot;: { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
136+
&quot;title&quot;: &quot;A String&quot;, # Title of the document.
137+
},
138+
},
139+
},
140+
],
141+
},
130142
&quot;groundingSpec&quot;: { # Grounding specification. # Optional. Grounding specification.
131143
&quot;filteringLevel&quot;: &quot;A String&quot;, # Optional. Specifies whether to enable the filtering based on grounding score and at what level.
132144
&quot;includeGroundingSupports&quot;: True or False, # Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.
@@ -1637,6 +1649,18 @@ <h3>Method Details</h3>
16371649
},
16381650
},
16391651
&quot;asynchronousMode&quot;: True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
1652+
&quot;endUserSpec&quot;: { # End user specification. # Optional. End user specification.
1653+
&quot;endUserMetadata&quot;: [ # Optional. End user metadata.
1654+
{ # End user metadata.
1655+
&quot;chunkInfo&quot;: { # Chunk information. # Chunk information.
1656+
&quot;content&quot;: &quot;A String&quot;, # Chunk textual content. It is limited to 8000 characters.
1657+
&quot;documentMetadata&quot;: { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
1658+
&quot;title&quot;: &quot;A String&quot;, # Title of the document.
1659+
},
1660+
},
1661+
},
1662+
],
1663+
},
16401664
&quot;groundingSpec&quot;: { # Grounding specification. # Optional. Grounding specification.
16411665
&quot;filteringLevel&quot;: &quot;A String&quot;, # Optional. Specifies whether to enable the filtering based on grounding score and at what level.
16421666
&quot;includeGroundingSupports&quot;: True or False, # Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.

docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html

+24
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,18 @@ <h3>Method Details</h3>
127127
},
128128
},
129129
&quot;asynchronousMode&quot;: True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
130+
&quot;endUserSpec&quot;: { # End user specification. # Optional. End user specification.
131+
&quot;endUserMetadata&quot;: [ # Optional. End user metadata.
132+
{ # End user metadata.
133+
&quot;chunkInfo&quot;: { # Chunk information. # Chunk information.
134+
&quot;content&quot;: &quot;A String&quot;, # Chunk textual content. It is limited to 8000 characters.
135+
&quot;documentMetadata&quot;: { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
136+
&quot;title&quot;: &quot;A String&quot;, # Title of the document.
137+
},
138+
},
139+
},
140+
],
141+
},
130142
&quot;groundingSpec&quot;: { # Grounding specification. # Optional. Grounding specification.
131143
&quot;filteringLevel&quot;: &quot;A String&quot;, # Optional. Specifies whether to enable the filtering based on grounding score and at what level.
132144
&quot;includeGroundingSupports&quot;: True or False, # Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.
@@ -1637,6 +1649,18 @@ <h3>Method Details</h3>
16371649
},
16381650
},
16391651
&quot;asynchronousMode&quot;: True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
1652+
&quot;endUserSpec&quot;: { # End user specification. # Optional. End user specification.
1653+
&quot;endUserMetadata&quot;: [ # Optional. End user metadata.
1654+
{ # End user metadata.
1655+
&quot;chunkInfo&quot;: { # Chunk information. # Chunk information.
1656+
&quot;content&quot;: &quot;A String&quot;, # Chunk textual content. It is limited to 8000 characters.
1657+
&quot;documentMetadata&quot;: { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
1658+
&quot;title&quot;: &quot;A String&quot;, # Title of the document.
1659+
},
1660+
},
1661+
},
1662+
],
1663+
},
16401664
&quot;groundingSpec&quot;: { # Grounding specification. # Optional. Grounding specification.
16411665
&quot;filteringLevel&quot;: &quot;A String&quot;, # Optional. Specifies whether to enable the filtering based on grounding score and at what level.
16421666
&quot;includeGroundingSupports&quot;: True or False, # Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.

docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html

+24
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,18 @@ <h3>Method Details</h3>
127127
},
128128
},
129129
&quot;asynchronousMode&quot;: True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
130+
&quot;endUserSpec&quot;: { # End user specification. # Optional. End user specification.
131+
&quot;endUserMetadata&quot;: [ # Optional. End user metadata.
132+
{ # End user metadata.
133+
&quot;chunkInfo&quot;: { # Chunk information. # Chunk information.
134+
&quot;content&quot;: &quot;A String&quot;, # Chunk textual content. It is limited to 8000 characters.
135+
&quot;documentMetadata&quot;: { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
136+
&quot;title&quot;: &quot;A String&quot;, # Title of the document.
137+
},
138+
},
139+
},
140+
],
141+
},
130142
&quot;groundingSpec&quot;: { # Grounding specification. # Optional. Grounding specification.
131143
&quot;filteringLevel&quot;: &quot;A String&quot;, # Optional. Specifies whether to enable the filtering based on grounding score and at what level.
132144
&quot;includeGroundingSupports&quot;: True or False, # Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.
@@ -1637,6 +1649,18 @@ <h3>Method Details</h3>
16371649
},
16381650
},
16391651
&quot;asynchronousMode&quot;: True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
1652+
&quot;endUserSpec&quot;: { # End user specification. # Optional. End user specification.
1653+
&quot;endUserMetadata&quot;: [ # Optional. End user metadata.
1654+
{ # End user metadata.
1655+
&quot;chunkInfo&quot;: { # Chunk information. # Chunk information.
1656+
&quot;content&quot;: &quot;A String&quot;, # Chunk textual content. It is limited to 8000 characters.
1657+
&quot;documentMetadata&quot;: { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
1658+
&quot;title&quot;: &quot;A String&quot;, # Title of the document.
1659+
},
1660+
},
1661+
},
1662+
],
1663+
},
16401664
&quot;groundingSpec&quot;: { # Grounding specification. # Optional. Grounding specification.
16411665
&quot;filteringLevel&quot;: &quot;A String&quot;, # Optional. Specifies whether to enable the filtering based on grounding score and at what level.
16421666
&quot;includeGroundingSupports&quot;: True or False, # Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.

docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.completionConfig.html

+6
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,12 @@ <h3>Method Details</h3>
107107
&quot;includeTailSuggestions&quot;: True or False, # Indicates if tail suggestions should be returned if there are no suggestions that match the full query. Even if set to true, if there are suggestions that match the full query, those are returned and no tail suggestions are returned.
108108
&quot;query&quot;: &quot;A String&quot;, # Required. The typeahead input used to fetch suggestions. Maximum length is 128 characters. The query can not be empty for most of the suggestion types. If it is empty, an `INVALID_ARGUMENT` error is returned. The exception is when the suggestion_types contains only the type `RECENT_SEARCH`, the query can be an empty string. The is called &quot;zero prefix&quot; feature, which returns user&#x27;s recently searched queries given the empty query.
109109
&quot;queryModel&quot;: &quot;A String&quot;, # Specifies the autocomplete data model. This overrides any model specified in the Configuration &gt; Autocomplete section of the Cloud console. Currently supported values: * `document` - Using suggestions generated from user-imported documents. * `search-history` - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - Using suggestions taken directly from user-imported document fields marked as completable. Default values: * `document` is the default model for regular dataStores. * `search-history` is the default model for site search dataStores.
110+
&quot;suggestionTypeSpecs&quot;: [ # Optional. Specification of each suggestion type.
111+
{ # Specification of each suggestion type.
112+
&quot;maxSuggestions&quot;: 42, # Optional. Maximum number of suggestions to return for each suggestion type.
113+
&quot;suggestionType&quot;: &quot;A String&quot;, # Optional. Suggestion type.
114+
},
115+
],
110116
&quot;suggestionTypes&quot;: [ # Optional. Suggestion types to return. If empty or unspecified, query suggestions are returned. Only one suggestion type is supported at the moment.
111117
&quot;A String&quot;,
112118
],

docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html

+24
Original file line numberDiff line numberDiff line change
@@ -136,6 +136,18 @@ <h3>Method Details</h3>
136136
},
137137
},
138138
&quot;asynchronousMode&quot;: True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
139+
&quot;endUserSpec&quot;: { # End user specification. # Optional. End user specification.
140+
&quot;endUserMetadata&quot;: [ # Optional. End user metadata.
141+
{ # End user metadata.
142+
&quot;chunkInfo&quot;: { # Chunk information. # Chunk information.
143+
&quot;content&quot;: &quot;A String&quot;, # Chunk textual content. It is limited to 8000 characters.
144+
&quot;documentMetadata&quot;: { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
145+
&quot;title&quot;: &quot;A String&quot;, # Title of the document.
146+
},
147+
},
148+
},
149+
],
150+
},
139151
&quot;groundingSpec&quot;: { # Grounding specification. # Optional. Grounding specification.
140152
&quot;filteringLevel&quot;: &quot;A String&quot;, # Optional. Specifies whether to enable the filtering based on grounding score and at what level.
141153
&quot;includeGroundingSupports&quot;: True or False, # Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.
@@ -2339,6 +2351,18 @@ <h3>Method Details</h3>
23392351
},
23402352
},
23412353
&quot;asynchronousMode&quot;: True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
2354+
&quot;endUserSpec&quot;: { # End user specification. # Optional. End user specification.
2355+
&quot;endUserMetadata&quot;: [ # Optional. End user metadata.
2356+
{ # End user metadata.
2357+
&quot;chunkInfo&quot;: { # Chunk information. # Chunk information.
2358+
&quot;content&quot;: &quot;A String&quot;, # Chunk textual content. It is limited to 8000 characters.
2359+
&quot;documentMetadata&quot;: { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
2360+
&quot;title&quot;: &quot;A String&quot;, # Title of the document.
2361+
},
2362+
},
2363+
},
2364+
],
2365+
},
23422366
&quot;groundingSpec&quot;: { # Grounding specification. # Optional. Grounding specification.
23432367
&quot;filteringLevel&quot;: &quot;A String&quot;, # Optional. Specifies whether to enable the filtering based on grounding score and at what level.
23442368
&quot;includeGroundingSupports&quot;: True or False, # Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.

docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.completionConfig.html

+6
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,12 @@ <h3>Method Details</h3>
107107
&quot;includeTailSuggestions&quot;: True or False, # Indicates if tail suggestions should be returned if there are no suggestions that match the full query. Even if set to true, if there are suggestions that match the full query, those are returned and no tail suggestions are returned.
108108
&quot;query&quot;: &quot;A String&quot;, # Required. The typeahead input used to fetch suggestions. Maximum length is 128 characters. The query can not be empty for most of the suggestion types. If it is empty, an `INVALID_ARGUMENT` error is returned. The exception is when the suggestion_types contains only the type `RECENT_SEARCH`, the query can be an empty string. The is called &quot;zero prefix&quot; feature, which returns user&#x27;s recently searched queries given the empty query.
109109
&quot;queryModel&quot;: &quot;A String&quot;, # Specifies the autocomplete data model. This overrides any model specified in the Configuration &gt; Autocomplete section of the Cloud console. Currently supported values: * `document` - Using suggestions generated from user-imported documents. * `search-history` - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - Using suggestions taken directly from user-imported document fields marked as completable. Default values: * `document` is the default model for regular dataStores. * `search-history` is the default model for site search dataStores.
110+
&quot;suggestionTypeSpecs&quot;: [ # Optional. Specification of each suggestion type.
111+
{ # Specification of each suggestion type.
112+
&quot;maxSuggestions&quot;: 42, # Optional. Maximum number of suggestions to return for each suggestion type.
113+
&quot;suggestionType&quot;: &quot;A String&quot;, # Optional. Suggestion type.
114+
},
115+
],
110116
&quot;suggestionTypes&quot;: [ # Optional. Suggestion types to return. If empty or unspecified, query suggestions are returned. Only one suggestion type is supported at the moment.
111117
&quot;A String&quot;,
112118
],

0 commit comments

Comments
 (0)