ibm_watson 1.3.1 → 2.0.0

data/lib/ibm_watson/tone_analyzer_v3.rb

@@ -13,7 +13,9 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
+#
+# IBM OpenAPI SDK Code Generator Version: 3.19.0-be3b4618-20201113-200858
+#
 # The IBM Watson™ Tone Analyzer service uses linguistic analysis to detect
 # emotional and language tones in written text. The service can analyze tone at both the
 # document and sentence levels. You can use the service to understand how your written
@@ -38,37 +40,36 @@ module IBMWatson
   # The Tone Analyzer V3 service.
   class ToneAnalyzerV3 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
+    DEFAULT_SERVICE_NAME = "tone_analyzer"
+    DEFAULT_SERVICE_URL = "https://api.us-south.tone-analyzer.watson.cloud.ibm.com"
+    attr_accessor :version
     ##
     # @!method initialize(args)
     # Construct a new client for the Tone Analyzer service.
     #
     # @param args [Hash] The args to initialize with
-    # @option args version [String] The API version date to use with the service, in
-    #   "YYYY-MM-DD" format. Whenever the API is changed in a backwards
-    #   incompatible way, a new minor version of the API is released.
-    #   The service uses the API version for the date you specify, or
-    #   the most recent version before that date. Note that you should
-    #   not programmatically specify the current date at runtime, in
-    #   case the API has been updated since your application's release.
-    #   Instead, specify a version date that is compatible with your
-    #   application, and don't change it until your application is
-    #   ready for a later version.
+    # @option args version [String] Release date of the version of the API you want to use. Specify dates in
+    #   YYYY-MM-DD format. The current version is `2017-09-21`.
     # @option args service_url [String] The base service URL to use when contacting the service.
     #   The base service_url may differ between IBM Cloud regions.
     # @option args authenticator [Object] The Authenticator instance to be configured for this service.
+    # @option args service_name [String] The name of the service to configure. Will be used as the key to load
+    #   any external configuration, if applicable.
     def initialize(args = {})
       @__async_initialized__ = false
       defaults = {}
-      defaults[:version] = nil
-      defaults[:service_url] = "https://gateway.watsonplatform.net/tone-analyzer/api"
+      defaults[:service_url] = DEFAULT_SERVICE_URL
+      defaults[:service_name] = DEFAULT_SERVICE_NAME
       defaults[:authenticator] = nil
+      defaults[:version] = nil
+      user_service_url = args[:service_url] unless args[:service_url].nil?
       args = defaults.merge(args)
       @version = args[:version]
       raise ArgumentError.new("version must be provided") if @version.nil?
 
-      args[:service_name] = "tone_analyzer"
       args[:authenticator] = IBMCloudSdkCore::ConfigBasedAuthenticatorFactory.new.get_authenticator(service_name: args[:service_name]) if args[:authenticator].nil?
       super
+      @service_url = user_service_url unless user_service_url.nil?
     end
 
     #########################
