google-api-python-client 2.176.0__py3-none-any.whl → 2.178.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. {google_api_python_client-2.176.0.dist-info → google_api_python_client-2.178.0.dist-info}/METADATA +1 -1
  2. {google_api_python_client-2.176.0.dist-info → google_api_python_client-2.178.0.dist-info}/RECORD +169 -167
  3. googleapiclient/discovery_cache/documents/accessapproval.v1.json +7 -1
  4. googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json +2 -2
  5. googleapiclient/discovery_cache/documents/admin.datatransfer_v1.json +4 -4
  6. googleapiclient/discovery_cache/documents/admin.datatransferv1.json +4 -4
  7. googleapiclient/discovery_cache/documents/admin.directory_v1.json +86 -86
  8. googleapiclient/discovery_cache/documents/admin.directoryv1.json +86 -86
  9. googleapiclient/discovery_cache/documents/admin.reports_v1.json +31 -3
  10. googleapiclient/discovery_cache/documents/admin.reportsv1.json +31 -3
  11. googleapiclient/discovery_cache/documents/adsenseplatform.v1alpha.json +4 -4
  12. googleapiclient/discovery_cache/documents/aiplatform.v1.json +379 -31
  13. googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json +717 -47
  14. googleapiclient/discovery_cache/documents/alloydb.v1.json +144 -9
  15. googleapiclient/discovery_cache/documents/alloydb.v1alpha.json +144 -9
  16. googleapiclient/discovery_cache/documents/alloydb.v1beta.json +144 -9
  17. googleapiclient/discovery_cache/documents/analyticsadmin.v1alpha.json +46 -227
  18. googleapiclient/discovery_cache/documents/androidenterprise.v1.json +30 -1
  19. googleapiclient/discovery_cache/documents/androidmanagement.v1.json +3 -3
  20. googleapiclient/discovery_cache/documents/androidpublisher.v3.json +2136 -300
  21. googleapiclient/discovery_cache/documents/apigee.v1.json +6 -6
  22. googleapiclient/discovery_cache/documents/apihub.v1.json +535 -7
  23. googleapiclient/discovery_cache/documents/apphub.v1alpha.json +1 -68
  24. googleapiclient/discovery_cache/documents/artifactregistry.v1.json +7 -7
  25. googleapiclient/discovery_cache/documents/artifactregistry.v1beta1.json +6 -6
  26. googleapiclient/discovery_cache/documents/artifactregistry.v1beta2.json +6 -6
  27. googleapiclient/discovery_cache/documents/backupdr.v1.json +65 -21
  28. googleapiclient/discovery_cache/documents/batch.v1.json +13 -7
  29. googleapiclient/discovery_cache/documents/beyondcorp.v1.json +61 -9
  30. googleapiclient/discovery_cache/documents/beyondcorp.v1alpha.json +61 -9
  31. googleapiclient/discovery_cache/documents/biglake.v1.json +1 -1
  32. googleapiclient/discovery_cache/documents/bigquery.v2.json +73 -7
  33. googleapiclient/discovery_cache/documents/bigtableadmin.v2.json +56 -1
  34. googleapiclient/discovery_cache/documents/chat.v1.json +105 -31
  35. googleapiclient/discovery_cache/documents/chromemanagement.v1.json +325 -6
  36. googleapiclient/discovery_cache/documents/civicinfo.v2.json +7 -1
  37. googleapiclient/discovery_cache/documents/cloudasset.v1.json +31 -1
  38. googleapiclient/discovery_cache/documents/cloudbilling.v1beta.json +9 -1168
  39. googleapiclient/discovery_cache/documents/cloudbuild.v1.json +2 -2
  40. googleapiclient/discovery_cache/documents/cloudbuild.v2.json +1 -26
  41. googleapiclient/discovery_cache/documents/compute.alpha.json +1044 -105
  42. googleapiclient/discovery_cache/documents/compute.beta.json +416 -85
  43. googleapiclient/discovery_cache/documents/compute.v1.json +262 -26
  44. googleapiclient/discovery_cache/documents/connectors.v1.json +29 -1
  45. googleapiclient/discovery_cache/documents/contactcenteraiplatform.v1alpha1.json +6 -1
  46. googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json +73 -9
  47. googleapiclient/discovery_cache/documents/container.v1.json +257 -3
  48. googleapiclient/discovery_cache/documents/container.v1beta1.json +258 -14
  49. googleapiclient/discovery_cache/documents/containeranalysis.v1.json +2 -2
  50. googleapiclient/discovery_cache/documents/containeranalysis.v1alpha1.json +2 -2
  51. googleapiclient/discovery_cache/documents/containeranalysis.v1beta1.json +2 -2
  52. googleapiclient/discovery_cache/documents/content.v2.1.json +2 -2
  53. googleapiclient/discovery_cache/documents/datacatalog.v1.json +1 -2
  54. googleapiclient/discovery_cache/documents/dataflow.v1b3.json +43 -36
  55. googleapiclient/discovery_cache/documents/dataform.v1beta1.json +35 -1
  56. googleapiclient/discovery_cache/documents/datalineage.v1.json +6 -1
  57. googleapiclient/discovery_cache/documents/dataplex.v1.json +214 -30
  58. googleapiclient/discovery_cache/documents/dataportability.v1.json +1 -10
  59. googleapiclient/discovery_cache/documents/dataportability.v1beta.json +1 -10
  60. googleapiclient/discovery_cache/documents/datastream.v1.json +63 -1
  61. googleapiclient/discovery_cache/documents/developerconnect.v1.json +2 -2
  62. googleapiclient/discovery_cache/documents/dfareporting.v4.json +1210 -70
  63. googleapiclient/discovery_cache/documents/dialogflow.v2.json +286 -1
  64. googleapiclient/discovery_cache/documents/discoveryengine.v1.json +1715 -185
  65. googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json +1488 -62
  66. googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json +1377 -244
  67. googleapiclient/discovery_cache/documents/displayvideo.v2.json +1376 -213
  68. googleapiclient/discovery_cache/documents/displayvideo.v3.json +27 -4
  69. googleapiclient/discovery_cache/documents/displayvideo.v4.json +1377 -202
  70. googleapiclient/discovery_cache/documents/dlp.v2.json +33 -12
  71. googleapiclient/discovery_cache/documents/documentai.v1.json +15 -8
  72. googleapiclient/discovery_cache/documents/documentai.v1beta3.json +15 -8
  73. googleapiclient/discovery_cache/documents/drive.v3.json +3 -109
  74. googleapiclient/discovery_cache/documents/fcm.v1.json +3 -3
  75. googleapiclient/discovery_cache/documents/file.v1.json +7 -1
  76. googleapiclient/discovery_cache/documents/file.v1beta1.json +7 -1
  77. googleapiclient/discovery_cache/documents/firebaseapphosting.v1beta.json +5 -1
  78. googleapiclient/discovery_cache/documents/firebasedataconnect.v1.json +6 -2
  79. googleapiclient/discovery_cache/documents/firebasedataconnect.v1beta.json +6 -2
  80. googleapiclient/discovery_cache/documents/firebaseml.v2beta.json +145 -27
  81. googleapiclient/discovery_cache/documents/gkebackup.v1.json +28 -1
  82. googleapiclient/discovery_cache/documents/gkehub.v1.json +30 -9
  83. googleapiclient/discovery_cache/documents/gkehub.v1alpha.json +30 -9
  84. googleapiclient/discovery_cache/documents/gkehub.v1beta.json +30 -9
  85. googleapiclient/discovery_cache/documents/gkehub.v1beta1.json +14 -1
  86. googleapiclient/discovery_cache/documents/gkehub.v2.json +17 -9
  87. googleapiclient/discovery_cache/documents/gkehub.v2alpha.json +17 -9
  88. googleapiclient/discovery_cache/documents/gkehub.v2beta.json +17 -9
  89. googleapiclient/discovery_cache/documents/healthcare.v1.json +61 -5
  90. googleapiclient/discovery_cache/documents/healthcare.v1beta1.json +24 -6
  91. googleapiclient/discovery_cache/documents/homegraph.v1.json +2 -2
  92. googleapiclient/discovery_cache/documents/iam.v1.json +524 -1
  93. googleapiclient/discovery_cache/documents/iamcredentials.v1.json +21 -1
  94. googleapiclient/discovery_cache/documents/integrations.v1.json +1 -363
  95. googleapiclient/discovery_cache/documents/kmsinventory.v1.json +17 -3
  96. googleapiclient/discovery_cache/documents/logging.v2.json +11 -1
  97. googleapiclient/discovery_cache/documents/looker.v1.json +15 -1
  98. googleapiclient/discovery_cache/documents/managedkafka.v1.json +11 -1
  99. googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json +131 -8
  100. googleapiclient/discovery_cache/documents/merchantapi.datasources_v1beta.json +3 -4
  101. googleapiclient/discovery_cache/documents/merchantapi.inventories_v1beta.json +9 -7
  102. googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1beta.json +5 -5
  103. googleapiclient/discovery_cache/documents/merchantapi.products_v1beta.json +22 -14
  104. googleapiclient/discovery_cache/documents/merchantapi.promotions_v1beta.json +2 -2
  105. googleapiclient/discovery_cache/documents/merchantapi.reviews_v1beta.json +17 -9
  106. googleapiclient/discovery_cache/documents/migrationcenter.v1alpha1.json +7 -3
  107. googleapiclient/discovery_cache/documents/monitoring.v1.json +4 -4
  108. googleapiclient/discovery_cache/documents/monitoring.v3.json +4 -4
  109. googleapiclient/discovery_cache/documents/mybusinessbusinessinformation.v1.json +6 -1
  110. googleapiclient/discovery_cache/documents/mybusinessverifications.v1.json +76 -1
  111. googleapiclient/discovery_cache/documents/netapp.v1beta1.json +51 -1
  112. googleapiclient/discovery_cache/documents/networkconnectivity.v1.json +4 -4
  113. googleapiclient/discovery_cache/documents/networkmanagement.v1.json +965 -14
  114. googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json +10 -5
  115. googleapiclient/discovery_cache/documents/networksecurity.v1.json +39 -5
  116. googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json +270 -5
  117. googleapiclient/discovery_cache/documents/networkservices.v1.json +15 -13
  118. googleapiclient/discovery_cache/documents/networkservices.v1beta1.json +15 -13
  119. googleapiclient/discovery_cache/documents/notebooks.v2.json +131 -1
  120. googleapiclient/discovery_cache/documents/oracledatabase.v1.json +478 -1
  121. googleapiclient/discovery_cache/documents/osconfig.v1.json +24 -1
  122. googleapiclient/discovery_cache/documents/osconfig.v1alpha.json +24 -1
  123. googleapiclient/discovery_cache/documents/parametermanager.v1.json +982 -0
  124. googleapiclient/discovery_cache/documents/paymentsresellersubscription.v1.json +5 -5
  125. googleapiclient/discovery_cache/documents/recaptchaenterprise.v1.json +41 -5
  126. googleapiclient/discovery_cache/documents/redis.v1.json +166 -13
  127. googleapiclient/discovery_cache/documents/redis.v1beta1.json +166 -13
  128. googleapiclient/discovery_cache/documents/retail.v2.json +45 -2
  129. googleapiclient/discovery_cache/documents/retail.v2alpha.json +147 -2
  130. googleapiclient/discovery_cache/documents/retail.v2beta.json +45 -2
  131. googleapiclient/discovery_cache/documents/run.v1.json +2 -2
  132. googleapiclient/discovery_cache/documents/run.v2.json +19 -14
  133. googleapiclient/discovery_cache/documents/searchads360.v0.json +38 -4
  134. googleapiclient/discovery_cache/documents/searchconsole.v1.json +20 -1
  135. googleapiclient/discovery_cache/documents/secretmanager.v1.json +16 -1
  136. googleapiclient/discovery_cache/documents/secretmanager.v1beta1.json +16 -1
  137. googleapiclient/discovery_cache/documents/secretmanager.v1beta2.json +16 -1
  138. googleapiclient/discovery_cache/documents/securesourcemanager.v1.json +3568 -0
  139. googleapiclient/discovery_cache/documents/securitycenter.v1.json +290 -12
  140. googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json +287 -9
  141. googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json +287 -9
  142. googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1.json +5 -1
  143. googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1beta1.json +5 -1
  144. googleapiclient/discovery_cache/documents/servicenetworking.v1.json +22 -11
  145. googleapiclient/discovery_cache/documents/servicenetworking.v1beta.json +21 -10
  146. googleapiclient/discovery_cache/documents/serviceusage.v1.json +5 -1
  147. googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json +5 -1
  148. googleapiclient/discovery_cache/documents/spanner.v1.json +4 -4
  149. googleapiclient/discovery_cache/documents/storage.v1.json +71 -2
  150. googleapiclient/discovery_cache/documents/testing.v1.json +21 -5
  151. googleapiclient/discovery_cache/documents/texttospeech.v1.json +2 -2
  152. googleapiclient/discovery_cache/documents/texttospeech.v1beta1.json +2 -2
  153. googleapiclient/discovery_cache/documents/tpu.v2alpha1.json +2 -2
  154. googleapiclient/discovery_cache/documents/transcoder.v1.json +54 -1
  155. googleapiclient/discovery_cache/documents/videointelligence.v1.json +11 -11
  156. googleapiclient/discovery_cache/documents/videointelligence.v1beta2.json +11 -11
  157. googleapiclient/discovery_cache/documents/videointelligence.v1p1beta1.json +11 -11
  158. googleapiclient/discovery_cache/documents/videointelligence.v1p2beta1.json +11 -11
  159. googleapiclient/discovery_cache/documents/videointelligence.v1p3beta1.json +11 -11
  160. googleapiclient/discovery_cache/documents/vmmigration.v1.json +9 -4
  161. googleapiclient/discovery_cache/documents/vmmigration.v1alpha1.json +9 -4
  162. googleapiclient/discovery_cache/documents/workloadmanager.v1.json +45 -225
  163. googleapiclient/discovery_cache/documents/workspaceevents.v1.json +4 -4
  164. googleapiclient/discovery_cache/documents/workstations.v1beta.json +8 -3
  165. googleapiclient/discovery_cache/documents/youtube.v3.json +67 -1
  166. googleapiclient/version.py +1 -1
  167. {google_api_python_client-2.176.0.dist-info → google_api_python_client-2.178.0.dist-info}/WHEEL +0 -0
  168. {google_api_python_client-2.176.0.dist-info → google_api_python_client-2.178.0.dist-info}/licenses/LICENSE +0 -0
  169. {google_api_python_client-2.176.0.dist-info → google_api_python_client-2.178.0.dist-info}/top_level.txt +0 -0
@@ -38,6 +38,11 @@
38
38
  "description": "Regional Endpoint",
39
39
  "endpointUrl": "https://discoveryengine.eu.rep.googleapis.com/",
40
40
  "location": "eu"
41
+ },
42
+ {
43
+ "description": "Regional Endpoint",
44
+ "endpointUrl": "https://discoveryengine.in.rep.googleapis.com/",
45
+ "location": "in"
41
46
  }
42
47
  ],
43
48
  "fullyEncodeReservedExpansion": true,
@@ -132,45 +137,42 @@
132
137
  "resources": {
133
138
  "media": {
134
139
  "methods": {
135
- "upload": {
136
- "description": "Uploads a file for Notebook LM to use. Creates a Source.",
137
- "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/notebooks/{notebooksId}/sources:uploadFile",
138
- "httpMethod": "POST",
139
- "id": "discoveryengine.media.upload",
140
- "mediaUpload": {
141
- "accept": [
142
- "*/*"
143
- ],
144
- "protocols": {
145
- "simple": {
146
- "multipart": true,
147
- "path": "/upload/v1alpha/{+parent}/sources:uploadFile"
148
- }
149
- }
150
- },
140
+ "download": {
141
+ "description": "Downloads a file from the session.",
142
+ "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/sessions/{sessionsId}:downloadFile",
143
+ "httpMethod": "GET",
144
+ "id": "discoveryengine.media.download",
151
145
  "parameterOrder": [
152
- "parent"
146
+ "name"
153
147
  ],
154
148
  "parameters": {
155
- "parent": {
156
- "description": "Required. The parent resource where the sources will be created. Format: projects/{project}/locations/{location}/notebooks/{notebook}",
149
+ "fileId": {
150
+ "description": "Required. The ID of the file to be downloaded.",
151
+ "location": "query",
152
+ "type": "string"
153
+ },
154
+ "name": {
155
+ "description": "Required. The resource name of the Session. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}`",
157
156
  "location": "path",
158
- "pattern": "^projects/[^/]+/locations/[^/]+/notebooks/[^/]+$",
157
+ "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
159
158
  "required": true,
160
159
  "type": "string"
161
- }
162
160
  },
163
- "path": "v1alpha/{+parent}/sources:uploadFile",
164
- "request": {
165
- "$ref": "GoogleCloudNotebooklmV1alphaUploadSourceFileRequest"
161
+ "viewId": {
162
+ "description": "Optional. The ID of the view to be downloaded.",
163
+ "location": "query",
164
+ "type": "string"
165
+ }
166
166
  },
167
+ "path": "v1alpha/{+name}:downloadFile",
167
168
  "response": {
168
- "$ref": "GoogleCloudNotebooklmV1alphaUploadSourceFileResponse"
169
+ "$ref": "GdataMedia"
169
170
  },
170
171
  "scopes": [
171
172
  "https://www.googleapis.com/auth/cloud-platform"
172
173
  ],
173
- "supportsMediaUpload": true
174
+ "supportsMediaDownload": true,
175
+ "useMediaDownloadService": true
174
176
  }
175
177
  }
176
178
  },
@@ -816,6 +818,34 @@
816
818
  "resources": {
817
819
  "dataConnector": {
818
820
  "methods": {
821
+ "acquireAccessToken": {
822
+ "description": "Uses the per-user refresh token minted with AcquireAndStoreRefreshToken to generate and return a new access token and its details. Takes the access token from cache if available. Rotates the stored refresh token if needed. Uses the end user identity to return the user specific access token. Does *not* return the credentials configured by the administrator. Used by Agentspace action execution and Agentspace UI.",
823
+ "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataConnector:acquireAccessToken",
824
+ "httpMethod": "POST",
825
+ "id": "discoveryengine.projects.locations.collections.dataConnector.acquireAccessToken",
826
+ "parameterOrder": [
827
+ "name"
828
+ ],
829
+ "parameters": {
830
+ "name": {
831
+ "description": "Required. The resource name of the connector for which a token is queried.",
832
+ "location": "path",
833
+ "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataConnector$",
834
+ "required": true,
835
+ "type": "string"
836
+ }
837
+ },
838
+ "path": "v1alpha/{+name}:acquireAccessToken",
839
+ "request": {
840
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAcquireAccessTokenRequest"
841
+ },
842
+ "response": {
843
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAcquireAccessTokenResponse"
844
+ },
845
+ "scopes": [
846
+ "https://www.googleapis.com/auth/cloud-platform"
847
+ ]
848
+ },
819
849
  "getConnectorSecret": {
820
850
  "description": "Get the secret for the associated connector.",
821
851
  "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataConnector:getConnectorSecret",
@@ -2990,7 +3020,7 @@
2990
3020
  ],
2991
3021
  "parameters": {
2992
3022
  "filter": {
2993
- "description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
3023
+ "description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: * `user_pseudo_id = some_id` * `display_name = \"some_name\"` * `starred = true` * `is_pinned=true AND (NOT labels:hidden)` * `create_time > \"1970-01-01T12:00:00Z\"`",
2994
3024
  "location": "query",
2995
3025
  "type": "string"
2996
3026
  },
@@ -3914,6 +3944,11 @@
3914
3944
  "location": "query",
3915
3945
  "type": "boolean"
3916
3946
  },
3947
+ "getWidgetConfigRequestOption.turnOffCollectionComponents": {
3948
+ "description": "Optional. Whether to turn off collection_components in WidgetConfig to reduce latency and data transmission.",
3949
+ "location": "query",
3950
+ "type": "boolean"
3951
+ },
3917
3952
  "name": {
3918
3953
  "description": "Required. Full WidgetConfig resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/widgetConfigs/{widget_config_id}`",
3919
3954
  "location": "path",
@@ -4180,6 +4215,129 @@
4180
4215
  }
4181
4216
  },
4182
4217
  "resources": {
4218
+ "analytics": {
4219
+ "methods": {
4220
+ "exportMetrics": {
4221
+ "description": "Exports metrics.",
4222
+ "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/analytics:exportMetrics",
4223
+ "httpMethod": "POST",
4224
+ "id": "discoveryengine.projects.locations.collections.engines.analytics.exportMetrics",
4225
+ "parameterOrder": [
4226
+ "analytics"
4227
+ ],
4228
+ "parameters": {
4229
+ "analytics": {
4230
+ "description": "Required. The analytics resource name under the engine where the metrics are created. The format is `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/analytics`.",
4231
+ "location": "path",
4232
+ "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/analytics$",
4233
+ "required": true,
4234
+ "type": "string"
4235
+ }
4236
+ },
4237
+ "path": "v1alpha/{+analytics}:exportMetrics",
4238
+ "request": {
4239
+ "$ref": "GoogleCloudDiscoveryengineV1alphaExportMetricsRequest"
4240
+ },
4241
+ "response": {
4242
+ "$ref": "GoogleLongrunningOperation"
4243
+ },
4244
+ "scopes": [
4245
+ "https://www.googleapis.com/auth/cloud-platform"
4246
+ ]
4247
+ }
4248
+ }
4249
+ },
4250
+ "assistants": {
4251
+ "methods": {
4252
+ "get": {
4253
+ "description": "Gets an Assistant.",
4254
+ "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}",
4255
+ "httpMethod": "GET",
4256
+ "id": "discoveryengine.projects.locations.collections.engines.assistants.get",
4257
+ "parameterOrder": [
4258
+ "name"
4259
+ ],
4260
+ "parameters": {
4261
+ "name": {
4262
+ "description": "Required. Resource name of Assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`",
4263
+ "location": "path",
4264
+ "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
4265
+ "required": true,
4266
+ "type": "string"
4267
+ }
4268
+ },
4269
+ "path": "v1alpha/{+name}",
4270
+ "response": {
4271
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistant"
4272
+ },
4273
+ "scopes": [
4274
+ "https://www.googleapis.com/auth/cloud-platform"
4275
+ ]
4276
+ },
4277
+ "patch": {
4278
+ "description": "Updates an Assistant",
4279
+ "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}",
4280
+ "httpMethod": "PATCH",
4281
+ "id": "discoveryengine.projects.locations.collections.engines.assistants.patch",
4282
+ "parameterOrder": [
4283
+ "name"
4284
+ ],
4285
+ "parameters": {
4286
+ "name": {
4287
+ "description": "Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.",
4288
+ "location": "path",
4289
+ "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
4290
+ "required": true,
4291
+ "type": "string"
4292
+ },
4293
+ "updateMask": {
4294
+ "description": "The list of fields to update.",
4295
+ "format": "google-fieldmask",
4296
+ "location": "query",
4297
+ "type": "string"
4298
+ }
4299
+ },
4300
+ "path": "v1alpha/{+name}",
4301
+ "request": {
4302
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistant"
4303
+ },
4304
+ "response": {
4305
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistant"
4306
+ },
4307
+ "scopes": [
4308
+ "https://www.googleapis.com/auth/cloud-platform"
4309
+ ]
4310
+ },
4311
+ "streamAssist": {
4312
+ "description": "Assists the user with a query in a streaming fashion.",
4313
+ "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}:streamAssist",
4314
+ "httpMethod": "POST",
4315
+ "id": "discoveryengine.projects.locations.collections.engines.assistants.streamAssist",
4316
+ "parameterOrder": [
4317
+ "name"
4318
+ ],
4319
+ "parameters": {
4320
+ "name": {
4321
+ "description": "Required. The resource name of the Assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`",
4322
+ "location": "path",
4323
+ "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
4324
+ "required": true,
4325
+ "type": "string"
4326
+ }
4327
+ },
4328
+ "path": "v1alpha/{+name}:streamAssist",
4329
+ "request": {
4330
+ "$ref": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequest"
4331
+ },
4332
+ "response": {
4333
+ "$ref": "GoogleCloudDiscoveryengineV1alphaStreamAssistResponse"
4334
+ },
4335
+ "scopes": [
4336
+ "https://www.googleapis.com/auth/cloud-platform"
4337
+ ]
4338
+ }
4339
+ }
4340
+ },
4183
4341
  "completionConfig": {
4184
4342
  "methods": {
4185
4343
  "completeQuery": {
@@ -4997,7 +5155,7 @@
4997
5155
  ],
4998
5156
  "parameters": {
4999
5157
  "filter": {
5000
- "description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
5158
+ "description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: * `user_pseudo_id = some_id` * `display_name = \"some_name\"` * `starred = true` * `is_pinned=true AND (NOT labels:hidden)` * `create_time > \"1970-01-01T12:00:00Z\"`",
5001
5159
  "location": "query",
5002
5160
  "type": "string"
5003
5161
  },
@@ -5097,6 +5255,51 @@
5097
5255
  ]
5098
5256
  }
5099
5257
  }
5258
+ },
5259
+ "files": {
5260
+ "methods": {
5261
+ "list": {
5262
+ "description": "Lists metadata for all files in the current session.",
5263
+ "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/sessions/{sessionsId}/files",
5264
+ "httpMethod": "GET",
5265
+ "id": "discoveryengine.projects.locations.collections.engines.sessions.files.list",
5266
+ "parameterOrder": [
5267
+ "parent"
5268
+ ],
5269
+ "parameters": {
5270
+ "filter": {
5271
+ "description": "Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the files being filtered. Filter expression is case-sensitive. Currently supported field names are: * upload_time * last_add_time * last_use_time * file_name * mime_type Some examples of filters would be: * \"file_name = 'file_1'\" * \"file_name = 'file_1' AND mime_type = 'text/plain'\" * \"last_use_time > '2025-06-14T12:00:00Z'\" For a full description of the filter format, please see https://google.aip.dev/160.",
5272
+ "location": "query",
5273
+ "type": "string"
5274
+ },
5275
+ "pageSize": {
5276
+ "description": "Optional. The maximum number of files to return. The service may return fewer than this value. If unspecified, at most 100 files will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. If user specifies a value less than or equal to 0 - the request will be rejected with an INVALID_ARGUMENT error.",
5277
+ "format": "int32",
5278
+ "location": "query",
5279
+ "type": "integer"
5280
+ },
5281
+ "pageToken": {
5282
+ "description": "Optional. A page token received from a previous `ListFiles` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListFiles` must match the call that provided the page token (except `page_size`, which may differ).",
5283
+ "location": "query",
5284
+ "type": "string"
5285
+ },
5286
+ "parent": {
5287
+ "description": "Required. The resource name of the Session. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}` Name of the session resource to which the file belong.",
5288
+ "location": "path",
5289
+ "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
5290
+ "required": true,
5291
+ "type": "string"
5292
+ }
5293
+ },
5294
+ "path": "v1alpha/{+parent}/files",
5295
+ "response": {
5296
+ "$ref": "GoogleCloudDiscoveryengineV1alphaListFilesResponse"
5297
+ },
5298
+ "scopes": [
5299
+ "https://www.googleapis.com/auth/cloud-platform"
5300
+ ]
5301
+ }
5302
+ }
5100
5303
  }
5101
5304
  }
5102
5305
  },
@@ -5116,6 +5319,11 @@
5116
5319
  "location": "query",
5117
5320
  "type": "boolean"
5118
5321
  },
5322
+ "getWidgetConfigRequestOption.turnOffCollectionComponents": {
5323
+ "description": "Optional. Whether to turn off collection_components in WidgetConfig to reduce latency and data transmission.",
5324
+ "location": "query",
5325
+ "type": "boolean"
5326
+ },
5119
5327
  "name": {
5120
5328
  "description": "Required. Full WidgetConfig resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/widgetConfigs/{widget_config_id}`",
5121
5329
  "location": "path",
@@ -7086,7 +7294,7 @@
7086
7294
  ],
7087
7295
  "parameters": {
7088
7296
  "filter": {
7089
- "description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
7297
+ "description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: * `user_pseudo_id = some_id` * `display_name = \"some_name\"` * `starred = true` * `is_pinned=true AND (NOT labels:hidden)` * `create_time > \"1970-01-01T12:00:00Z\"`",
7090
7298
  "location": "query",
7091
7299
  "type": "string"
7092
7300
  },
@@ -7751,6 +7959,11 @@
7751
7959
  "location": "query",
7752
7960
  "type": "boolean"
7753
7961
  },
7962
+ "getWidgetConfigRequestOption.turnOffCollectionComponents": {
7963
+ "description": "Optional. Whether to turn off collection_components in WidgetConfig to reduce latency and data transmission.",
7964
+ "location": "query",
7965
+ "type": "boolean"
7966
+ },
7754
7967
  "name": {
7755
7968
  "description": "Required. Full WidgetConfig resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/widgetConfigs/{widget_config_id}`",
7756
7969
  "location": "path",
@@ -8261,9 +8474,75 @@
8261
8474
  }
8262
8475
  },
8263
8476
  "notebooks": {
8477
+ "methods": {
8478
+ "listRecentlyViewed": {
8479
+ "description": "Lists the recently viewed notebooks. Needs a side channel with the user's EUC.",
8480
+ "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/notebooks:listRecentlyViewed",
8481
+ "httpMethod": "GET",
8482
+ "id": "discoveryengine.projects.locations.notebooks.listRecentlyViewed",
8483
+ "parameterOrder": [
8484
+ "parent"
8485
+ ],
8486
+ "parameters": {
8487
+ "pageSize": {
8488
+ "description": "Optional. Maximum number of Notebooks to return. If unspecified, defaults to \"200\". The maximum allowed value is \"500\". If this field is negative, will use the default value.",
8489
+ "format": "int32",
8490
+ "location": "query",
8491
+ "type": "integer"
8492
+ },
8493
+ "pageToken": {
8494
+ "description": "Optional. The page token, provide this to retrieve the subsequent page.",
8495
+ "location": "query",
8496
+ "type": "string"
8497
+ },
8498
+ "parent": {
8499
+ "description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}`.",
8500
+ "location": "path",
8501
+ "pattern": "^projects/[^/]+/locations/[^/]+$",
8502
+ "required": true,
8503
+ "type": "string"
8504
+ }
8505
+ },
8506
+ "path": "v1alpha/{+parent}/notebooks:listRecentlyViewed",
8507
+ "response": {
8508
+ "$ref": "GoogleCloudNotebooklmV1alphaListRecentlyViewedNotebooksResponse"
8509
+ },
8510
+ "scopes": [
8511
+ "https://www.googleapis.com/auth/cloud-platform"
8512
+ ]
8513
+ }
8514
+ },
8264
8515
  "resources": {
8265
8516
  "sources": {
8266
8517
  "methods": {
8518
+ "batchCreate": {
8519
+ "description": "Creates a list of Sources.",
8520
+ "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/notebooks/{notebooksId}/sources:batchCreate",
8521
+ "httpMethod": "POST",
8522
+ "id": "discoveryengine.projects.locations.notebooks.sources.batchCreate",
8523
+ "parameterOrder": [
8524
+ "parent"
8525
+ ],
8526
+ "parameters": {
8527
+ "parent": {
8528
+ "description": "Required. The parent resource where the sources will be created. Format: projects/{project}/locations/{location}/notebooks/{notebook}",
8529
+ "location": "path",
8530
+ "pattern": "^projects/[^/]+/locations/[^/]+/notebooks/[^/]+$",
8531
+ "required": true,
8532
+ "type": "string"
8533
+ }
8534
+ },
8535
+ "path": "v1alpha/{+parent}/sources:batchCreate",
8536
+ "request": {
8537
+ "$ref": "GoogleCloudNotebooklmV1alphaBatchCreateSourcesRequest"
8538
+ },
8539
+ "response": {
8540
+ "$ref": "GoogleCloudNotebooklmV1alphaBatchCreateSourcesResponse"
8541
+ },
8542
+ "scopes": [
8543
+ "https://www.googleapis.com/auth/cloud-platform"
8544
+ ]
8545
+ },
8267
8546
  "uploadFile": {
8268
8547
  "description": "Uploads a file for Notebook LM to use. Creates a Source.",
8269
8548
  "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/notebooks/{notebooksId}/sources/{sourceId}:uploadFile",
@@ -9173,7 +9452,7 @@
9173
9452
  }
9174
9453
  }
9175
9454
  },
9176
- "revision": "20250701",
9455
+ "revision": "20250728",
9177
9456
  "rootUrl": "https://discoveryengine.googleapis.com/",
9178
9457
  "schemas": {
9179
9458
  "ApiservingMediaRequestInfo": {
@@ -10250,6 +10529,17 @@
10250
10529
  },
10251
10530
  "type": "object"
10252
10531
  },
10532
+ "GoogleCloudDiscoveryengineV1Assistant": {
10533
+ "description": "Discovery Engine Assistant resource.",
10534
+ "id": "GoogleCloudDiscoveryengineV1Assistant",
10535
+ "properties": {
10536
+ "name": {
10537
+ "description": "Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.",
10538
+ "type": "string"
10539
+ }
10540
+ },
10541
+ "type": "object"
10542
+ },
10253
10543
  "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata": {
10254
10544
  "description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.",
10255
10545
  "id": "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata",
@@ -10339,11 +10629,12 @@
10339
10629
  "type": "boolean"
10340
10630
  },
10341
10631
  "kmsKey": {
10342
- "description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
10632
+ "description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
10343
10633
  "type": "string"
10344
10634
  },
10345
10635
  "kmsKeyVersion": {
10346
- "description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
10636
+ "description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
10637
+ "readOnly": true,
10347
10638
  "type": "string"
10348
10639
  },
10349
10640
  "lastRotationTimestampMicros": {
@@ -11185,6 +11476,10 @@
11185
11476
  "description": "The layout parsing configurations for documents.",
11186
11477
  "id": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigLayoutParsingConfig",
11187
11478
  "properties": {
11479
+ "enableGetProcessedDocument": {
11480
+ "description": "Optional. If true, the processed document will be made available for the GetProcessedDocument API.",
11481
+ "type": "boolean"
11482
+ },
11188
11483
  "enableImageAnnotation": {
11189
11484
  "description": "Optional. If true, the LLM based annotation is added to the image during parsing.",
11190
11485
  "type": "boolean"
@@ -11318,7 +11613,7 @@
11318
11613
  ],
11319
11614
  "type": "string"
11320
11615
  },
11321
- "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing`",
11616
+ "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.",
11322
11617
  "type": "object"
11323
11618
  },
11324
11619
  "industryVertical": {
@@ -12718,14 +13013,16 @@
12718
13013
  "ASSIGNED",
12719
13014
  "UNASSIGNED",
12720
13015
  "NO_LICENSE",
12721
- "NO_LICENSE_ATTEMPTED_LOGIN"
13016
+ "NO_LICENSE_ATTEMPTED_LOGIN",
13017
+ "BLOCKED"
12722
13018
  ],
12723
13019
  "enumDescriptions": [
12724
13020
  "Default value.",
12725
13021
  "License assigned to the user.",
12726
13022
  "No license assigned to the user. Deprecated, translated to NO_LICENSE.",
12727
13023
  "No license assigned to the user.",
12728
- "User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin)."
13024
+ "User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin).",
13025
+ "User is blocked from assigning a license."
12729
13026
  ],
12730
13027
  "readOnly": true,
12731
13028
  "type": "string"
@@ -12811,6 +13108,27 @@
12811
13108
  },
12812
13109
  "type": "object"
12813
13110
  },
13111
+ "GoogleCloudDiscoveryengineV1alphaAcquireAccessTokenRequest": {
13112
+ "description": "Request message for the DataConnectorService.AcquireAccessToken method.",
13113
+ "id": "GoogleCloudDiscoveryengineV1alphaAcquireAccessTokenRequest",
13114
+ "properties": {},
13115
+ "type": "object"
13116
+ },
13117
+ "GoogleCloudDiscoveryengineV1alphaAcquireAccessTokenResponse": {
13118
+ "description": "Response message for the DataConnectorService.AcquireAccessToken method.",
13119
+ "id": "GoogleCloudDiscoveryengineV1alphaAcquireAccessTokenResponse",
13120
+ "properties": {
13121
+ "accessToken": {
13122
+ "description": "The created access token.",
13123
+ "type": "string"
13124
+ },
13125
+ "refreshTokenInfo": {
13126
+ "$ref": "GoogleCloudDiscoveryengineV1alphaRefreshTokenInfo",
13127
+ "description": "Info about the stored refresh token used to create the access token."
13128
+ }
13129
+ },
13130
+ "type": "object"
13131
+ },
12814
13132
  "GoogleCloudDiscoveryengineV1alphaActionConfig": {
12815
13133
  "description": "Informations to support actions on the connector.",
12816
13134
  "id": "GoogleCloudDiscoveryengineV1alphaActionConfig",
@@ -14539,9 +14857,315 @@
14539
14857
  },
14540
14858
  "type": "object"
14541
14859
  },
