google-apis-dialogflow_v3beta1 0.94.0 → 0.96.0

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.
@@ -5126,6 +5126,181 @@ module Google
5126
5126
  execute_or_queue_command(command, &block)
5127
5127
  end
5128
5128
 
5129
+ # Creates a version for the specified Tool.
5130
+ # @param [String] parent
5131
+ # Required. The tool to create a version for. Format: `projects//locations//
5132
+ # agents//tools/`.
5133
+ # @param [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ToolVersion] google_cloud_dialogflow_cx_v3beta1_tool_version_object
5134
+ # @param [String] fields
5135
+ # Selector specifying which fields to include in a partial response.
5136
+ # @param [String] quota_user
5137
+ # Available to use for quota purposes for server-side applications. Can be any
5138
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5139
+ # @param [Google::Apis::RequestOptions] options
5140
+ # Request-specific options
5141
+ #
5142
+ # @yield [result, err] Result & error if block supplied
5143
+ # @yieldparam result [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ToolVersion] parsed result object
5144
+ # @yieldparam err [StandardError] error object if request failed
5145
+ #
5146
+ # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ToolVersion]
5147
+ #
5148
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5149
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5150
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5151
+ def create_project_location_agent_tool_version(parent, google_cloud_dialogflow_cx_v3beta1_tool_version_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5152
+ command = make_simple_command(:post, 'v3beta1/{+parent}/versions', options)
5153
+ command.request_representation = Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ToolVersion::Representation
5154
+ command.request_object = google_cloud_dialogflow_cx_v3beta1_tool_version_object
5155
+ command.response_representation = Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ToolVersion::Representation
5156
+ command.response_class = Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ToolVersion
5157
+ command.params['parent'] = parent unless parent.nil?
5158
+ command.query['fields'] = fields unless fields.nil?
5159
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5160
+ execute_or_queue_command(command, &block)
5161
+ end
5162
+
5163
+ # Deletes the specified version of the Tool.
5164
+ # @param [String] name
5165
+ # Required. The name of the tool version to delete. Format: `projects//locations/
5166
+ # /agents//tools//versions/`.
5167
+ # @param [Boolean] force
5168
+ # Optional. This field has no effect for Tools not being used. For Tools that
5169
+ # are used: * If `force` is set to false, an error will be returned with message
5170
+ # indicating the referenced resources. * If `force` is set to true, Dialogflow
5171
+ # will remove the tool, as well as any references to the tool.
5172
+ # @param [String] fields
5173
+ # Selector specifying which fields to include in a partial response.
5174
+ # @param [String] quota_user
5175
+ # Available to use for quota purposes for server-side applications. Can be any
5176
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5177
+ # @param [Google::Apis::RequestOptions] options
5178
+ # Request-specific options
5179
+ #
5180
+ # @yield [result, err] Result & error if block supplied
5181
+ # @yieldparam result [Google::Apis::DialogflowV3beta1::GoogleProtobufEmpty] parsed result object
5182
+ # @yieldparam err [StandardError] error object if request failed
5183
+ #
5184
+ # @return [Google::Apis::DialogflowV3beta1::GoogleProtobufEmpty]
5185
+ #
5186
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5187
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5188
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5189
+ def delete_project_location_agent_tool_version(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
5190
+ command = make_simple_command(:delete, 'v3beta1/{+name}', options)
5191
+ command.response_representation = Google::Apis::DialogflowV3beta1::GoogleProtobufEmpty::Representation
5192
+ command.response_class = Google::Apis::DialogflowV3beta1::GoogleProtobufEmpty
5193
+ command.params['name'] = name unless name.nil?
5194
+ command.query['force'] = force unless force.nil?
5195
+ command.query['fields'] = fields unless fields.nil?
5196
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5197
+ execute_or_queue_command(command, &block)
5198
+ end
5199
+
5200
+ # Retrieves the specified version of the Tool.
5201
+ # @param [String] name
5202
+ # Required. The name of the tool version. Format: `projects//locations//agents//
5203
+ # tools//versions/`.
5204
+ # @param [String] fields
5205
+ # Selector specifying which fields to include in a partial response.
5206
+ # @param [String] quota_user
5207
+ # Available to use for quota purposes for server-side applications. Can be any
5208
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5209
+ # @param [Google::Apis::RequestOptions] options
5210
+ # Request-specific options
5211
+ #
5212
+ # @yield [result, err] Result & error if block supplied
5213
+ # @yieldparam result [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ToolVersion] parsed result object
5214
+ # @yieldparam err [StandardError] error object if request failed
5215
+ #
5216
+ # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ToolVersion]
5217
+ #
5218
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5219
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5220
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5221
+ def get_project_location_agent_tool_version(name, fields: nil, quota_user: nil, options: nil, &block)
5222
+ command = make_simple_command(:get, 'v3beta1/{+name}', options)
5223
+ command.response_representation = Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ToolVersion::Representation
5224
+ command.response_class = Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ToolVersion
5225
+ command.params['name'] = name unless name.nil?
5226
+ command.query['fields'] = fields unless fields.nil?
5227
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5228
+ execute_or_queue_command(command, &block)
5229
+ end
5230
+
5231
+ # List versions of the specified Tool.
5232
+ # @param [String] parent
5233
+ # Required. The parent of the tool versions. Format: `projects//locations//
5234
+ # agents//tools/`.
5235
+ # @param [Fixnum] page_size
5236
+ # Optional. The maximum number of items to return in a single page. By default
5237
+ # 100 and at most 1000.
5238
+ # @param [String] page_token
5239
+ # Optional. The next_page_token value returned from a previous list request.
5240
+ # @param [String] fields
5241
+ # Selector specifying which fields to include in a partial response.
5242
+ # @param [String] quota_user
5243
+ # Available to use for quota purposes for server-side applications. Can be any
5244
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5245
+ # @param [Google::Apis::RequestOptions] options
5246
+ # Request-specific options
5247
+ #
5248
+ # @yield [result, err] Result & error if block supplied
5249
+ # @yieldparam result [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ListToolVersionsResponse] parsed result object
5250
+ # @yieldparam err [StandardError] error object if request failed
5251
+ #
5252
+ # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ListToolVersionsResponse]
5253
+ #
5254
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5255
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5256
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5257
+ def list_project_location_agent_tool_versions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5258
+ command = make_simple_command(:get, 'v3beta1/{+parent}/versions', options)
5259
+ command.response_representation = Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ListToolVersionsResponse::Representation
5260
+ command.response_class = Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ListToolVersionsResponse
5261
+ command.params['parent'] = parent unless parent.nil?
5262
+ command.query['pageSize'] = page_size unless page_size.nil?
5263
+ command.query['pageToken'] = page_token unless page_token.nil?
5264
+ command.query['fields'] = fields unless fields.nil?
5265
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5266
+ execute_or_queue_command(command, &block)
5267
+ end
5268
+
5269
+ # Retrieves the specified version of the Tool and stores it as the current tool
5270
+ # draft, returning the tool with resources updated.
5271
+ # @param [String] name
5272
+ # Required. The name of the tool version. Format: `projects//locations//agents//
5273
+ # tools//versions/`.
5274
+ # @param [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1RestoreToolVersionRequest] google_cloud_dialogflow_cx_v3beta1_restore_tool_version_request_object
5275
+ # @param [String] fields
5276
+ # Selector specifying which fields to include in a partial response.
5277
+ # @param [String] quota_user
5278
+ # Available to use for quota purposes for server-side applications. Can be any
5279
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5280
+ # @param [Google::Apis::RequestOptions] options
5281
+ # Request-specific options
5282
+ #
5283
+ # @yield [result, err] Result & error if block supplied
5284
+ # @yieldparam result [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1RestoreToolVersionResponse] parsed result object
5285
+ # @yieldparam err [StandardError] error object if request failed
5286
+ #
5287
+ # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1RestoreToolVersionResponse]
5288
+ #
5289
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5290
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5291
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5292
+ def restore_project_location_agent_tool_version(name, google_cloud_dialogflow_cx_v3beta1_restore_tool_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5293
+ command = make_simple_command(:post, 'v3beta1/{+name}:restore', options)
5294
+ command.request_representation = Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1RestoreToolVersionRequest::Representation
5295
+ command.request_object = google_cloud_dialogflow_cx_v3beta1_restore_tool_version_request_object
5296
+ command.response_representation = Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1RestoreToolVersionResponse::Representation
5297
+ command.response_class = Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1RestoreToolVersionResponse
5298
+ command.params['name'] = name unless name.nil?
5299
+ command.query['fields'] = fields unless fields.nil?
5300
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5301
+ execute_or_queue_command(command, &block)
5302
+ end
5303
+
5129
5304
  # Creates an TransitionRouteGroup in the specified flow. Note: You should always
5130
5305
  # train a flow prior to sending it queries. See the [training documentation](
5131
5306
  # https://cloud.google.com/dialogflow/cx/docs/concept/training).
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-dialogflow_v3beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.94.0
4
+ version: 0.96.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-03-02 00:00:00.000000000 Z
10
+ date: 2025-03-16 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: google-apis-core
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-dialogflow_v3beta1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-dialogflow_v3beta1/v0.94.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-dialogflow_v3beta1/v0.96.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-dialogflow_v3beta1
62
62
  rdoc_options: []
63
63
  require_paths: