ibm_watson 0.16.1 → 0.17.0

data/lib/ibm_watson/tone_analyzer_v3.rb

@@ -55,16 +55,16 @@ module IBMWatson
     #   ready for a later version.
     # @option args url [String] The base url to use when contacting the service (e.g.
     #   "https://gateway.watsonplatform.net/tone-analyzer/api").
-    #   The base url may differ between Bluemix regions.
+    #   The base url may differ between IBM Cloud regions.
     # @option args username [String] The username used to authenticate with the service.
     #   Username and password credentials are only required to run your
-    #   application locally or outside of Bluemix. When running on
-    #   Bluemix, the credentials will be automatically loaded from the
+    #   application locally or outside of IBM Cloud. When running on
+    #   IBM Cloud, the credentials will be automatically loaded from the
     #   `VCAP_SERVICES` environment variable.
     # @option args password [String] The password used to authenticate with the service.
     #   Username and password credentials are only required to run your
-    #   application locally or outside of Bluemix. When running on
-    #   Bluemix, the credentials will be automatically loaded from the
+    #   application locally or outside of IBM Cloud. When running on
+    #   IBM Cloud, the credentials will be automatically loaded from the
     #   `VCAP_SERVICES` environment variable.
     # @option args iam_apikey [String] An API key that can be used to request IAM tokens. If
     #   this API key is provided, the SDK will manage the token and handle the
@@ -74,7 +74,9 @@ module IBMWatson
     #   it expires or reactively upon receiving a 401 from the service as any requests
     #   made with an expired token will fail.
     # @option args iam_url [String] An optional URL for the IAM service API. Defaults to
-    #   'https://iam.ng.bluemix.net/identity/token'.
+    #   'https://iam.cloud.ibm.com/identity/token'.
+    # @option args iam_client_id [String] An optional client id for the IAM service API.
+    # @option args iam_client_secret [String] An optional client secret for the IAM service API.
     def initialize(args = {})
       @__async_initialized__ = false
       defaults = {}
@@ -85,6 +87,8 @@ module IBMWatson
       defaults[:iam_apikey] = nil
       defaults[:iam_access_token] = nil
       defaults[:iam_url] = nil
+      defaults[:iam_client_id] = nil
+      defaults[:iam_client_secret] = nil
       args = defaults.merge(args)
       args[:vcap_services_name] = "tone_analyzer"
       super
@@ -99,7 +103,7 @@ module IBMWatson
     ##
     # @!method tone(tone_input:, sentences: nil, tones: nil, content_language: nil, accept_language: nil, content_type: nil)
     # Analyze general tone.
-    # Use the general purpose endpoint to analyze the tone of your input content. The
+    # Use the general-purpose endpoint to analyze the tone of your input content. The
     #   service analyzes the content for emotional and language tones. The method always
     #   analyzes the tone of the full document; by default, it also analyzes the tone of
     #   each individual sentence of the content.
@@ -118,7 +122,7 @@ module IBMWatson
     #   analyzes only the textual content.
     #
     #   **See also:** [Using the general-purpose
-    #   endpoint](https://cloud.ibm.com/docs/services/tone-analyzer/using-tone.html#using-the-general-purpose-endpoint).
+    #   endpoint](https://cloud.ibm.com/docs/services/tone-analyzer?topic=tone-analyzer-utgpe#utgpe).
     # @param tone_input [ToneInput] JSON, plain text, or HTML input that contains the content to be analyzed. For JSON
     #   input, provide an object of type `ToneInput`.
     # @param sentences [Boolean] Indicates whether the service is to return an analysis of each individual sentence
@@ -183,8 +187,8 @@ module IBMWatson
 
     ##
     # @!method tone_chat(utterances:, content_language: nil, accept_language: nil)
-    # Analyze customer engagement tone.
-    # Use the customer engagement endpoint to analyze the tone of customer service and
+    # Analyze customer-engagement tone.
+    # Use the customer-engagement endpoint to analyze the tone of customer service and
     #   customer support conversations. For each utterance of a conversation, the method
     #   reports the most prevalent subset of the following seven tones: sad, frustrated,
     #   satisfied, excited, polite, impolite, and sympathetic.
@@ -197,7 +201,7 @@ module IBMWatson
     #   character encoding for JSON content is effectively always UTF-8.
     #
     #   **See also:** [Using the customer-engagement
-    #   endpoint](https://cloud.ibm.com/docs/services/tone-analyzer/using-tone-chat.html#using-the-customer-engagement-endpoint).
+    #   endpoint](https://cloud.ibm.com/docs/services/tone-analyzer?topic=tone-analyzer-utco#utco).
     # @param utterances [Array[Utterance]] An array of `Utterance` objects that provides the input content that the service
     #   is to analyze.
     # @param content_language [String] The language of the input text for the request: English or French. Regional

data/lib/ibm_watson/version.rb

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

data/lib/ibm_watson/visual_recognition_v3.rb

@@ -47,7 +47,7 @@ module IBMWatson
     #   ready for a later version.
     # @option args url [String] The base url to use when contacting the service (e.g.
     #   "https://gateway.watsonplatform.net/visual-recognition/api").
-    #   The base url may differ between Bluemix regions.
+    #   The base url may differ between IBM Cloud regions.
     # @option args iam_apikey [String] An API key that can be used to request IAM tokens. If
     #   this API key is provided, the SDK will manage the token and handle the
     #   refreshing.
@@ -56,7 +56,9 @@ module IBMWatson
     #   it expires or reactively upon receiving a 401 from the service as any requests
     #   made with an expired token will fail.
     # @option args iam_url [String] An optional URL for the IAM service API. Defaults to
-    #   'https://iam.ng.bluemix.net/identity/token'.
+    #   'https://iam.cloud.ibm.com/identity/token'.
+    # @option args iam_client_id [String] An optional client id for the IAM service API.
+    # @option args iam_client_secret [String] An optional client secret for the IAM service API.
     def initialize(args = {})
       @__async_initialized__ = false
       defaults = {}
@@ -65,6 +67,8 @@ module IBMWatson
       defaults[:iam_apikey] = nil
       defaults[:iam_access_token] = nil
       defaults[:iam_url] = nil
+      defaults[:iam_client_id] = nil
+      defaults[:iam_client_secret] = nil
       args = defaults.merge(args)
       args[:vcap_services_name] = "watson_vision_combined"
       super
@@ -169,11 +173,11 @@ module IBMWatson
     #   to the Face model was removed. The identity information refers to the `name` of
     #   the person, `score`, and `type_hierarchy` knowledge graph. For details about the
     #   enhanced Face model, see the [Release
-    #   notes](https://cloud.ibm.com/docs/services/visual-recognition/release-notes.html#2april2018).
+    #   notes](https://cloud.ibm.com/docs/services/visual-recognition?topic=visual-recognition-release-notes#2april2018).
     #
     #   Analyze and get data about faces in images. Responses can include estimated age
     #   and gender. This feature uses a built-in model, so no training is necessary. The
-    #   Detect faces method does not support general biometric facial recognition.
+    #   **Detect faces** method does not support general biometric facial recognition.
     #
     #   Supported image formats include .gif, .jpg, .png, and .tif. The maximum image size
     #   is 10 MB. The minimum recommended pixel density is 32X32 pixels, but the service
@@ -315,32 +319,32 @@ module IBMWatson
     end
 
     ##
-    # @!method delete_classifier(classifier_id:)
-    # Delete a classifier.
-    # @param classifier_id [String] The ID of the classifier.
-    # @return [nil]
-    def delete_classifier(classifier_id:)
-      raise ArgumentError.new("classifier_id must be provided") if classifier_id.nil?
-
+    # @!method list_classifiers(verbose: nil)
+    # Retrieve a list of classifiers.
+    # @param verbose [Boolean] Specify `true` to return details about the classifiers. Omit this parameter to
+    #   return a brief list of classifiers.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_classifiers(verbose: nil)
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("watson_vision_combined", "V3", "delete_classifier")
+      sdk_headers = Common.new.get_sdk_headers("watson_vision_combined", "V3", "list_classifiers")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "verbose" => verbose
       }
 
-      method_url = "/v3/classifiers/%s" % [ERB::Util.url_encode(classifier_id)]
+      method_url = "/v3/classifiers"
 
-      request(
-        method: "DELETE",
+      response = request(
+        method: "GET",
         url: method_url,
         headers: headers,
         params: params,
         accept_json: true
       )
-      nil
+      response
     end
 
     ##
@@ -373,42 +377,13 @@ module IBMWatson
       response
     end
 
-    ##
-    # @!method list_classifiers(verbose: nil)
-    # Retrieve a list of classifiers.
-    # @param verbose [Boolean] Specify `true` to return details about the classifiers. Omit this parameter to
-    #   return a brief list of classifiers.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_classifiers(verbose: nil)
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("watson_vision_combined", "V3", "list_classifiers")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "version" => @version,
-        "verbose" => verbose
-      }
-
-      method_url = "/v3/classifiers"
-
-      response = request(
-        method: "GET",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: true
-      )
-      response
-    end
-
     ##
     # @!method update_classifier(classifier_id:, positive_examples: nil, negative_examples: nil, negative_examples_filename: nil)
     # Update a classifier.
     # Update a custom classifier by adding new positive or negative classes or by adding
     #   new images to existing classes. You must supply at least one set of positive or
     #   negative examples. For details, see [Updating custom
-    #   classifiers](https://cloud.ibm.com/docs/services/visual-recognition/customizing.html#updating-custom-classifiers).
+    #   classifiers](https://cloud.ibm.com/docs/services/visual-recognition?topic=visual-recognition-customizing#updating-custom-classifiers).
     #
     #   Encode all names in UTF-8 if they contain non-ASCII characters (.zip and image
     #   file names, and classifier and class names). The service assumes UTF-8 encoding if
@@ -483,6 +458,35 @@ module IBMWatson
       )
       response
     end
+
+    ##
+    # @!method delete_classifier(classifier_id:)
+    # Delete a classifier.
+    # @param classifier_id [String] The ID of the classifier.
+    # @return [nil]
+    def delete_classifier(classifier_id:)
+      raise ArgumentError.new("classifier_id must be provided") if classifier_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("watson_vision_combined", "V3", "delete_classifier")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v3/classifiers/%s" % [ERB::Util.url_encode(classifier_id)]
+
+      request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      nil
+    end
     #########################
     # Core ML
     #########################
@@ -530,7 +534,7 @@ module IBMWatson
     #   You associate a customer ID with data by passing the `X-Watson-Metadata` header
     #   with a request that passes data. For more information about personal data and
     #   customer IDs, see [Information
-    #   security](https://cloud.ibm.com/docs/services/visual-recognition/information-security.html).
+    #   security](https://cloud.ibm.com/docs/services/visual-recognition?topic=visual-recognition-information-security).
     # @param customer_id [String] The customer ID for which all data is to be deleted.
     # @return [nil]
     def delete_user_data(customer_id:)

data/test/integration/test_language_translator_v3.rb

@@ -17,7 +17,6 @@ if !ENV["LANGUAGE_TRANSLATOR_APIKEY"].nil? && !ENV["LANGUAGE_TRANSLATOR_URL"].ni
       )
       @service.add_default_headers(
         headers: {
-          "X-Watson-Learning-Opt-Out" => "1",
           "X-Watson-Test" => "1"
         }
       )
@@ -59,6 +58,43 @@ if !ENV["LANGUAGE_TRANSLATOR_APIKEY"].nil? && !ENV["LANGUAGE_TRANSLATOR_URL"].ni
       refute(service_response.nil?)
     end
 
+    def test_translate_document
+      @service = IBMWatson::LanguageTranslatorV3.new(
+        iam_apikey: ENV["LANGUAGE_TRANSLATOR_APIKEY"],
+        url: ENV["LANGUAGE_TRANSLATOR_URL"],
+        version: "2018-05-01"
+      )
+      @service.add_default_headers(
+        headers: {
+          "X-Watson-Test" => "1"
+        }
+      )
+
+      File.open(Dir.getwd + "/resources/translation_doc.txt") do |file_info|
+        service_response = service.translate_document(
+          file: file_info,
+          filename: "translation_doc.txt",
+          model_id: "en-fr"
+        ).result
+        refute(service_response.nil?)
+      end
+    end
+
+    def test_list_documents
+      @service = IBMWatson::LanguageTranslatorV3.new(
+        iam_apikey: ENV["LANGUAGE_TRANSLATOR_APIKEY"],
+        url: ENV["LANGUAGE_TRANSLATOR_URL"],
+        version: "2018-05-01"
+      )
+      @service.add_default_headers(
+        headers: {
+          "X-Watson-Test" => "1"
+        }
+      )
+      service_response = service.list_documents.result
+      refute(service_response.nil?)
+    end
+
     def test_list_identifiable_languages
       service_response = service.list_identifiable_languages.result
       refute(service_response.nil?)