14542
- "GoogleCloudDiscoveryengineV1alphaBAPConfig": {
14543
- "description": "The configuration for the BAP connector.",
14544
- "id": "GoogleCloudDiscoveryengineV1alphaBAPConfig",
14860
+ "GoogleCloudDiscoveryengineV1alphaAssistAnswer": {
14861
+ "description": "AssistAnswer resource, main part of AssistResponse.",
14862
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistAnswer",
14863
+ "properties": {
14864
+ "assistSkippedReasons": {
14865
+ "description": "Reasons for not answering the assist call.",
14866
+ "items": {
14867
+ "enum": [
14868
+ "ASSIST_SKIPPED_REASON_UNSPECIFIED",
14869
+ "NON_ASSIST_SEEKING_QUERY_IGNORED",
14870
+ "CUSTOMER_POLICY_VIOLATION"
14871
+ ],
14872
+ "enumDescriptions": [
14873
+ "Default value. Skip reason is not specified.",
14874
+ "The assistant ignored the query, because it did not appear to be answer-seeking.",
14875
+ "The assistant ignored the query or refused to answer because of a customer policy violation (e.g., the query or the answer contained a banned phrase)."
14876
+ ],
14877
+ "type": "string"
14878
+ },
14879
+ "type": "array"
14880
+ },
14881
+ "name": {
14882
+ "description": "Immutable. Identifier. Resource name of the `AssistAnswer`. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/assistAnswers/{assist_answer}` This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
14883
+ "type": "string"
14884
+ },
14885
+ "replies": {
14886
+ "description": "Replies of the assistant.",
14887
+ "items": {
14888
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistAnswerReply"
14889
+ },
14890
+ "type": "array"
14891
+ },
14892
+ "state": {
14893
+ "description": "State of the answer generation.",
14894
+ "enum": [
14895
+ "STATE_UNSPECIFIED",
14896
+ "IN_PROGRESS",
14897
+ "FAILED",
14898
+ "SUCCEEDED",
14899
+ "SKIPPED"
14900
+ ],
14901
+ "enumDescriptions": [
14902
+ "Unknown.",
14903
+ "Assist operation is currently in progress.",
14904
+ "Assist operation has failed.",
14905
+ "Assist operation has succeeded.",
14906
+ "Assist operation has been skipped."
14907
+ ],
14908
+ "type": "string"
14909
+ }
14910
+ },
14911
+ "type": "object"
14912
+ },
14913
+ "GoogleCloudDiscoveryengineV1alphaAssistAnswerReply": {
14914
+ "description": "One part of the multi-part response of the assist call.",
14915
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistAnswerReply",
14916
+ "properties": {
14917
+ "groundedContent": {
14918
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContent",
14919
+ "description": "Possibly grounded response text or media from the assistant."
14920
+ }
14921
+ },
14922
+ "type": "object"
14923
+ },
14924
+ "GoogleCloudDiscoveryengineV1alphaAssistUserMetadata": {
14925
+ "description": "User metadata of the request.",
14926
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistUserMetadata",
14927
+ "properties": {
14928
+ "preferredLanguageCode": {
14929
+ "description": "Optional. Preferred language to be used for answering if language detection fails. Also used as the language of error messages created by actions, regardless of language detection results.",
14930
+ "type": "string"
14931
+ },
14932
+ "timeZone": {
14933
+ "description": "Optional. IANA time zone, e.g. Europe/Budapest.",
14934
+ "type": "string"
14935
+ }
14936
+ },
14937
+ "type": "object"
14938
+ },
14939
+ "GoogleCloudDiscoveryengineV1alphaAssistant": {
14940
+ "description": "Discovery Engine Assistant resource.",
14941
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistant",
14942
+ "properties": {
14943
+ "name": {
14944
+ "description": "Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.",
14945
+ "type": "string"
14946
+ }
14947
+ },
14948
+ "type": "object"
14949
+ },
14950
+ "GoogleCloudDiscoveryengineV1alphaAssistantContent": {
14951
+ "description": "Multi-modal content.",
14952
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistantContent",
14953
+ "properties": {
14954
+ "codeExecutionResult": {
14955
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistantContentCodeExecutionResult",
14956
+ "description": "Result of executing an ExecutableCode."
14957
+ },
14958
+ "executableCode": {
14959
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistantContentExecutableCode",
14960
+ "description": "Code generated by the model that is meant to be executed."
14961
+ },
14962
+ "file": {
14963
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistantContentFile",
14964
+ "description": "A file, e.g., an audio summary."
14965
+ },
14966
+ "inlineData": {
14967
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistantContentBlob",
14968
+ "description": "Inline binary data."
14969
+ },
14970
+ "role": {
14971
+ "description": "The producer of the content. Can be \"model\" or \"user\".",
14972
+ "type": "string"
14973
+ },
14974
+ "text": {
14975
+ "description": "Inline text.",
14976
+ "type": "string"
14977
+ },
14978
+ "thought": {
14979
+ "description": "Optional. Indicates if the part is thought from the model.",
14980
+ "type": "boolean"
14981
+ }
14982
+ },
14983
+ "type": "object"
14984
+ },
14985
+ "GoogleCloudDiscoveryengineV1alphaAssistantContentBlob": {
14986
+ "description": "Inline blob.",
14987
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistantContentBlob",
14988
+ "properties": {
14989
+ "data": {
14990
+ "description": "Required. Raw bytes.",
14991
+ "format": "byte",
14992
+ "type": "string"
14993
+ },
14994
+ "mimeType": {
14995
+ "description": "Required. The media type (MIME type) of the generated data.",
14996
+ "type": "string"
14997
+ }
14998
+ },
14999
+ "type": "object"
15000
+ },
15001
+ "GoogleCloudDiscoveryengineV1alphaAssistantContentCodeExecutionResult": {
15002
+ "description": "Result of executing ExecutableCode.",
15003
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistantContentCodeExecutionResult",
15004
+ "properties": {
15005
+ "outcome": {
15006
+ "description": "Required. Outcome of the code execution.",
15007
+ "enum": [
15008
+ "OUTCOME_UNSPECIFIED",
15009
+ "OUTCOME_OK",
15010
+ "OUTCOME_FAILED",
15011
+ "OUTCOME_DEADLINE_EXCEEDED"
15012
+ ],
15013
+ "enumDescriptions": [
15014
+ "Unspecified status. This value should not be used.",
15015
+ "Code execution completed successfully.",
15016
+ "Code execution finished but with a failure. `stderr` should contain the reason.",
15017
+ "Code execution ran for too long, and was cancelled. There may or may not be a partial output present."
15018
+ ],
15019
+ "type": "string"
15020
+ },
15021
+ "output": {
15022
+ "description": "Optional. Contains stdout when code execution is successful, stderr or other description otherwise.",
15023
+ "type": "string"
15024
+ }
15025
+ },
15026
+ "type": "object"
15027
+ },
15028
+ "GoogleCloudDiscoveryengineV1alphaAssistantContentExecutableCode": {
15029
+ "description": "Code generated by the model that is meant to be executed by the model.",
15030
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistantContentExecutableCode",
15031
+ "properties": {
15032
+ "code": {
15033
+ "description": "Required. The code content. Currently only supports Python.",
15034
+ "type": "string"
15035
+ }
15036
+ },
15037
+ "type": "object"
15038
+ },
15039
+ "GoogleCloudDiscoveryengineV1alphaAssistantContentFile": {
15040
+ "description": "A file, e.g., an audio summary.",
15041
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistantContentFile",
15042
+ "properties": {
15043
+ "fileId": {
15044
+ "description": "Required. The file ID.",
15045
+ "type": "string"
15046
+ },
15047
+ "mimeType": {
15048
+ "description": "Required. The media type (MIME type) of the file.",
15049
+ "type": "string"
15050
+ }
15051
+ },
15052
+ "type": "object"
15053
+ },
15054
+ "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContent": {
15055
+ "description": "A piece of content and possibly its grounding information. Not all content needs grounding. Phrases like \"Of course, I will gladly search it for you.\" do not need grounding.",
15056
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContent",
15057
+ "properties": {
15058
+ "content": {
15059
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistantContent",
15060
+ "description": "The content."
15061
+ },
15062
+ "textGroundingMetadata": {
15063
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadata",
15064
+ "description": "Metadata for grounding based on text sources."
15065
+ }
15066
+ },
15067
+ "type": "object"
15068
+ },
15069
+ "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadata": {
15070
+ "description": "Grounding details for text sources.",
15071
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadata",
15072
+ "properties": {
15073
+ "references": {
15074
+ "description": "References for the grounded text.",
15075
+ "items": {
15076
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadataReference"
15077
+ },
15078
+ "type": "array"
15079
+ },
15080
+ "segments": {
15081
+ "description": "Grounding information for parts of the text.",
15082
+ "items": {
15083
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadataSegment"
15084
+ },
15085
+ "type": "array"
15086
+ }
15087
+ },
15088
+ "type": "object"
15089
+ },
15090
+ "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadataReference": {
15091
+ "description": "Referenced content and related document metadata.",
15092
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadataReference",
15093
+ "properties": {
15094
+ "content": {
15095
+ "description": "Referenced text content.",
15096
+ "type": "string"
15097
+ },
15098
+ "documentMetadata": {
15099
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadataReferenceDocumentMetadata",
15100
+ "description": "Document metadata."
15101
+ }
15102
+ },
15103
+ "type": "object"
15104
+ },
15105
+ "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadataReferenceDocumentMetadata": {
15106
+ "description": "Document metadata.",
15107
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadataReferenceDocumentMetadata",
15108
+ "properties": {
15109
+ "document": {
15110
+ "description": "Document resource name.",
15111
+ "type": "string"
15112
+ },
15113
+ "domain": {
15114
+ "description": "Domain name from the document URI. Note that the `uri` field may contain a URL that redirects to the actual website, in which case this will contain the domain name of the target site.",
15115
+ "type": "string"
15116
+ },
15117
+ "pageIdentifier": {
15118
+ "description": "Page identifier.",
15119
+ "type": "string"
15120
+ },
15121
+ "title": {
15122
+ "description": "Title.",
15123
+ "type": "string"
15124
+ },
15125
+ "uri": {
15126
+ "description": "URI for the document. It may contain a URL that redirects to the actual website.",
15127
+ "type": "string"
15128
+ }
15129
+ },
15130
+ "type": "object"
15131
+ },
15132
+ "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadataSegment": {
15133
+ "description": "Grounding information for a segment of the text.",
15134
+ "id": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetadataSegment",
15135
+ "properties": {
15136
+ "endIndex": {
15137
+ "description": "End of the segment, exclusive.",
15138
+ "format": "int64",
15139
+ "type": "string"
15140
+ },
15141
+ "groundingScore": {
15142
+ "description": "Score for the segment.",
15143
+ "format": "float",
15144
+ "type": "number"
15145
+ },
15146
+ "referenceIndices": {
15147
+ "description": "References for the segment.",
15148
+ "items": {
15149
+ "format": "int32",
15150
+ "type": "integer"
15151
+ },
15152
+ "type": "array"
15153
+ },
15154
+ "startIndex": {
15155
+ "description": "Zero-based index indicating the start of the segment, measured in bytes of a UTF-8 string (i.e. characters encoded on multiple bytes have a length of more than one).",
15156
+ "format": "int64",
15157
+ "type": "string"
15158
+ },
15159
+ "text": {
15160
+ "description": "The text segment itself.",
15161
+ "type": "string"
15162
+ }
15163
+ },
15164
+ "type": "object"
15165
+ },
15166
+ "GoogleCloudDiscoveryengineV1alphaBAPConfig": {
15167
+ "description": "The configuration for the BAP connector.",
15168
+ "id": "GoogleCloudDiscoveryengineV1alphaBAPConfig",
14545
15169
  "properties": {
14546
15170
  "supportedConnectorModes": {
14547
15171
  "description": "Required. The supported connector modes for the associated BAP connection.",
@@ -14763,6 +15387,21 @@
14763
15387
  "properties": {},
14764
15388
  "type": "object"
14765
15389
  },
15390
+ "GoogleCloudDiscoveryengineV1alphaBigQueryDestination": {
15391
+ "description": "The BigQuery output destination configuration.",
15392
+ "id": "GoogleCloudDiscoveryengineV1alphaBigQueryDestination",
15393
+ "properties": {
15394
+ "datasetId": {
15395
+ "description": "Required. The ID of a BigQuery Dataset.",
15396
+ "type": "string"
15397
+ },
15398
+ "tableId": {
15399
+ "description": "Required. The table_id of exported BigQuery table.",
15400
+ "type": "string"
15401
+ }
15402
+ },
15403
+ "type": "object"
15404
+ },
14766
15405
  "GoogleCloudDiscoveryengineV1alphaBigQuerySource": {
14767
15406
  "description": "BigQuery source import data from.",
14768
15407
  "id": "GoogleCloudDiscoveryengineV1alphaBigQuerySource",
@@ -15368,11 +16007,12 @@
15368
16007
  "type": "boolean"
15369
16008
  },
15370
16009
  "kmsKey": {
15371
- "description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
16010
+ "description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
15372
16011
  "type": "string"
15373
16012
  },
15374
16013
  "kmsKeyVersion": {
15375
- "description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
16014
+ "description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
16015
+ "readOnly": true,
15376
16016
  "type": "string"
15377
16017
  },
15378
16018
  "lastRotationTimestampMicros": {
@@ -16743,14 +17383,12 @@
16743
17383
  "enum": [
16744
17384
  "PERIODIC",
16745
17385
  "STREAMING",
16746
- "UNSPECIFIED",
16747
- "SCALA_SYNC"
17386
+ "UNSPECIFIED"
16748
17387
  ],
16749
17388
  "enumDescriptions": [
16750
17389
  "The connector will sync data periodically based on the refresh_interval. Use it with auto_run_disabled to pause the periodic sync, or indicate a one-time sync.",
16751
17390
  "The data will be synced in real time.",
16752
- "Connector that doesn't ingest data will have this value",
16753
- "The data will be synced with Scala Sync, a data ingestion solution."
17391
+ "Connector that doesn't ingest data will have this value"
16754
17392
  ],
16755
17393
  "type": "string"
16756
17394
  },
@@ -16798,6 +17436,10 @@
16798
17436
  "description": "Optional. The ID of the Secret Manager secret used for webhook secret.",
16799
17437
  "type": "string"
16800
17438
  },
17439
+ "streamingError": {
17440
+ "$ref": "GoogleCloudDiscoveryengineV1alphaDataConnectorRealtimeSyncConfigStreamingError",
17441
+ "description": "Optional. Streaming error details."
17442
+ },
16801
17443
  "webhookUri": {
16802
17444
  "description": "Optional. Webhook url for the connector to specify additional params for realtime sync.",
16803
17445
  "type": "string"
@@ -16805,6 +17447,33 @@
16805
17447
  },
16806
17448
  "type": "object"
16807
17449
  },
17450
+ "GoogleCloudDiscoveryengineV1alphaDataConnectorRealtimeSyncConfigStreamingError": {
17451
+ "description": "Streaming error details.",
17452
+ "id": "GoogleCloudDiscoveryengineV1alphaDataConnectorRealtimeSyncConfigStreamingError",
17453
+ "properties": {
17454
+ "error": {
17455
+ "$ref": "GoogleRpcStatus",
17456
+ "description": "Optional. Error details."
17457
+ },
17458
+ "streamingErrorReason": {
17459
+ "description": "Optional. Streaming error.",
17460
+ "enum": [
17461
+ "STREAMING_ERROR_REASON_UNSPECIFIED",
17462
+ "STREAMING_SETUP_ERROR",
17463
+ "STREAMING_SYNC_ERROR",
17464
+ "INGRESS_ENDPOINT_REQUIRED"
17465
+ ],
17466
+ "enumDescriptions": [
17467
+ "Streaming error reason unspecified.",
17468
+ "Some error occurred while setting up resources for realtime sync.",
17469
+ "Some error was encountered while running realtime sync for the connector.",
17470
+ "Ingress endpoint is required when setting up realtime sync in private connectivity."
17471
+ ],
17472
+ "type": "string"
17473
+ }
17474
+ },
17475
+ "type": "object"
17476
+ },
16808
17477
  "GoogleCloudDiscoveryengineV1alphaDataConnectorSourceEntity": {
16809
17478
  "description": "Represents an entity in the data source. For example, the `Account` object in Salesforce.",
16810
17479
  "id": "GoogleCloudDiscoveryengineV1alphaDataConnectorSourceEntity",
@@ -17538,6 +18207,10 @@
17538
18207
  "description": "The layout parsing configurations for documents.",
17539
18208
  "id": "GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfigLayoutParsingConfig",
17540
18209
  "properties": {
18210
+ "enableGetProcessedDocument": {
18211
+ "description": "Optional. If true, the processed document will be made available for the GetProcessedDocument API.",
18212
+ "type": "boolean"
18213
+ },
17541
18214
  "enableImageAnnotation": {
17542
18215
  "description": "Optional. If true, the LLM based annotation is added to the image during parsing.",
17543
18216
  "type": "boolean"
@@ -17703,7 +18376,7 @@
17703
18376
  ],
17704
18377
  "type": "string"
17705
18378
  },
17706
- "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing`",
18379
+ "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.",
17707
18380
  "type": "object"
17708
18381
  },
17709
18382
  "industryVertical": {
@@ -18205,6 +18878,40 @@
18205
18878
  },
18206
18879
  "type": "object"
18207
18880
  },