@@ -125,6 +126,8 @@ module IBMWatson
     #   **Accept-Language**.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def tone(tone_input:, content_type: nil, sentences: nil, tones: nil, content_language: nil, accept_language: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("tone_input must be provided") if tone_input.nil?
 
       headers = {
@@ -193,6 +196,8 @@ module IBMWatson
     #   **Accept-Language**.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def tone_chat(utterances:, content_language: nil, accept_language: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("utterances must be provided") if utterances.nil?
 
       headers = {

data/lib/ibm_watson/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module IBMWatson
-  VERSION = "1.3.1"
+  VERSION = "2.0.0"
 end

data/lib/ibm_watson/visual_recognition_v3.rb

@@ -13,10 +13,17 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
-# The IBM Watson™ Visual Recognition service uses deep learning algorithms to
-# identify scenes and objects in images that you upload to the service. You can create and
-# train a custom classifier to identify subjects that suit your needs.
+#
+# IBM OpenAPI SDK Code Generator Version: 3.19.0-be3b4618-20201113-200858
+#
+# IBM Watson™ Visual Recognition is discontinued. Existing instances are supported
+# until 1 December 2021, but as of 7 January 2021, you can't create instances. Any
+# instance that is provisioned on 1 December 2021 will be deleted.
+# {: deprecated}
+#
+# The IBM Watson Visual Recognition service uses deep learning algorithms to identify
+# scenes and objects in images that you upload to the service. You can create and train a
+# custom classifier to identify subjects that suit your needs.
 
 require "concurrent"
 require "erb"
@@ -30,37 +37,37 @@ module IBMWatson
   # The Visual Recognition V3 service.
   class VisualRecognitionV3 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
+    DEFAULT_SERVICE_NAME = "visual_recognition"
+    DEFAULT_SERVICE_URL = "https://api.us-south.visual-recognition.watson.cloud.ibm.com"
+    attr_accessor :version
     ##
     # @!method initialize(args)
     # Construct a new client for the Visual Recognition service.
     #
     # @param args [Hash] The args to initialize with
-    # @option args version [String] The API version date to use with the service, in
-    #   "YYYY-MM-DD" format. Whenever the API is changed in a backwards
-    #   incompatible way, a new minor version of the API is released.
-    #   The service uses the API version for the date you specify, or
-    #   the most recent version before that date. Note that you should
-    #   not programmatically specify the current date at runtime, in
-    #   case the API has been updated since your application's release.
-    #   Instead, specify a version date that is compatible with your
-    #   application, and don't change it until your application is
-    #   ready for a later version.
+    # @option args version [String] Release date of the API version you want to use. Specify dates in YYYY-MM-DD
+    #   format. The current version is `2018-03-19`.
     # @option args service_url [String] The base service URL to use when contacting the service.
     #   The base service_url may differ between IBM Cloud regions.
     # @option args authenticator [Object] The Authenticator instance to be configured for this service.
+    # @option args service_name [String] The name of the service to configure. Will be used as the key to load
+    #   any external configuration, if applicable.
     def initialize(args = {})
+      warn "On 1 December 2021, Visual Recognition will no longer be available. For more information, see https://github.com/watson-developer-cloud/ruby-sdk/tree/master#visual-recognition-deprecation."
       @__async_initialized__ = false
       defaults = {}
-      defaults[:version] = nil
-      defaults[:service_url] = "https://gateway.watsonplatform.net/visual-recognition/api"
+      defaults[:service_url] = DEFAULT_SERVICE_URL
+      defaults[:service_name] = DEFAULT_SERVICE_NAME
       defaults[:authenticator] = nil
+      defaults[:version] = nil
+      user_service_url = args[:service_url] unless args[:service_url].nil?
       args = defaults.merge(args)
       @version = args[:version]
       raise ArgumentError.new("version must be provided") if @version.nil?
 
-      args[:service_name] = "visual_recognition"
       args[:authenticator] = IBMCloudSdkCore::ConfigBasedAuthenticatorFactory.new.get_authenticator(service_name: args[:service_name]) if args[:authenticator].nil?
       super
+      @service_url = user_service_url unless user_service_url.nil?
     end
 
     #########################
@@ -106,6 +113,8 @@ module IBMWatson
     # @param accept_language [String] The desired language of parts of the response. See the response for details.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def classify(images_file: nil, images_filename: nil, images_file_content_type: nil, url: nil, threshold: nil, owners: nil, classifier_ids: nil, accept_language: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
         "Accept-Language" => accept_language
       }
@@ -192,6 +201,8 @@ module IBMWatson
     # @param negative_examples_filename [String] The filename for negative_examples.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def create_classifier(name:, positive_examples:, negative_examples: nil, negative_examples_filename: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("name must be provided") if name.nil?
 
       raise ArgumentError.new("positive_examples must be a hash") unless positive_examples.is_a?(Hash)
@@ -247,6 +258,8 @@ module IBMWatson
     #   return a brief list of classifiers.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_classifiers(verbose: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("watson_vision_combined", "V3", "list_classifiers")
@@ -276,6 +289,8 @@ module IBMWatson
     # @param classifier_id [String] The ID of the classifier.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_classifier(classifier_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("classifier_id must be provided") if classifier_id.nil?
 
       headers = {
@@ -344,6 +359,8 @@ module IBMWatson
     # @param negative_examples_filename [String] The filename for negative_examples.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def update_classifier(classifier_id:, positive_examples: nil, negative_examples: nil, negative_examples_filename: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("classifier_id must be provided") if classifier_id.nil?
 
       raise ArgumentError.new("positive_examples must be a hash") unless positive_examples.nil? || positive_examples.is_a?(Hash)
@@ -395,6 +412,8 @@ module IBMWatson
     # @param classifier_id [String] The ID of the classifier.
     # @return [nil]
     def delete_classifier(classifier_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("classifier_id must be provided") if classifier_id.nil?
 
       headers = {
@@ -429,6 +448,8 @@ module IBMWatson
     # @param classifier_id [String] The ID of the classifier.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_core_ml_model(classifier_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("classifier_id must be provided") if classifier_id.nil?
 
       headers = {
@@ -468,6 +489,8 @@ module IBMWatson
     # @param customer_id [String] The customer ID for which all data is to be deleted.
     # @return [nil]
     def delete_user_data(customer_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("customer_id must be provided") if customer_id.nil?
 
       headers = {

data/lib/ibm_watson/visual_recognition_v4.rb

@@ -13,9 +13,16 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
-# Provide images to the IBM Watson™ Visual Recognition service for analysis. The
-# service detects objects based on a set of images with training data.
+#
+# IBM OpenAPI SDK Code Generator Version: 3.19.0-be3b4618-20201113-200858
+#
+# IBM Watson™ Visual Recognition is discontinued. Existing instances are supported
+# until 1 December 2021, but as of 7 January 2021, you can't create instances. Any
+# instance that is provisioned on 1 December 2021 will be deleted.
+# {: deprecated}
+#
+# Provide images to the IBM Watson Visual Recognition service for analysis. The service
+# detects objects based on a set of images with training data.
 
 require "concurrent"
 require "erb"
@@ -29,37 +36,37 @@ module IBMWatson
   # The Visual Recognition V4 service.
   class VisualRecognitionV4 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
+    DEFAULT_SERVICE_NAME = "visual_recognition"
+    DEFAULT_SERVICE_URL = "https://api.us-south.visual-recognition.watson.cloud.ibm.com"
+    attr_accessor :version
     ##
     # @!method initialize(args)
     # Construct a new client for the Visual Recognition service.
     #
     # @param args [Hash] The args to initialize with
-    # @option args version [String] The API version date to use with the service, in
-    #   "YYYY-MM-DD" format. Whenever the API is changed in a backwards
-    #   incompatible way, a new minor version of the API is released.
-    #   The service uses the API version for the date you specify, or
-    #   the most recent version before that date. Note that you should
-    #   not programmatically specify the current date at runtime, in
-    #   case the API has been updated since your application's release.
-    #   Instead, specify a version date that is compatible with your
-    #   application, and don't change it until your application is
-    #   ready for a later version.
+    # @option args version [String] Release date of the API version you want to use. Specify dates in YYYY-MM-DD
+    #   format. The current version is `2019-02-11`.
     # @option args service_url [String] The base service URL to use when contacting the service.
     #   The base service_url may differ between IBM Cloud regions.
     # @option args authenticator [Object] The Authenticator instance to be configured for this service.
+    # @option args service_name [String] The name of the service to configure. Will be used as the key to load
+    #   any external configuration, if applicable.
     def initialize(args = {})
+      warn "On 1 December 2021, Visual Recognition will no longer be available. For more information, see https://github.com/watson-developer-cloud/ruby-sdk/tree/master#visual-recognition-deprecation."
       @__async_initialized__ = false
       defaults = {}
-      defaults[:version] = nil
-      defaults[:service_url] = "https://gateway.watsonplatform.net/visual-recognition/api"
+      defaults[:service_url] = DEFAULT_SERVICE_URL
+      defaults[:service_name] = DEFAULT_SERVICE_NAME
       defaults[:authenticator] = nil
+      defaults[:version] = nil
+      user_service_url = args[:service_url] unless args[:service_url].nil?
       args = defaults.merge(args)
       @version = args[:version]
       raise ArgumentError.new("version must be provided") if @version.nil?
 
-      args[:service_name] = "visual_recognition"
       args[:authenticator] = IBMCloudSdkCore::ConfigBasedAuthenticatorFactory.new.get_authenticator(service_name: args[:service_name]) if args[:authenticator].nil?
       super
+      @service_url = user_service_url unless user_service_url.nil?
     end
 
     #########################
@@ -95,6 +102,8 @@ module IBMWatson
     # @param threshold [Float] The minimum score a feature must have to be returned.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def analyze(collection_ids:, features:, images_file: nil, image_url: nil, threshold: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_ids must be provided") if collection_ids.nil?
 
       raise ArgumentError.new("features must be provided") if features.nil?
@@ -164,6 +173,8 @@ module IBMWatson
     # @param description [String] The description of the collection.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def create_collection(name: nil, description: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("watson_vision_combined", "V4", "create_collection")
@@ -197,6 +208,8 @@ module IBMWatson
     # Retrieves a list of collections for the service instance.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_collections
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("watson_vision_combined", "V4", "list_collections")
@@ -225,6 +238,8 @@ module IBMWatson
     # @param collection_id [String] The identifier of the collection.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_collection(collection_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       headers = {
@@ -261,6 +276,8 @@ module IBMWatson
     # @param description [String] The description of the collection.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def update_collection(collection_id:, name: nil, description: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       headers = {
@@ -297,6 +314,8 @@ module IBMWatson
     # @param collection_id [String] The identifier of the collection.
     # @return [nil]
     def delete_collection(collection_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       headers = {
@@ -319,6 +338,53 @@ module IBMWatson
       )
       nil
     end
+
+    ##
+    # @!method get_model_file(collection_id:, feature:, model_format:)
+    # Get a model.
+    # Download a model that you can deploy to detect objects in images. The collection
+    #   must include a generated model, which is indicated in the response for the
+    #   collection details as `"rscnn_ready": true`. If the value is `false`, train or
+    #   retrain the collection to generate the model.
+    #
+    #   Currently, the model format is specific to Android apps. For more information
+    #   about how to deploy the model to your app, see the [Watson Visual Recognition on
+    #   Android](https://github.com/matt-ny/rscnn) project in GitHub.
+    # @param collection_id [String] The identifier of the collection.
+    # @param feature [String] The feature for the model.
+    # @param model_format [String] The format of the returned model.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def get_model_file(collection_id:, feature:, model_format:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
+
+      raise ArgumentError.new("feature must be provided") if feature.nil?
+
+      raise ArgumentError.new("model_format must be provided") if model_format.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("watson_vision_combined", "V4", "get_model_file")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version,
+        "feature" => feature,
+        "model_format" => model_format
+      }
+
+      method_url = "/v4/collections/%s/model" % [ERB::Util.url_encode(collection_id)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: false
+      )
+      response
+    end
     #########################
     # Images
     #########################
@@ -354,6 +420,8 @@ module IBMWatson
     #   than 32 characters.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def add_images(collection_id:, images_file: nil, image_url: nil, training_data: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       headers = {
@@ -403,6 +471,8 @@ module IBMWatson
     # @param collection_id [String] The identifier of the collection.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_images(collection_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       headers = {
@@ -434,6 +504,8 @@ module IBMWatson
     # @param image_id [String] The identifier of the image.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_image_details(collection_id:, image_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       raise ArgumentError.new("image_id must be provided") if image_id.nil?
@@ -467,6 +539,8 @@ module IBMWatson
     # @param image_id [String] The identifier of the image.
     # @return [nil]
     def delete_image(collection_id:, image_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       raise ArgumentError.new("image_id must be provided") if image_id.nil?
@@ -503,6 +577,8 @@ module IBMWatson
     #   For example, an original 800 x 1000 image is resized to 160 x 200 pixels.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_jpeg_image(collection_id:, image_id:, size: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       raise ArgumentError.new("image_id must be provided") if image_id.nil?
@@ -539,6 +615,8 @@ module IBMWatson
     # @param collection_id [String] The identifier of the collection.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_object_metadata(collection_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       headers = {
@@ -574,6 +652,8 @@ module IBMWatson
     #   `sys-`.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def update_object_metadata(collection_id:, object:, new_object:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       raise ArgumentError.new("object must be provided") if object.nil?
@@ -614,6 +694,8 @@ module IBMWatson
     # @param object [String] The name of the object.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_object_metadata(collection_id:, object:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       raise ArgumentError.new("object must be provided") if object.nil?
@@ -648,6 +730,8 @@ module IBMWatson
     # @param object [String] The name of the object.
     # @return [nil]
     def delete_object(collection_id:, object:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       raise ArgumentError.new("object must be provided") if object.nil?
@@ -685,6 +769,8 @@ module IBMWatson
     # @param collection_id [String] The identifier of the collection.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def train(collection_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       headers = {
@@ -726,6 +812,8 @@ module IBMWatson
     # @param objects [Array[TrainingDataObject]] Training data for specific objects.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def add_image_training_data(collection_id:, image_id:, objects: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
 
       raise ArgumentError.new("image_id must be provided") if image_id.nil?
@@ -761,14 +849,16 @@ module IBMWatson
     # Get training usage.
     # Information about the completed training events. You can use this information to
     #   determine how close you are to the training limits for the month.
-    # @param start_time [String] The earliest day to include training events. Specify dates in YYYY-MM-DD format.
+    # @param start_time [Time] The earliest day to include training events. Specify dates in YYYY-MM-DD format.
     #   If empty or not specified, the earliest training event is included.
-    # @param end_time [String] The most recent day to include training events. Specify dates in YYYY-MM-DD
+    # @param end_time [Time] The most recent day to include training events. Specify dates in YYYY-MM-DD
     #   format. All events for the day are included. If empty or not specified, the
     #   current day is used. Specify the same value as `start_time` to request events for
     #   a single day.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_training_usage(start_time: nil, end_time: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("watson_vision_combined", "V4", "get_training_usage")
@@ -808,6 +898,8 @@ module IBMWatson
     # @param customer_id [String] The customer ID for which all data is to be deleted.
     # @return [nil]
     def delete_user_data(customer_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("customer_id must be provided") if customer_id.nil?
 
       headers = {