data/test/unit/test_language_translator_v3.rb

@@ -9,14 +9,14 @@ WebMock.disable_net_connect!(allow_localhost: true)
 # Unit tests for the Language Translator V3 Service
 class LanguageTranslatorV3Test < Minitest::Test
   def test_translate_source_target
-    stub_request(:post, "https://iam.bluemix.net/identity/token")
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
       .with(
         body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
         headers: {
           "Accept" => "application/json",
           "Authorization" => "Basic Yng6Yng=",
           "Content-Type" => "application/x-www-form-urlencoded",
-          "Host" => "iam.bluemix.net"
+          "Host" => "iam.cloud.ibm.com"
         }
       ).to_return(
         status: 200,
@@ -57,14 +57,14 @@ class LanguageTranslatorV3Test < Minitest::Test
   end
 
   def test_translate_model_id
-    stub_request(:post, "https://iam.bluemix.net/identity/token")
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
       .with(
         body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
         headers: {
           "Accept" => "application/json",
           "Authorization" => "Basic Yng6Yng=",
           "Content-Type" => "application/x-www-form-urlencoded",
-          "Host" => "iam.bluemix.net"
+          "Host" => "iam.cloud.ibm.com"
         }
       ).to_return(
         status: 200,
@@ -108,14 +108,14 @@ class LanguageTranslatorV3Test < Minitest::Test
   end
 
   def test_identify
-    stub_request(:post, "https://iam.bluemix.net/identity/token")
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
       .with(
         body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
         headers: {
           "Accept" => "application/json",
           "Authorization" => "Basic Yng6Yng=",
           "Content-Type" => "application/x-www-form-urlencoded",
-          "Host" => "iam.bluemix.net"
+          "Host" => "iam.cloud.ibm.com"
         }
       ).to_return(
         status: 200,
@@ -165,14 +165,14 @@ class LanguageTranslatorV3Test < Minitest::Test
   end
 
   def test_list_identifiable_languages
-    stub_request(:post, "https://iam.bluemix.net/identity/token")
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
       .with(
         body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
         headers: {
           "Accept" => "application/json",
           "Authorization" => "Basic Yng6Yng=",
           "Content-Type" => "application/x-www-form-urlencoded",
-          "Host" => "iam.bluemix.net"
+          "Host" => "iam.cloud.ibm.com"
         }
       ).to_return(
         status: 200,
@@ -230,14 +230,14 @@ class LanguageTranslatorV3Test < Minitest::Test
   end
 
   def test_create_model
-    stub_request(:post, "https://iam.bluemix.net/identity/token")
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
       .with(
         body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
         headers: {
           "Accept" => "application/json",
           "Authorization" => "Basic Yng6Yng=",
           "Content-Type" => "application/x-www-form-urlencoded",
-          "Host" => "iam.bluemix.net"
+          "Host" => "iam.cloud.ibm.com"
         }
       ).to_return(
         status: 200,
@@ -300,14 +300,14 @@ class LanguageTranslatorV3Test < Minitest::Test
   end
 
   def test_delete_model
-    stub_request(:post, "https://iam.bluemix.net/identity/token")
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
       .with(
         body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
         headers: {
           "Accept" => "application/json",
           "Authorization" => "Basic Yng6Yng=",
           "Content-Type" => "application/x-www-form-urlencoded",
-          "Host" => "iam.bluemix.net"
+          "Host" => "iam.cloud.ibm.com"
         }
       ).to_return(
         status: 200,
@@ -342,14 +342,14 @@ class LanguageTranslatorV3Test < Minitest::Test
   end
 
   def test_get_model
-    stub_request(:post, "https://iam.bluemix.net/identity/token")
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
       .with(
         body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
         headers: {
           "Accept" => "application/json",
           "Authorization" => "Basic Yng6Yng=",
           "Content-Type" => "application/x-www-form-urlencoded",
-          "Host" => "iam.bluemix.net"
+          "Host" => "iam.cloud.ibm.com"
         }
       ).to_return(
         status: 200,
@@ -393,14 +393,14 @@ class LanguageTranslatorV3Test < Minitest::Test
   end
 
   def test_list_models
-    stub_request(:post, "https://iam.bluemix.net/identity/token")
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
       .with(
         body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
         headers: {
           "Accept" => "application/json",
           "Authorization" => "Basic Yng6Yng=",
           "Content-Type" => "application/x-www-form-urlencoded",
-          "Host" => "iam.bluemix.net"
+          "Host" => "iam.cloud.ibm.com"
         }
       ).to_return(
         status: 200,
@@ -456,4 +456,189 @@ class LanguageTranslatorV3Test < Minitest::Test
     service_response = service.list_models
     assert_equal(expected, service_response.result)
   end
+
+  def test_lis_documents
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
+      .with(
+        body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
+        headers: {
+          "Accept" => "application/json",
+          "Authorization" => "Basic Yng6Yng=",
+          "Content-Type" => "application/x-www-form-urlencoded",
+          "Host" => "iam.cloud.ibm.com"
+        }
+      ).to_return(
+        status: 200,
+        body: {
+          "access_token" => "oAeisG8yqPY7sFR_x66Z15",
+          "token_type" => "Bearer",
+          "expires_in" => 3600,
+          "expiration" => 1_524_167_011,
+          "refresh_token" => "jy4gl91BQ"
+        }.to_json,
+        headers: {}
+      )
+    service = IBMWatson::LanguageTranslatorV3.new(
+      version: "2018-05-01",
+      iam_apikey: "iam_apikey"
+    )
+    expected = {}
+    stub_request(:get, "https://gateway.watsonplatform.net/language-translator/api/v3/documents?version=2018-05-01")
+      .with(
+        headers: {
+          "Accept" => "application/json",
+          "Authorization" => "Bearer oAeisG8yqPY7sFR_x66Z15",
+          "Host" => "gateway.watsonplatform.net"
+        }
+      ).to_return(status: 200, body: expected.to_json, headers: { "Content-Type" => "application/json" })
+    service_response = service.list_documents
+    assert_equal(expected, service_response.result)
+  end
+
+  def test_translate_document
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
+      .with(
+        body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
+        headers: {
+          "Accept" => "application/json",
+          "Authorization" => "Basic Yng6Yng=",
+          "Content-Type" => "application/x-www-form-urlencoded",
+          "Host" => "iam.cloud.ibm.com"
+        }
+      ).to_return(
+        status: 200,
+        body: {
+          "access_token" => "oAeisG8yqPY7sFR_x66Z15",
+          "token_type" => "Bearer",
+          "expires_in" => 3600,
+          "expiration" => 1_524_167_011,
+          "refresh_token" => "jy4gl91BQ"
+        }.to_json,
+        headers: {}
+      )
+    service = IBMWatson::LanguageTranslatorV3.new(
+      version: "2018-05-01",
+      iam_apikey: "iam_apikey"
+    )
+    stub_request(:post, "https://gateway.watsonplatform.net/language-translator/api/v3/documents?version=2018-05-01")
+      .with do |req|
+        assert_equal req.headers["Accept"], "application/json"
+        assert_match %r{\Amultipart/form-data}, req.headers["Content-Type"]
+      end
+    file = File.open(Dir.getwd + "/resources/translation_doc.txt")
+    service.translate_document(file: file, filename: "file")
+  end
+
+  def test_get_document_status
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
+      .with(
+        body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
+        headers: {
+          "Accept" => "application/json",
+          "Authorization" => "Basic Yng6Yng=",
+          "Content-Type" => "application/x-www-form-urlencoded",
+          "Host" => "iam.cloud.ibm.com"
+        }
+      ).to_return(
+        status: 200,
+        body: {
+          "access_token" => "oAeisG8yqPY7sFR_x66Z15",
+          "token_type" => "Bearer",
+          "expires_in" => 3600,
+          "expiration" => 1_524_167_011,
+          "refresh_token" => "jy4gl91BQ"
+        }.to_json,
+        headers: {}
+      )
+    service = IBMWatson::LanguageTranslatorV3.new(
+      version: "2018-05-01",
+      iam_apikey: "iam_apikey"
+    )
+    expected = {}
+    stub_request(:get, "https://gateway.watsonplatform.net/language-translator/api/v3/documents/id?version=2018-05-01")
+      .with(
+        headers: {
+          "Accept" => "application/json",
+          "Authorization" => "Bearer oAeisG8yqPY7sFR_x66Z15",
+          "Host" => "gateway.watsonplatform.net"
+        }
+      ).to_return(status: 200, body: expected.to_json, headers: { "Content-Type" => "application/json" })
+    service_response = service.get_document_status(document_id: "id")
+    assert_equal(expected, service_response.result)
+  end
+
+  def test_get_translated_document
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
+      .with(
+        body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
+        headers: {
+          "Accept" => "application/json",
+          "Authorization" => "Basic Yng6Yng=",
+          "Content-Type" => "application/x-www-form-urlencoded",
+          "Host" => "iam.cloud.ibm.com"
+        }
+      ).to_return(
+        status: 200,
+        body: {
+          "access_token" => "oAeisG8yqPY7sFR_x66Z15",
+          "token_type" => "Bearer",
+          "expires_in" => 3600,
+          "expiration" => 1_524_167_011,
+          "refresh_token" => "jy4gl91BQ"
+        }.to_json,
+        headers: {}
+      )
+    service = IBMWatson::LanguageTranslatorV3.new(
+      version: "2018-05-01",
+      iam_apikey: "iam_apikey"
+    )
+    expected = {}
+    stub_request(:get, "https://gateway.watsonplatform.net/language-translator/api/v3/documents/id/translated_document?version=2018-05-01")
+      .with(
+        headers: {
+          "Accept" => "application/json",
+          "Authorization" => "Bearer oAeisG8yqPY7sFR_x66Z15",
+          "Host" => "gateway.watsonplatform.net"
+        }
+      ).to_return(status: 200, body: expected.to_json, headers: { "Content-Type" => "application/json" })
+    service_response = service.get_translated_document(document_id: "id")
+    assert_equal(expected, service_response.result)
+  end
+
+  def test_delete_document
+    stub_request(:post, "https://iam.cloud.ibm.com/identity/token")
+      .with(
+        body: { "apikey" => "iam_apikey", "grant_type" => "urn:ibm:params:oauth:grant-type:apikey", "response_type" => "cloud_iam" },
+        headers: {
+          "Accept" => "application/json",
+          "Authorization" => "Basic Yng6Yng=",
+          "Content-Type" => "application/x-www-form-urlencoded",
+          "Host" => "iam.cloud.ibm.com"
+        }
+      ).to_return(
+        status: 200,
+        body: {
+          "access_token" => "oAeisG8yqPY7sFR_x66Z15",
+          "token_type" => "Bearer",
+          "expires_in" => 3600,
+          "expiration" => 1_524_167_011,
+          "refresh_token" => "jy4gl91BQ"
+        }.to_json,
+        headers: {}
+      )
+    service = IBMWatson::LanguageTranslatorV3.new(
+      version: "2018-05-01",
+      iam_apikey: "iam_apikey"
+    )
+    expected = {}
+    stub_request(:delete, "https://gateway.watsonplatform.net/language-translator/api/v3/documents/id?version=2018-05-01")
+      .with(
+        headers: {
+          "Authorization" => "Bearer oAeisG8yqPY7sFR_x66Z15",
+          "Host" => "gateway.watsonplatform.net"
+        }
+      ).to_return(status: 200, body: expected.to_json, headers: { "Content-Type" => "application/json" })
+    service_response = service.delete_document(document_id: "id")
+    assert_nil(service_response)
+  end
 end

data/test/unit/test_speech_to_text_v1.rb

@@ -280,7 +280,7 @@ class SpeechToTextV1Test < Minitest::Test
     service_response = service.train_language_model(
       customization_id: "customid"
     )
-    assert_nil(service_response)
+    refute_nil(service_response)
 
     stub_request(:get, "https://stream.watsonplatform.net/speech-to-text/api/v1/customizations/modelid")
       .with(
@@ -353,7 +353,7 @@ class SpeechToTextV1Test < Minitest::Test
     service_response = service.train_acoustic_model(
       customization_id: "customid"
     )
-    assert_nil(service_response)
+    refute_nil(service_response)
 
     stub_request(:get, "https://stream.watsonplatform.net/speech-to-text/api/v1/acoustic_customizations/modelid")
       .with(