18881
+ "GoogleCloudDiscoveryengineV1alphaExportMetricsMetadata": {
18882
+ "description": "Metadata related to the progress of the Export operation. This is returned by the google.longrunning.Operation.metadata field.",
18883
+ "id": "GoogleCloudDiscoveryengineV1alphaExportMetricsMetadata",
18884
+ "properties": {
18885
+ "createTime": {
18886
+ "description": "Operation create time.",
18887
+ "format": "google-datetime",
18888
+ "type": "string"
18889
+ },
18890
+ "updateTime": {
18891
+ "description": "Operation last update time. If the operation is done, this is also the finish time.",
18892
+ "format": "google-datetime",
18893
+ "type": "string"
18894
+ }
18895
+ },
18896
+ "type": "object"
18897
+ },
18898
+ "GoogleCloudDiscoveryengineV1alphaExportMetricsRequest": {
18899
+ "description": "Request message for the `ExportMetrics` method.",
18900
+ "id": "GoogleCloudDiscoveryengineV1alphaExportMetricsRequest",
18901
+ "properties": {
18902
+ "outputConfig": {
18903
+ "$ref": "GoogleCloudDiscoveryengineV1alphaOutputConfig",
18904
+ "description": "Required. The output location of the data."
18905
+ }
18906
+ },
18907
+ "type": "object"
18908
+ },
18909
+ "GoogleCloudDiscoveryengineV1alphaExportMetricsResponse": {
18910
+ "description": "Response of the ExportMetricsRequest. If the long running operation was successful, then this message is returned by the google.longrunning.Operations.response field.",
18911
+ "id": "GoogleCloudDiscoveryengineV1alphaExportMetricsResponse",
18912
+ "properties": {},
18913
+ "type": "object"
18914
+ },
18208
18915
  "GoogleCloudDiscoveryengineV1alphaFactChunk": {
18209
18916
  "description": "Fact Chunk.",
18210
18917
  "id": "GoogleCloudDiscoveryengineV1alphaFactChunk",
@@ -18475,6 +19182,169 @@
18475
19182
  },
18476
19183
  "type": "object"
18477
19184
  },
19185
+ "GoogleCloudDiscoveryengineV1alphaFileCharacteristics": {
19186
+ "description": "Caracteristics of other file types.",
19187
+ "id": "GoogleCloudDiscoveryengineV1alphaFileCharacteristics",
19188
+ "properties": {
19189
+ "characteristics": {
19190
+ "additionalProperties": {
19191
+ "type": "string"
19192
+ },
19193
+ "description": "Output only. Generic map of characteristics.",
19194
+ "readOnly": true,
19195
+ "type": "object"
19196
+ }
19197
+ },
19198
+ "type": "object"
19199
+ },
19200
+ "GoogleCloudDiscoveryengineV1alphaFileMetadata": {
19201
+ "description": "Represents a file attached to a session (context file)",
19202
+ "id": "GoogleCloudDiscoveryengineV1alphaFileMetadata",
19203
+ "properties": {
19204
+ "byteSize": {
19205
+ "description": "Output only. The size of the context file in bytes.",
19206
+ "format": "int64",
19207
+ "readOnly": true,
19208
+ "type": "string"
19209
+ },
19210
+ "downloadUri": {
19211
+ "description": "Output only. The AssistantService.DownloadSessionFile URL to download the file. This URL will need the same credentials as AssistantService.ListSessionFileMetadata method and will provide the resource.",
19212
+ "readOnly": true,
19213
+ "type": "string"
19214
+ },
19215
+ "fileId": {
19216
+ "description": "Output only. The ID of the file.",
19217
+ "readOnly": true,
19218
+ "type": "string"
19219
+ },
19220
+ "fileOriginType": {
19221
+ "description": "Optional. The origin of the file.",
19222
+ "enum": [
19223
+ "FILE_ORIGIN_TYPE_UNSPECIFIED",
19224
+ "USER_PROVIDED",
19225
+ "AI_GENERATED",
19226
+ "INTERNALLY_GENERATED"
19227
+ ],
19228
+ "enumDescriptions": [
19229
+ "Default value.",
19230
+ "The file was provided by the user.",
19231
+ "The file was generated by an AI model.",
19232
+ "The file was generated from other files by an internal process."
19233
+ ],
19234
+ "type": "string"
19235
+ },
19236
+ "lastAddTime": {
19237
+ "description": "Output only. The time the file was added to the session. Note that if a file was added, then modified externally, then added again, the add time will be updated.",
19238
+ "format": "google-datetime",
19239
+ "readOnly": true,
19240
+ "type": "string"
19241
+ },
19242
+ "metadata": {
19243
+ "additionalProperties": {
19244
+ "type": "string"
19245
+ },
19246
+ "description": "Optional. Represents metadata related to the file that can suit particular use cases. The prefix \"google.\" is reserved for the key for use by Google, but other prefixes can be freely used.",
19247
+ "type": "object"
19248
+ },
19249
+ "mimeType": {
19250
+ "description": "The content type of the file, see https://www.iana.org/assignments/media-types/media-types.xhtml.",
19251
+ "type": "string"
19252
+ },
19253
+ "name": {
19254
+ "description": "Output only. The name of the file uploaded.",
19255
+ "readOnly": true,
19256
+ "type": "string"
19257
+ },
19258
+ "originalSourceType": {
19259
+ "description": "Optional. The type of the original source of the file.",
19260
+ "enum": [
19261
+ "FILE_SOURCE_UNSPECIFIED",
19262
+ "FILE_SOURCE_INLINE",
19263
+ "FILE_SOURCE_LOCAL",
19264
+ "FILE_SOURCE_CLOUD_STORAGE",
19265
+ "FILE_SOURCE_CLOUD_DRIVE",
19266
+ "FILE_SOURCE_URL"
19267
+ ],
19268
+ "enumDescriptions": [
19269
+ "Default value. Unknown source.",
19270
+ "The data of the file was provided inline (e.g. pasted from the clipboard).",
19271
+ "The file was uploaded from a local file.",
19272
+ "The file was uploaded from Cloud Storage.",
19273
+ "The file was uploaded from Drive.",
19274
+ "The file was retrieved from a URL (e.g. public web)."
19275
+ ],
19276
+ "type": "string"
19277
+ },
19278
+ "originalUri": {
19279
+ "description": "Optional. The original location of the file. It may be a local file path, or any other URI that allows accessing the file in an external system. There are two scenarios in which this url may be empty: 1. If the file was sent as inline data (e.g. pasted from the clipboard). 2. If the original location is not available. Note that there's no guarantee that the URI will be pointing to a valid or actually existing file. For example, a file might have been uploaded to the session, and then deleted from the original source.",
19280
+ "type": "string"
19281
+ },
19282
+ "uploadTime": {
19283
+ "description": "Output only. The time the file was uploaded (If this is a file generated by an internal process and then made available to the session, this indicates the moment it happened).",
19284
+ "format": "google-datetime",
19285
+ "readOnly": true,
19286
+ "type": "string"
19287
+ },
19288
+ "views": {
19289
+ "additionalProperties": {
19290
+ "$ref": "GoogleCloudDiscoveryengineV1alphaFileView"
19291
+ },
19292
+ "description": "Output only. Alternate views of this file object. Each file view is attached to a specific role. Possible example keys: - \"thumbnail\" - \"mobile_thumbnail\" - \"clip\" - \"summary\" - \"translation\"",
19293
+ "readOnly": true,
19294
+ "type": "object"
19295
+ }
19296
+ },
19297
+ "type": "object"
19298
+ },
19299
+ "GoogleCloudDiscoveryengineV1alphaFileView": {
19300
+ "description": "Represents a specific alternate version or \"view\" of a file object, such as a summary, a thumbnail, a translated version, etc.",
19301
+ "id": "GoogleCloudDiscoveryengineV1alphaFileView",
19302
+ "properties": {
19303
+ "byteSize": {
19304
+ "description": "Output only. The size of the view in bytes.",
19305
+ "format": "int64",
19306
+ "readOnly": true,
19307
+ "type": "string"
19308
+ },
19309
+ "createTime": {
19310
+ "description": "Output only. The time the view was created.",
19311
+ "format": "google-datetime",
19312
+ "readOnly": true,
19313
+ "type": "string"
19314
+ },
19315
+ "fileCharacteristics": {
19316
+ "$ref": "GoogleCloudDiscoveryengineV1alphaFileCharacteristics",
19317
+ "description": "Output only. Characteristics of other file types.",
19318
+ "readOnly": true
19319
+ },
19320
+ "imageCharacteristics": {
19321
+ "$ref": "GoogleCloudDiscoveryengineV1alphaImageCharacteristics",
19322
+ "description": "Output only. Characteristics of an image media view.",
19323
+ "readOnly": true
19324
+ },
19325
+ "mimeType": {
19326
+ "description": "Output only. MIME type (e.g., \"image/jpeg\", \"image/png\", \"text/plain\", \"video/mp4\")",
19327
+ "readOnly": true,
19328
+ "type": "string"
19329
+ },
19330
+ "uri": {
19331
+ "description": "Output only. The URI to access this media view.",
19332
+ "readOnly": true,
19333
+ "type": "string"
19334
+ },
19335
+ "videoCharacteristics": {
19336
+ "$ref": "GoogleCloudDiscoveryengineV1alphaVideoCharacteristics",
19337
+ "description": "Output only. Characteristics of a video media view.",
19338
+ "readOnly": true
19339
+ },
19340
+ "viewId": {
19341
+ "description": "Output only. Globally Unique id for this specific view.",
19342
+ "readOnly": true,
19343
+ "type": "string"
19344
+ }
19345
+ },
19346
+ "type": "object"
19347
+ },
18478
19348
  "GoogleCloudDiscoveryengineV1alphaFirestoreSource": {
18479
19349
  "description": "Firestore source import data from.",
18480
19350
  "id": "GoogleCloudDiscoveryengineV1alphaFirestoreSource",
@@ -18751,6 +19621,52 @@
18751
19621
  },
18752
19622
  "type": "object"
18753
19623
  },
19624
+ "GoogleCloudDiscoveryengineV1alphaImageCharacteristics": {
19625
+ "description": "Standard characteristics of an image media view.",
19626
+ "id": "GoogleCloudDiscoveryengineV1alphaImageCharacteristics",
19627
+ "properties": {
19628
+ "bitDepth": {
19629
+ "description": "Output only. Bit depth of the image (e.g., 8-bit, 16-bit).",
19630
+ "format": "int32",
19631
+ "readOnly": true,
19632
+ "type": "integer"
19633
+ },
19634
+ "colorSpace": {
19635
+ "description": "Output only. Color space of the image (e.g., \"RGB\", \"CMYK\", \"Grayscale\").",
19636
+ "enum": [
19637
+ "COLOR_SPACE_UNSPECIFIED",
19638
+ "RGB",
19639
+ "CMYK",
19640
+ "GRAYSCALE",
19641
+ "YUV",
19642
+ "OTHER_COLOR_SPACE"
19643
+ ],
19644
+ "enumDescriptions": [
19645
+ "Default value. Unknown color space.",
19646
+ "Red, green, blue colorspace.",
19647
+ "Cyan, magenta, yellow, and black colorspace.",
19648
+ "Grayscale colorspace.",
19649
+ "YUV colorspace.",
19650
+ "Other colorspace."
19651
+ ],
19652
+ "readOnly": true,
19653
+ "type": "string"
19654
+ },
19655
+ "height": {
19656
+ "description": "Output only. Image height in pixels.",
19657
+ "format": "int32",
19658
+ "readOnly": true,
19659
+ "type": "integer"
19660
+ },
19661
+ "width": {
19662
+ "description": "Output only. Image width in pixels.",
19663
+ "format": "int32",
19664
+ "readOnly": true,
19665
+ "type": "integer"
19666
+ }
19667
+ },
19668
+ "type": "object"
19669
+ },
18754
19670
  "GoogleCloudDiscoveryengineV1alphaImportCompletionSuggestionsMetadata": {
18755
19671
  "description": "Metadata related to the progress of the ImportCompletionSuggestions operation. This will be returned by the google.longrunning.Operation.metadata field.",
18756
19672
  "id": "GoogleCloudDiscoveryengineV1alphaImportCompletionSuggestionsMetadata",
@@ -18910,7 +19826,7 @@
18910
19826
  "description": "Cloud Storage location for the input content."
18911
19827
  },
18912
19828
  "idField": {
18913
- "description": "The field indicates the ID field or column to be used as unique IDs of the documents. For GcsSource it is the key of the JSON field. For instance, `my_id` for JSON `{\"my_id\": \"some_uuid\"}`. For others, it may be the column name of the table where the unique ids are stored. The values of the JSON field or the table column are used as the Document.ids. The JSON field or the table column must be of string type, and the values must be set as valid strings conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) with 1-63 characters. Otherwise, documents without valid IDs fail to be imported. Only set this field when auto_generate_ids is unset or set as `false`. Otherwise, an INVALID_ARGUMENT error is thrown. If it is unset, a default value `_id` is used when importing from the allowed data sources. Supported data sources: * GcsSource. GcsSource.data_schema must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown. * BigQuerySource. BigQuerySource.data_schema must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown. * SpannerSource. * CloudSqlSource. * FirestoreSource. * BigtableSource.",
19829
+ "description": "The field indicates the ID field or column to be used as unique IDs of the documents. For GcsSource it is the key of the JSON field. For instance, `my_id` for JSON `{\"my_id\": \"some_uuid\"}`. For others, it may be the column name of the table where the unique ids are stored. The values of the JSON field or the table column are used as the Document.ids. The JSON field or the table column must be of string type, and the values must be set as valid strings conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) with 1-63 characters. Otherwise, documents without valid IDs fail to be imported. Only set this field when auto_generate_ids is unset or set as `false`. Otherwise, an INVALID_ARGUMENT error is thrown. If it is unset, a default value `_id` is used when importing from the allowed data sources. Supported data sources: * GcsSource. GcsSource.data_schema must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown. * BigQuerySource. BigQuerySource.data_schema must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown. * SpannerSource. * CloudSqlSource. * BigtableSource.",
18914
19830
  "type": "string"
18915
19831
  },
18916
19832
  "inlineSource": {
@@ -19552,6 +20468,24 @@
19552
20468
  },
19553
20469
  "type": "object"
19554
20470
  },
20471
+ "GoogleCloudDiscoveryengineV1alphaListFilesResponse": {
20472
+ "description": "Response message for SessionService.ListFiles method.",
20473
+ "id": "GoogleCloudDiscoveryengineV1alphaListFilesResponse",
20474
+ "properties": {
20475
+ "files": {
20476
+ "description": "The FileMetadatas.",
20477
+ "items": {
20478
+ "$ref": "GoogleCloudDiscoveryengineV1alphaFileMetadata"
20479
+ },
20480
+ "type": "array"
20481
+ },
20482
+ "nextPageToken": {
20483
+ "description": "A token to retrieve next page of results. Pass this value in the ListFilesRequest.page_token field in the subsequent call to `ListFiles` method to retrieve the next page of results.",
20484
+ "type": "string"
20485
+ }
20486
+ },
20487
+ "type": "object"
20488
+ },
19555
20489
  "GoogleCloudDiscoveryengineV1alphaListIdentityMappingStoresResponse": {
19556
20490
  "description": "Response message for IdentityMappingStoreService.ListIdentityMappingStores",
19557
20491
  "id": "GoogleCloudDiscoveryengineV1alphaListIdentityMappingStoresResponse",
@@ -19665,7 +20599,7 @@
19665
20599
  "id": "GoogleCloudDiscoveryengineV1alphaListSessionsRequest",
19666
20600
  "properties": {
19667
20601
  "filter": {
19668
- "description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
20602
+ "description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: * `user_pseudo_id = some_id` * `display_name = \"some_name\"` * `starred = true` * `is_pinned=true AND (NOT labels:hidden)` * `create_time > \"1970-01-01T12:00:00Z\"`",
19669
20603
  "type": "string"
19670
20604
  },
19671
20605
  "orderBy": {
@@ -19845,6 +20779,17 @@
19845
20779
  },
19846
20780
  "type": "object"
19847
20781
  },
20782
+ "GoogleCloudDiscoveryengineV1alphaOutputConfig": {
20783
+ "description": "The output configuration setting.",
20784
+ "id": "GoogleCloudDiscoveryengineV1alphaOutputConfig",
20785
+ "properties": {
20786
+ "bigqueryDestination": {
20787
+ "$ref": "GoogleCloudDiscoveryengineV1alphaBigQueryDestination",
20788
+ "description": "The BigQuery location where the output is to be written to."
20789
+ }
20790
+ },
20791
+ "type": "object"
20792
+ },
19848
20793
  "GoogleCloudDiscoveryengineV1alphaPageInfo": {
19849
20794
  "description": "Detailed page information.",
19850
20795
  "id": "GoogleCloudDiscoveryengineV1alphaPageInfo",
@@ -20030,6 +20975,21 @@
20030
20975
  "dataUseTermsVersion": {
20031
20976
  "description": "Required. The version of the [Terms for data use](https://cloud.google.com/retail/data-use-terms) that caller has read and would like to give consent to. Acceptable version is `2022-11-23`, and this may change over time.",
20032
20977
  "type": "string"
20978
+ },
20979
+ "saasParams": {
20980
+ "$ref": "GoogleCloudDiscoveryengineV1alphaProvisionProjectRequestSaasParams",
20981
+ "description": "Optional. Parameters for Agentspace."
20982
+ }
20983
+ },
20984
+ "type": "object"
20985
+ },
20986
+ "GoogleCloudDiscoveryengineV1alphaProvisionProjectRequestSaasParams": {
20987
+ "description": "Parameters for Agentspace.",
20988
+ "id": "GoogleCloudDiscoveryengineV1alphaProvisionProjectRequestSaasParams",
20989
+ "properties": {
20990
+ "acceptBizQos": {
20991
+ "description": "Optional. Set to `true` to specify that caller has read and would like to give consent to the [Terms for Agent Space quality of service].",
20992
+ "type": "boolean"
20033
20993
  }
20034
20994
  },
20035
20995
  "type": "object"
@@ -20394,7 +21354,7 @@
20394
21354
  "type": "string"
20395
21355
  },
20396
21356
  "records": {
20397
- "description": "Required. A list of records to rank. At most 200 records to rank.",
21357
+ "description": "Required. A list of records to rank.",
20398
21358
  "items": {
20399
21359
  "$ref": "GoogleCloudDiscoveryengineV1alphaRankingRecord"
20400
21360
  },
@@ -20697,6 +21657,24 @@
20697
21657
  },
20698
21658
  "type": "object"
20699
21659
  },
21660
+ "GoogleCloudDiscoveryengineV1alphaRefreshTokenInfo": {
21661
+ "description": "Describes a refresh token.",
21662
+ "id": "GoogleCloudDiscoveryengineV1alphaRefreshTokenInfo",
21663
+ "properties": {
21664
+ "name": {
21665
+ "description": "Required. The connection for which this token applies.",
21666
+ "type": "string"
21667
+ },
21668
+ "scopes": {
21669
+ "description": "The list of scopes for this token.",
21670
+ "items": {
21671
+ "type": "string"
21672
+ },
21673
+ "type": "array"
21674
+ }
21675
+ },
21676
+ "type": "object"
21677
+ },
20700
21678
  "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata": {
20701
21679
  "description": "Metadata related to the progress of the CrawlRateManagementService.RemoveDedicatedCrawlRate operation. This will be returned by the google.longrunning.Operation.metadata field.",
20702
21680
  "id": "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata",
@@ -21316,7 +22294,7 @@
21316
22294
  },
21317
22295
  "naturalLanguageQueryUnderstandingSpec": {
21318
22296
  "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec",
21319
- "description": "If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done."
22297
+ "description": "Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done."
21320
22298
  },
21321
22299
  "offset": {
21322
22300
  "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned.",
@@ -21361,7 +22339,7 @@
21361
22339
  "description": "The query expansion specification that specifies the conditions under which query expansion occurs."
21362
22340
  },
21363
22341
  "rankingExpression": {
21364
- "description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result",
22342
+ "description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `document_age`: The time in hours elapsed since the document was last updated, a floating-point number (e.g., 0.25 means 15 minutes). * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result",
21365
22343
  "type": "string"
21366
22344
  },
21367
22345
  "rankingExpressionBackend": {
@@ -21428,7 +22406,7 @@ false
21428
22406
  "type": "string"
21429
22407
  },
21430
22408
  "session": {
21431
- "description": "The session resource name. Optional. Session allows users to do multi-turn /search API calls or coordination between /search API calls and /answer API calls. Example #1 (multi-turn /search API calls): 1. Call /search API with the auto-session mode (see below). 2. Call /search API with the session ID generated in the first call. Here, the previous search query gets considered in query standing. I.e., if the first query is \"How did Alphabet do in 2022?\" and the current query is \"How about 2023?\", the current query will be interpreted as \"How did Alphabet do in 2023?\". Example #2 (coordination between /search API calls and /answer API calls): 1. Call /search API with the auto-session mode (see below). 2. Call /answer API with the session ID generated in the first call. Here, the answer generation happens in the context of the search results from the first search call. Auto-session mode: when `projects/.../sessions/-` is used, a new session gets automatically created. Otherwise, users can use the create-session API to create a session manually. Multi-turn Search feature is currently at private GA stage. Please use v1alpha or v1beta version instead before we launch this feature to public GA. Or ask for allowlisting through Google Support team.",
22409
+ "description": "The session resource name. Optional. Session allows users to do multi-turn /search API calls or coordination between /search API calls and /answer API calls. Example #1 (multi-turn /search API calls): Call /search API with the session ID generated in the first call. Here, the previous search query gets considered in query standing. I.e., if the first query is \"How did Alphabet do in 2022?\" and the current query is \"How about 2023?\", the current query will be interpreted as \"How did Alphabet do in 2023?\". Example #2 (coordination between /search API calls and /answer API calls): Call /answer API with the session ID generated in the first call. Here, the answer generation happens in the context of the search results from the first search call. Multi-turn Search feature is currently at private GA stage. Please use v1alpha or v1beta version instead before we launch this feature to public GA. Or ask for allowlisting through Google Support team.",
21432
22410
  "type": "string"
21433
22411
  },
21434
22412
  "sessionSpec": {
@@ -21925,6 +22903,20 @@ false
21925
22903
  "description": "Specification to enable natural language understanding capabilities for search requests.",
21926
22904
  "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec",
21927
22905
  "properties": {
22906
+ "extractedFilterBehavior": {
22907
+ "description": "Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is `HARD_FILTER`. For multi-datastore search, the default behavior is `SOFT_BOOST`. Location-based filters are always applied as hard filters, and the `SOFT_BOOST` setting will not affect them. This field is only used if SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition is set to FilterExtractionCondition.ENABLED.",
22908
+ "enum": [
22909
+ "EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED",
22910
+ "HARD_FILTER",
22911
+ "SOFT_BOOST"
22912
+ ],
22913
+ "enumDescriptions": [
22914
+ "`EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED` will use the default behavior for extracted filters. For single datastore search, the default is to apply as hard filters. For multi-datastore search, the default is to apply as soft boosts.",
22915
+ "Applies all extracted filters as hard filters on the results. Results that do not pass the extracted filters will not be returned in the result set.",
22916
+ "Applies all extracted filters as soft boosts. Results that pass the filters will be boosted up to higher ranks in the result set."
22917
+ ],
22918
+ "type": "string"
22919
+ },
21928
22920
  "filterExtractionCondition": {
21929
22921
  "description": "The condition under which filter extraction should occur. Server behavior defaults to `DISABLED`.",
21930
22922
  "enum": [
@@ -23344,6 +24336,133 @@ false
23344
24336
  },
23345
24337
  "type": "object"
23346
24338
  },
24339
+ "GoogleCloudDiscoveryengineV1alphaStreamAssistRequest": {
24340
+ "description": "Request for the AssistantService.StreamAssist method.",
24341
+ "id": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequest",
24342
+ "properties": {
24343
+ "generationSpec": {
24344
+ "$ref": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestGenerationSpec",
24345
+ "description": "Optional. Specification of the generation configuration for the request."
24346
+ },
24347
+ "query": {
24348
+ "$ref": "GoogleCloudDiscoveryengineV1alphaQuery",
24349
+ "description": "Optional. Current user query. Empty query is only supported if `file_ids` are provided. In this case, the answer will be generated based on those context files."
24350
+ },
24351
+ "session": {
24352
+ "description": "Optional. The session to use for the request. If specified, the assistant has access to the session history, and the query and the answer are stored there. If `-` is specified as the session ID, or it is left empty, then a new session is created with an automatically generated ID. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}`",
24353
+ "type": "string"
24354
+ },
24355
+ "toolsSpec": {
24356
+ "$ref": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpec",
24357
+ "description": "Optional. Specification of tools that are used to serve the request."
24358
+ },
24359
+ "userMetadata": {
24360
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistUserMetadata",
24361
+ "description": "Optional. Information about the user initiating the query."
24362
+ }
24363
+ },
24364
+ "type": "object"
24365
+ },
24366
+ "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestGenerationSpec": {
24367
+ "description": "Assistant generation specification for the request. This allows to override the default generation configuration at the engine level.",
24368
+ "id": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestGenerationSpec",
24369
+ "properties": {
24370
+ "modelId": {
24371
+ "description": "Optional. The Vertex AI model_id used for the generative model. If not set, the default Assistant model will be used.",
24372
+ "type": "string"
24373
+ }
24374
+ },
24375
+ "type": "object"
24376
+ },
24377
+ "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpec": {
24378
+ "description": "Specification of tools that are used to serve the request.",
24379
+ "id": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpec",
24380
+ "properties": {
24381
+ "imageGenerationSpec": {
24382
+ "$ref": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecImageGenerationSpec",
24383
+ "description": "Optional. Specification of the image generation tool."
24384
+ },
24385
+ "vertexAiSearchSpec": {
24386
+ "$ref": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecVertexAiSearchSpec",
24387
+ "description": "Optional. Specification of the Vertex AI Search tool."
24388
+ },
24389
+ "videoGenerationSpec": {
24390
+ "$ref": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecVideoGenerationSpec",
24391
+ "description": "Optional. Specification of the video generation tool."
24392
+ },
24393
+ "webGroundingSpec": {
24394
+ "$ref": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecWebGroundingSpec",
24395
+ "description": "Optional. Specification of the web grounding tool. If field is present, enables grounding with web search. Works only if Assistant.web_grounding_type is WEB_GROUNDING_TYPE_GOOGLE_SEARCH or WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH."
24396
+ }
24397
+ },
24398
+ "type": "object"
24399
+ },
24400
+ "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecImageGenerationSpec": {
24401
+ "description": "Specification of the image generation tool.",
24402
+ "id": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecImageGenerationSpec",
24403
+ "properties": {},
24404
+ "type": "object"
24405
+ },
24406
+ "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecVertexAiSearchSpec": {
24407
+ "description": "Specification of the Vertex AI Search tool.",
24408
+ "id": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecVertexAiSearchSpec",
24409
+ "properties": {
24410
+ "dataStoreSpecs": {
24411
+ "description": "Optional. Specs defining DataStores to filter on in a search call and configurations for those data stores. This is only considered for Engines with multiple data stores.",
24412
+ "items": {
24413
+ "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec"
24414
+ },
24415
+ "type": "array"
24416
+ },
24417
+ "filter": {
24418
+ "description": "Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. Filtering in Vertex AI Search is done by mapping the LHS filter key to a key property defined in the Vertex AI Search backend -- this mapping is defined by the customer in their schema. For example a media customer might have a field 'name' in their schema. In this case the filter would look like this: filter --> name:'ANY(\"king kong\")' For more information about filtering including syntax and filter operators, see [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)",
24419
+ "type": "string"
24420
+ }
24421
+ },
24422
+ "type": "object"
24423
+ },
24424
+ "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecVideoGenerationSpec": {
24425
+ "description": "Specification of the video generation tool.",
24426
+ "id": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecVideoGenerationSpec",
24427
+ "properties": {},
24428
+ "type": "object"
24429
+ },
24430
+ "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecWebGroundingSpec": {
24431
+ "description": "Specification of the web grounding tool.",
24432
+ "id": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecWebGroundingSpec",
24433
+ "properties": {},
24434
+ "type": "object"
24435
+ },
24436
+ "GoogleCloudDiscoveryengineV1alphaStreamAssistResponse": {
24437
+ "description": "Response for the AssistantService.StreamAssist method.",
24438
+ "id": "GoogleCloudDiscoveryengineV1alphaStreamAssistResponse",
24439
+ "properties": {
24440
+ "answer": {
24441
+ "$ref": "GoogleCloudDiscoveryengineV1alphaAssistAnswer",
24442
+ "description": "Assist answer resource object containing parts of the assistant's final answer for the user's query. Not present if the current response doesn't add anything to previously sent AssistAnswer.replies. Observe AssistAnswer.state to see if more parts are to be expected. While the state is `IN_PROGRESS`, the AssistAnswer.replies field in each response will contain replies (reply fragments) to be appended to the ones received in previous responses. AssistAnswer.name won't be filled. If the state is `SUCCEEDED`, `FAILED` or `SKIPPED`, the response is the last response and AssistAnswer.name will have a value."
24443
+ },
24444
+ "assistToken": {
24445
+ "description": "A global unique ID that identifies the current pair of request and stream of responses. Used for feedback and support.",
24446
+ "type": "string"
24447
+ },
24448
+ "sessionInfo": {
24449
+ "$ref": "GoogleCloudDiscoveryengineV1alphaStreamAssistResponseSessionInfo",
24450
+ "description": "Session information."
24451
+ }
24452
+ },
24453
+ "type": "object"
24454
+ },
24455
+ "GoogleCloudDiscoveryengineV1alphaStreamAssistResponseSessionInfo": {
24456
+ "description": "Information about the session.",
24457
+ "id": "GoogleCloudDiscoveryengineV1alphaStreamAssistResponseSessionInfo",
24458
+ "properties": {
24459
+ "session": {
24460
+ "description": "Name of the newly generated or continued session. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}`.",
24461
+ "type": "string"
24462
+ }
24463
+ },
24464
+ "type": "object"
24465
+ },
23347
24466
  "GoogleCloudDiscoveryengineV1alphaSuggestionDenyListEntry": {
23348
24467
  "description": "Suggestion deny list entry identifying the phrase to block from suggestions and the applied operation for the phrase.",
23349
24468
  "id": "GoogleCloudDiscoveryengineV1alphaSuggestionDenyListEntry",
@@ -23748,6 +24867,36 @@ false
23748
24867
  },
23749
24868
  "type": "object"
23750
24869
  },
24870
+ "GoogleCloudDiscoveryengineV1alphaUploadSessionFileRequest": {
24871
+ "description": "Request for the AssistantService.UploadSessionFile method.",
24872
+ "id": "GoogleCloudDiscoveryengineV1alphaUploadSessionFileRequest",
24873
+ "properties": {
24874
+ "blob": {
24875
+ "$ref": "GdataMedia",
24876
+ "description": "Information about the file being uploaded."
24877
+ },
24878
+ "mediaRequestInfo": {
24879
+ "$ref": "ApiservingMediaRequestInfo",
24880
+ "description": "Media upload request metadata."
24881
+ }
24882
+ },
24883
+ "type": "object"
24884
+ },
24885
+ "GoogleCloudDiscoveryengineV1alphaUploadSessionFileResponse": {
24886
+ "description": "Response for the AssistantService.UploadSessionFile method.",
24887
+ "id": "GoogleCloudDiscoveryengineV1alphaUploadSessionFileResponse",
24888
+ "properties": {
24889
+ "fileId": {
24890
+ "description": "The ID of the uploaded file.",
24891
+ "type": "string"
24892
+ },
24893
+ "mediaResponseInfo": {
24894
+ "$ref": "ApiservingMediaResponseInfo",
24895
+ "description": "Media upload response metadata."
24896
+ }
24897
+ },
24898
+ "type": "object"
24899
+ },
23751
24900
  "GoogleCloudDiscoveryengineV1alphaUserEvent": {
23752
24901
  "description": "UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website.",
23753
24902
  "id": "GoogleCloudDiscoveryengineV1alphaUserEvent",
@@ -23901,14 +25050,16 @@ false
23901
25050
  "ASSIGNED",
23902
25051
  "UNASSIGNED",
23903
25052
  "NO_LICENSE",
23904
- "NO_LICENSE_ATTEMPTED_LOGIN"
25053
+ "NO_LICENSE_ATTEMPTED_LOGIN",
25054
+ "BLOCKED"
23905
25055
  ],
23906
25056
  "enumDescriptions": [
23907
25057
  "Default value.",
23908
25058
  "License assigned to the user.",
23909
25059
  "No license assigned to the user. Deprecated, translated to NO_LICENSE.",
23910
25060
  "No license assigned to the user.",
23911
- "User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin)."
25061
+ "User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin).",
25062
+ "User is blocked from assigning a license."
23912
25063
  ],
23913
25064
  "readOnly": true,
23914
25065
  "type": "string"
@@ -23934,6 +25085,65 @@ false
23934
25085
  },
23935
25086
  "type": "object"
23936
25087
  },
25088
+ "GoogleCloudDiscoveryengineV1alphaVideoCharacteristics": {
25089
+ "description": "Standard characteristics of a video media view.",
25090
+ "id": "GoogleCloudDiscoveryengineV1alphaVideoCharacteristics",
25091
+ "properties": {
25092
+ "audioBitrateKbps": {
25093
+ "description": "Output only. Bitrate of the audio in kbps.",
25094
+ "format": "int32",
25095
+ "readOnly": true,
25096
+ "type": "integer"
25097
+ },
25098
+ "audioCodecs": {
25099
+ "description": "Output only. Audio codecs used in the video.",
25100
+ "items": {
25101
+ "type": "string"
25102
+ },
25103
+ "readOnly": true,
25104
+ "type": "array"
25105
+ },
25106
+ "duration": {
25107
+ "description": "Output only. Video duration.",
25108
+ "format": "google-duration",
25109
+ "readOnly": true,
25110
+ "type": "string"
25111
+ },
25112
+ "frameRate": {
25113
+ "description": "Output only. Frame rate (frames per second).",
25114
+ "format": "double",
25115
+ "readOnly": true,
25116
+ "type": "number"
25117
+ },
25118
+ "height": {
25119
+ "description": "Output only. Video height in pixels.",
25120
+ "format": "int32",
25121
+ "readOnly": true,
25122
+ "type": "integer"
25123
+ },
25124
+ "videoBitrateKbps": {
25125
+ "description": "Output only. Bitrate of the video in kbps.",
25126
+ "format": "int32",
25127
+ "readOnly": true,
25128
+ "type": "integer"
25129
+ },
25130
+ "videoCodecs": {
25131
+ "description": "Output only. Video codecs used in the video.",
25132
+ "items": {
25133
+ "type": "string"
25134
+ },
25135
+ "readOnly": true,
25136
+ "type": "array"
25137
+ },
25138
+ "width": {
25139
+ "description": "Output only. Video width in pixels.",
25140
+ "format": "int32",
25141
+ "readOnly": true,
25142
+ "type": "integer"
25143
+ }
25144
+ },
25145
+ "type": "object"
25146
+ },
23937
25147
  "GoogleCloudDiscoveryengineV1alphaWidgetConfig": {
23938
25148
  "description": "WidgetConfig captures configs at the Widget level.",
23939
25149
  "id": "GoogleCloudDiscoveryengineV1alphaWidgetConfig",
@@ -24559,7 +25769,7 @@ false
24559
25769
  ],
24560
25770
  "type": "string"
24561
25771
  },
24562
- "description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing`",
25772
+ "description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.",
24563
25773
  "readOnly": true,
24564
25774
  "type": "object"
24565
25775
  },
@@ -24810,11 +26020,12 @@ false
24810
26020
  "type": "boolean"
24811
26021
  },
24812
26022
  "kmsKey": {
24813
- "description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
26023
+ "description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
24814
26024
  "type": "string"
24815
26025
  },
24816
26026
  "kmsKeyVersion": {
24817
- "description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
26027
+ "description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
26028
+ "readOnly": true,
24818
26029
  "type": "string"
24819
26030
  },
24820
26031
  "lastRotationTimestampMicros": {
@@ -25687,6 +26898,10 @@ false
25687
26898
  "description": "The layout parsing configurations for documents.",
25688
26899
  "id": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigLayoutParsingConfig",
25689
26900
  "properties": {
26901
+ "enableGetProcessedDocument": {
26902
+ "description": "Optional. If true, the processed document will be made available for the GetProcessedDocument API.",
26903
+ "type": "boolean"
26904
+ },
25690
26905
  "enableImageAnnotation": {
25691
26906
  "description": "Optional. If true, the LLM based annotation is added to the image during parsing.",
25692
26907
  "type": "boolean"
@@ -25820,7 +27035,7 @@ false
25820
27035
  ],
25821
27036
  "type": "string"
25822
27037
  },
25823
- "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing`",
27038
+ "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.",
25824
27039
  "type": "object"
25825
27040
  },
25826
27041
  "industryVertical": {
@@ -26958,7 +28173,7 @@ false
26958
28173
  },
26959
28174
  "naturalLanguageQueryUnderstandingSpec": {
26960
28175
  "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec",
26961
- "description": "If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done."
28176
+ "description": "Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done."
26962
28177
  },
26963
28178
  "offset": {
26964
28179
  "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned.",
@@ -27003,7 +28218,7 @@ false
27003
28218
  "description": "The query expansion specification that specifies the conditions under which query expansion occurs."
27004
28219
  },
27005
28220
  "rankingExpression": {
27006
- "description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result",
28221
+ "description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `document_age`: The time in hours elapsed since the document was last updated, a floating-point number (e.g., 0.25 means 15 minutes). * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result",
27007
28222
  "type": "string"
27008
28223
  },
27009
28224
  "rankingExpressionBackend": {
@@ -27070,7 +28285,7 @@ false
27070
28285
  "type": "string"
27071
28286
  },
27072
28287
  "session": {
27073
- "description": "The session resource name. Optional. Session allows users to do multi-turn /search API calls or coordination between /search API calls and /answer API calls. Example #1 (multi-turn /search API calls): 1. Call /search API with the auto-session mode (see below). 2. Call /search API with the session ID generated in the first call. Here, the previous search query gets considered in query standing. I.e., if the first query is \"How did Alphabet do in 2022?\" and the current query is \"How about 2023?\", the current query will be interpreted as \"How did Alphabet do in 2023?\". Example #2 (coordination between /search API calls and /answer API calls): 1. Call /search API with the auto-session mode (see below). 2. Call /answer API with the session ID generated in the first call. Here, the answer generation happens in the context of the search results from the first search call. Auto-session mode: when `projects/.../sessions/-` is used, a new session gets automatically created. Otherwise, users can use the create-session API to create a session manually. Multi-turn Search feature is currently at private GA stage. Please use v1alpha or v1beta version instead before we launch this feature to public GA. Or ask for allowlisting through Google Support team.",
28288
+ "description": "The session resource name. Optional. Session allows users to do multi-turn /search API calls or coordination between /search API calls and /answer API calls. Example #1 (multi-turn /search API calls): Call /search API with the session ID generated in the first call. Here, the previous search query gets considered in query standing. I.e., if the first query is \"How did Alphabet do in 2022?\" and the current query is \"How about 2023?\", the current query will be interpreted as \"How did Alphabet do in 2023?\". Example #2 (coordination between /search API calls and /answer API calls): Call /answer API with the session ID generated in the first call. Here, the answer generation happens in the context of the search results from the first search call. Multi-turn Search feature is currently at private GA stage. Please use v1alpha or v1beta version instead before we launch this feature to public GA. Or ask for allowlisting through Google Support team.",
27074
28289
  "type": "string"
27075
28290
  },
27076
28291
  "sessionSpec": {
@@ -27563,6 +28778,20 @@ false
27563
28778
  "description": "Specification to enable natural language understanding capabilities for search requests.",
27564
28779
  "id": "GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec",
27565
28780
  "properties": {
28781
+ "extractedFilterBehavior": {
28782
+ "description": "Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is `HARD_FILTER`. For multi-datastore search, the default behavior is `SOFT_BOOST`. Location-based filters are always applied as hard filters, and the `SOFT_BOOST` setting will not affect them. This field is only used if SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition is set to FilterExtractionCondition.ENABLED.",
28783
+ "enum": [
28784
+ "EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED",
28785
+ "HARD_FILTER",
28786
+ "SOFT_BOOST"
28787
+ ],
28788
+ "enumDescriptions": [
28789
+ "`EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED` will use the default behavior for extracted filters. For single datastore search, the default is to apply as hard filters. For multi-datastore search, the default is to apply as soft boosts.",
28790
+ "Applies all extracted filters as hard filters on the results. Results that do not pass the extracted filters will not be returned in the result set.",
28791
+ "Applies all extracted filters as soft boosts. Results that pass the filters will be boosted up to higher ranks in the result set."
28792
+ ],
28793
+ "type": "string"
28794
+ },
27566
28795
  "filterExtractionCondition": {
27567
28796
  "description": "The condition under which filter extraction should occur. Server behavior defaults to `DISABLED`.",
27568
28797
  "enum": [
@@ -28058,14 +29287,16 @@ false
28058
29287
  "ASSIGNED",
28059
29288
  "UNASSIGNED",
28060
29289
  "NO_LICENSE",
28061
- "NO_LICENSE_ATTEMPTED_LOGIN"
29290
+ "NO_LICENSE_ATTEMPTED_LOGIN",
29291
+ "BLOCKED"
28062
29292
  ],
28063
29293
  "enumDescriptions": [
28064
29294
  "Default value.",
28065
29295
  "License assigned to the user.",
28066
29296
  "No license assigned to the user. Deprecated, translated to NO_LICENSE.",
28067
29297
  "No license assigned to the user.",
28068
- "User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin)."
29298
+ "User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin).",
29299
+ "User is blocked from assigning a license."
28069
29300
  ],
28070
29301
  "readOnly": true,
28071
29302
  "type": "string"
@@ -28136,6 +29367,145 @@ false
28136
29367
  },
28137
29368
  "type": "object"
28138
29369
  },
29370
+ "GoogleCloudNotebooklmV1alphaAgentspaceMetadata": {
29371
+ "description": "Metadata about an agentspace source.",
29372
+ "id": "GoogleCloudNotebooklmV1alphaAgentspaceMetadata",
29373
+ "properties": {
29374
+ "documentName": {
29375
+ "description": "Output only. The full document name in Agentspace.",
29376
+ "readOnly": true,
29377
+ "type": "string"
29378
+ },
29379
+ "documentTitle": {
29380
+ "description": "Output only. The title of the document.",
29381
+ "readOnly": true,
29382
+ "type": "string"
29383
+ }
29384
+ },
29385
+ "type": "object"
29386
+ },
29387
+ "GoogleCloudNotebooklmV1alphaBatchCreateSourcesRequest": {
29388
+ "description": "Request for SourceService.BatchCreateSources method.",
29389
+ "id": "GoogleCloudNotebooklmV1alphaBatchCreateSourcesRequest",
29390
+ "properties": {
29391
+ "userContents": {
29392
+ "description": "Required. The UserContents to be uploaded.",
29393
+ "items": {
29394
+ "$ref": "GoogleCloudNotebooklmV1alphaUserContent"
29395
+ },
29396
+ "type": "array"
29397
+ }
29398
+ },
29399
+ "type": "object"
29400
+ },
29401
+ "GoogleCloudNotebooklmV1alphaBatchCreateSourcesResponse": {
29402
+ "description": "Response for SourceService.BatchCreateSources method.",
29403
+ "id": "GoogleCloudNotebooklmV1alphaBatchCreateSourcesResponse",
29404
+ "properties": {
29405
+ "sources": {
29406
+ "description": "The Sources.",
29407
+ "items": {
29408
+ "$ref": "GoogleCloudNotebooklmV1alphaSource"
29409
+ },
29410
+ "type": "array"
29411
+ }
29412
+ },
29413
+ "type": "object"
29414
+ },
29415
+ "GoogleCloudNotebooklmV1alphaListRecentlyViewedNotebooksResponse": {
29416
+ "description": "Response for NotebookService.ListRecentlyViewedNotebooks method.",
29417
+ "id": "GoogleCloudNotebooklmV1alphaListRecentlyViewedNotebooksResponse",
29418
+ "properties": {
29419
+ "nextPageToken": {
29420
+ "description": "The page token, provide this to retrieve the subsequent page.",
29421
+ "type": "string"
29422
+ },
29423
+ "notebooks": {
29424
+ "description": "The list of recently viewed notebooks.",
29425
+ "items": {
29426
+ "$ref": "GoogleCloudNotebooklmV1alphaNotebook"
29427
+ },
29428
+ "type": "array"
29429
+ }
29430
+ },
29431
+ "type": "object"
29432
+ },
29433
+ "GoogleCloudNotebooklmV1alphaNotebook": {
29434
+ "description": "Notebook is a resource where users can store their content (as sources) and interacts with the content.",
29435
+ "id": "GoogleCloudNotebooklmV1alphaNotebook",
29436
+ "properties": {
29437
+ "emoji": {
29438
+ "description": "Output only. The emoji of the notebook.",
29439
+ "readOnly": true,
29440
+ "type": "string"
29441
+ },
29442
+ "metadata": {
29443
+ "$ref": "GoogleCloudNotebooklmV1alphaNotebookMetadata",
29444
+ "description": "The metadata of the notebook."
29445
+ },
29446
+ "name": {
29447
+ "description": "Identifier. The identifier of the notebook. Format: `projects/{project}/locations/{location}/notebooks/{notebook_id}`. This field must be a UTF-8 encoded string.",
29448
+ "type": "string"
29449
+ },
29450
+ "notebookId": {
29451
+ "description": "Optional. Notebook id, which is the last segment of the notebook's resource name. This is to make it similar with notebooklm API.",
29452
+ "type": "string"
29453
+ },
29454
+ "title": {
29455
+ "description": "Optional. The title of the notebook.",
29456
+ "type": "string"
29457
+ }
29458
+ },
29459
+ "type": "object"
29460
+ },
29461
+ "GoogleCloudNotebooklmV1alphaNotebookMetadata": {
29462
+ "description": "Metadata for a notebook.",
29463
+ "id": "GoogleCloudNotebooklmV1alphaNotebookMetadata",
29464
+ "properties": {
29465
+ "createTime": {
29466
+ "description": "The time at which this project was created.",
29467
+ "format": "google-datetime",
29468
+ "type": "string"
29469
+ },
29470
+ "isShareable": {
29471
+ "description": "True if the project is shareable.",
29472
+ "type": "boolean"
29473
+ },
29474
+ "isShared": {
29475
+ "description": "True if this project is currently shared with other people, false otherwise.",
29476
+ "type": "boolean"
29477
+ },
29478
+ "lastViewed": {
29479
+ "description": "A timestamp indicating the time that the current in session user has last viewed the project.",
29480
+ "format": "google-datetime",
29481
+ "type": "string"
29482
+ }
29483
+ },
29484
+ "type": "object"
29485
+ },
29486
+ "GoogleCloudNotebooklmV1alphaSource": {
29487
+ "description": "Source represents a single source of content.",
29488
+ "id": "GoogleCloudNotebooklmV1alphaSource",
29489
+ "properties": {
29490
+ "metadata": {
29491
+ "$ref": "GoogleCloudNotebooklmV1alphaSourceMetadata",
29492
+ "description": "Metadata about the source."
29493
+ },
29494
+ "name": {
29495
+ "description": "Identifier. The full resource name of the source. Format: `projects/{project}/locations/{location}/notebooks/{notebook}/sources/{source_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
29496
+ "type": "string"
29497
+ },
29498
+ "sourceId": {
29499
+ "$ref": "GoogleCloudNotebooklmV1alphaSourceId",
29500
+ "description": "Optional. Source id, which is the last segment of the source's resource name. This is to make it similar with notebooklm API."
29501
+ },
29502
+ "title": {
29503
+ "description": "Optional. Title of the source.",
29504
+ "type": "string"
29505
+ }
29506
+ },
29507
+ "type": "object"
29508
+ },
28139
29509
  "GoogleCloudNotebooklmV1alphaSourceId": {
28140
29510
  "description": "SourceId is the last segment of the source's resource name.",
28141
29511
  "id": "GoogleCloudNotebooklmV1alphaSourceId",
@@ -28147,6 +29517,32 @@ false
28147
29517
  },
28148
29518
  "type": "object"
28149
29519
  },
29520
+ "GoogleCloudNotebooklmV1alphaSourceMetadata": {
29521
+ "description": "Represents the metadata of a source and some additional information.",
29522
+ "id": "GoogleCloudNotebooklmV1alphaSourceMetadata",
29523
+ "properties": {
29524
+ "agentspaceMetadata": {
29525
+ "$ref": "GoogleCloudNotebooklmV1alphaAgentspaceMetadata",
29526
+ "description": "Metadata for an agentspace source."
29527
+ },
29528
+ "sourceAddedTimestamp": {
29529
+ "description": "The timestamp the source was added.",
29530
+ "format": "google-datetime",
29531
+ "type": "string"
29532
+ },
29533
+ "tokenCount": {
29534
+ "description": "The number of tokens in the source.",
29535
+ "format": "int32",
29536
+ "type": "integer"
29537
+ },
29538
+ "wordCount": {
29539
+ "description": "The word count of the source.",
29540
+ "format": "int32",
29541
+ "type": "integer"
29542
+ }
29543
+ },
29544
+ "type": "object"
29545
+ },
28150
29546
  "GoogleCloudNotebooklmV1alphaUploadSourceFileRequest": {
28151
29547
  "description": "Request for the SourceService.UploadSourceFile method.",
28152
29548
  "id": "GoogleCloudNotebooklmV1alphaUploadSourceFileRequest",
@@ -28181,6 +29577,36 @@ false
28181
29577
  },
28182
29578
  "type": "object"
28183
29579
  },
29580
+ "GoogleCloudNotebooklmV1alphaUserContent": {
29581
+ "description": "The \"Content\" messages refer to data the user wants to upload.",
29582
+ "id": "GoogleCloudNotebooklmV1alphaUserContent",
29583
+ "properties": {
29584
+ "agentspaceContent": {
29585
+ "$ref": "GoogleCloudNotebooklmV1alphaUserContentAgentspaceContent",
29586
+ "description": "Agentspace content uploaded as source."
29587
+ }
29588
+ },
29589
+ "type": "object"
29590
+ },
29591
+ "GoogleCloudNotebooklmV1alphaUserContentAgentspaceContent": {
29592
+ "description": "Agentspace content uploaded as source.",
29593
+ "id": "GoogleCloudNotebooklmV1alphaUserContentAgentspaceContent",
29594
+ "properties": {
29595
+ "documentName": {
29596
+ "description": "Optional. The full document name in Agentspace.",
29597
+ "type": "string"
29598
+ },
29599
+ "engineName": {
29600
+ "description": "Optional. Engine to verify the permission of the document.",
29601
+ "type": "string"
29602
+ },
29603
+ "ideaforgeIdeaName": {
29604
+ "description": "Optional. The full idea name for IdeaForge.",
29605
+ "type": "string"
29606
+ }
29607
+ },
29608
+ "type": "object"
29609
+ },
28184
29610
  "GoogleLongrunningCancelOperationRequest": {
28185
29611
  "description": "The request message for Operations.CancelOperation.",
28186
29612
  "id": "GoogleLongrunningCancelOperationRequest",