ibm_watson 1.5.0 → 1.6.0

data/lib/ibm_watson/language_translator_v3.rb

@@ -15,7 +15,7 @@
 # limitations under the License.
 
 # IBM Watson™ Language Translator translates text from one language to another.
-# The service offers multiple IBM provided translation models that you can customize based
+# The service offers multiple IBM-provided translation models that you can customize based
 # on your unique terminology and language. Use Language Translator to take news from
 # across the globe and present it in your language, communicate with your customers in
 # their own language, and more.
@@ -33,7 +33,7 @@ module IBMWatson
   class LanguageTranslatorV3 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
     DEFAULT_SERVICE_NAME = "language_translator"
-    DEFAULT_SERVICE_URL = "https://gateway.watsonplatform.net/language-translator/api"
+    DEFAULT_SERVICE_URL = "https://api.us-south.language-translator.watson.cloud.ibm.com"
     ##
     # @!method initialize(args)
     # Construct a new client for the Language Translator service.
@@ -71,6 +71,38 @@ module IBMWatson
       @service_url = user_service_url unless user_service_url.nil?
     end
 
+    #########################
+    # Languages
+    #########################
+
+    ##
+    # @!method list_languages
+    # List supported languages.
+    # Lists all supported languages. The method returns an array of supported languages
+    #   with information about each language. Languages are listed in alphabetical order
+    #   by language code (for example, `af`, `ar`).
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_languages
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("language_translator", "V3", "list_languages")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v3/languages"
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
     #########################
     # Translation
     #########################
@@ -78,16 +110,21 @@ module IBMWatson
     ##
     # @!method translate(text:, model_id: nil, source: nil, target: nil)
     # Translate.
-    # Translates the input text from the source language to the target language. A
-    #   target language or translation model ID is required. The service attempts to
-    #   detect the language of the source text if it is not specified.
-    # @param text [Array[String]] Input text in UTF-8 encoding. Multiple entries will result in multiple
-    #   translations in the response.
-    # @param model_id [String] The model to use for translation. For example, `en-de` selects the IBM provided
-    #   base model for English to German translation. A model ID overrides the source and
-    #   target parameters and is required if you use a custom model. If no model ID is
-    #   specified, you must specify a target language.
-    # @param source [String] Language code that specifies the language of the source document.
+    # Translates the input text from the source language to the target language. Specify
+    #   a model ID that indicates the source and target languages, or specify the source
+    #   and target languages individually. You can omit the source language to have the
+    #   service attempt to detect the language from the input text. If you omit the source
+    #   language, the request must contain sufficient input text for the service to
+    #   identify the source language.
+    # @param text [Array[String]] Input text in UTF-8 encoding. Multiple entries result in multiple translations in
+    #   the response.
+    # @param model_id [String] The model to use for translation. For example, `en-de` selects the IBM-provided
+    #   base model for English-to-German translation. A model ID overrides the `source`
+    #   and `target` parameters and is required if you use a custom model. If no model ID
+    #   is specified, you must specify at least a target language.
+    # @param source [String] Language code that specifies the language of the input text. If omitted, the
+    #   service derives the source language from the input text. The input must contain
+    #   sufficient text for the service to identify the language reliably.
     # @param target [String] Language code that specifies the target language for translation. Required if
     #   model ID is not specified.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
@@ -197,10 +234,11 @@ module IBMWatson
     # Lists available translation models.
     # @param source [String] Specify a language code to filter results by source language.
     # @param target [String] Specify a language code to filter results by target language.
-    # @param default [Boolean] If the default parameter isn't specified, the service will return all models
+    # @param default [Boolean] If the `default` parameter isn't specified, the service returns all models
     #   (default and non-default) for each language pair. To return only default models,
-    #   set this to `true`. To return only non-default models, set this to `false`. There
-    #   is exactly one default model per language pair, the IBM provided base model.
+    #   set this parameter to `true`. To return only non-default models, set this
+    #   parameter to `false`. There is exactly one default model, the IBM-provided base
+    #   model, per language pair.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_models(source: nil, target: nil, default: nil)
       headers = {
@@ -230,36 +268,101 @@ module IBMWatson
     ##
     # @!method create_model(base_model_id:, forced_glossary: nil, parallel_corpus: nil, name: nil)
     # Create model.
-    # Uploads Translation Memory eXchange (TMX) files to customize a translation model.
+    # Uploads training files to customize a translation model. You can customize a model
+    #   with a forced glossary or with a parallel corpus:
+    #   * Use a *forced glossary* to force certain terms and phrases to be translated in a
+    #   specific way. You can upload only a single forced glossary file for a model. The
+    #   size of a forced glossary file for a custom model is limited to 10 MB.
+    #   * Use a *parallel corpus* when you want your custom model to learn from general
+    #   translation patterns in parallel sentences in your samples. What your model learns
+    #   from a parallel corpus can improve translation results for input text that the
+    #   model has not been trained on. You can upload multiple parallel corpora files with
+    #   a request. To successfully train with parallel corpora, the corpora files must
+    #   contain a cumulative total of at least 5000 parallel sentences. The cumulative
+    #   size of all uploaded corpus files for a custom model is limited to 250 MB.
+    #
+    #   Depending on the type of customization and the size of the uploaded files,
+    #   training time can range from minutes for a glossary to several hours for a large
+    #   parallel corpus. To create a model that is customized with a parallel corpus and a
+    #   forced glossary, customize the model with a parallel corpus first and then
+    #   customize the resulting model with a forced glossary.
+    #
+    #   You can create a maximum of 10 custom models per language pair. For more
+    #   information about customizing a translation model, including the formatting and
+    #   character restrictions for data files, see [Customizing your
+    #   model](https://cloud.ibm.com/docs/language-translator?topic=language-translator-customizing).
+    #
+    #
+    #   #### Supported file formats
+    #
+    #    You can provide your training data for customization in the following document
+    #   formats:
+    #   * **TMX** (`.tmx`) - Translation Memory eXchange (TMX) is an XML specification for
+    #   the exchange of translation memories.
+    #   * **XLIFF** (`.xliff`) - XML Localization Interchange File Format (XLIFF) is an
+    #   XML specification for the exchange of translation memories.
+    #   * **CSV** (`.csv`) - Comma-separated values (CSV) file with two columns for
+    #   aligned sentences and phrases. The first row contains the language code.
+    #   * **TSV** (`.tsv` or `.tab`) - Tab-separated values (TSV) file with two columns
+    #   for aligned sentences and phrases. The first row contains the language code.
+    #   * **JSON** (`.json`) - Custom JSON format for specifying aligned sentences and
+    #   phrases.
+    #   * **Microsoft Excel** (`.xls` or `.xlsx`) - Excel file with the first two columns
+    #   for aligned sentences and phrases. The first row contains the language code.
+    #
+    #   You must encode all text data in UTF-8 format. For more information, see
+    #   [Supported document formats for training
+    #   data](https://cloud.ibm.com/docs/language-translator?topic=language-translator-customizing#supported-document-formats-for-training-data).
+    #
+    #
+    #   #### Specifying file formats
+    #
+    #    You can indicate the format of a file by including the file extension with the
+    #   file name. Use the file extensions shown in **Supported file formats**.
+    #
+    #   Alternatively, you can omit the file extension and specify one of the following
+    #   `content-type` specifications for the file:
+    #   * **TMX** - `application/x-tmx+xml`
+    #   * **XLIFF** - `application/xliff+xml`
+    #   * **CSV** - `text/csv`
+    #   * **TSV** - `text/tab-separated-values`
+    #   * **JSON** - `application/json`
+    #   * **Microsoft Excel** -
+    #   `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`
+    #
+    #   For example, with `curl`, use the following `content-type` specification to
+    #   indicate the format of a CSV file named **glossary**:
+    #
+    #   `--form "forced_glossary=@glossary;type=text/csv"`.
+    # @param base_model_id [String] The ID of the translation model to use as the base for customization. To see
+    #   available models and IDs, use the `List models` method. Most models that are
+    #   provided with the service are customizable. In addition, all models that you
+    #   create with parallel corpora customization can be further customized with a forced
+    #   glossary.
+    # @param forced_glossary [File] A file with forced glossary terms for the source and target languages. The
+    #   customizations in the file completely overwrite the domain translation data,
+    #   including high frequency or high confidence phrase translations.
+    #
+    #   You can upload only one glossary file for a custom model, and the glossary can
+    #   have a maximum size of 10 MB. A forced glossary must contain single words or short
+    #   phrases. For more information, see **Supported file formats** in the method
+    #   description.
+    #
+    #   *With `curl`, use `--form forced_glossary=@{filename}`.*.
+    # @param parallel_corpus [File] A file with parallel sentences for the source and target languages. You can upload
+    #   multiple parallel corpus files in one request by repeating the parameter. All
+    #   uploaded parallel corpus files combined must contain at least 5000 parallel
+    #   sentences to train successfully. You can provide a maximum of 500,000 parallel
+    #   sentences across all corpora.
     #
-    #   You can either customize a model with a forced glossary or with a corpus that
-    #   contains parallel sentences. To create a model that is customized with a parallel
-    #   corpus <b>and</b> a forced glossary, proceed in two steps: customize with a
-    #   parallel corpus first and then customize the resulting model with a glossary.
-    #   Depending on the type of customization and the size of the uploaded corpora,
-    #   training can range from minutes for a glossary to several hours for a large
-    #   parallel corpus. You can upload a single forced glossary file and this file must
-    #   be less than <b>10 MB</b>. You can upload multiple parallel corpora tmx files. The
-    #   cumulative file size of all uploaded files is limited to <b>250 MB</b>. To
-    #   successfully train with a parallel corpus you must have at least <b>5,000 parallel
-    #   sentences</b> in your corpus.
+    #   A single entry in a corpus file can contain a maximum of 80 words. All corpora
+    #   files for a custom model can have a cumulative maximum size of 250 MB. For more
+    #   information, see **Supported file formats** in the method description.
     #
-    #   You can have a <b>maximum of 10 custom models per language pair</b>.
-    # @param base_model_id [String] The model ID of the model to use as the base for customization. To see available
-    #   models, use the `List models` method. Usually all IBM provided models are
-    #   customizable. In addition, all your models that have been created via parallel
-    #   corpus customization, can be further customized with a forced glossary.
-    # @param forced_glossary [File] A TMX file with your customizations. The customizations in the file completely
-    #   overwrite the domain translaton data, including high frequency or high confidence
-    #   phrase translations. You can upload only one glossary with a file size less than
-    #   10 MB per call. A forced glossary should contain single words or short phrases.
-    # @param parallel_corpus [File] A TMX file with parallel sentences for source and target language. You can upload
-    #   multiple parallel_corpus files in one request. All uploaded parallel_corpus files
-    #   combined, your parallel corpus must contain at least 5,000 parallel sentences to
-    #   train successfully.
+    #   *With `curl`, use `--form parallel_corpus=@{filename}`.*.
     # @param name [String] An optional model name that you can use to identify the model. Valid characters
-    #   are letters, numbers, dashes, underscores, spaces and apostrophes. The maximum
-    #   length is 32 characters.
+    #   are letters, numbers, dashes, underscores, spaces, and apostrophes. The maximum
+    #   length of the name is 32 characters.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def create_model(base_model_id:, forced_glossary: nil, parallel_corpus: nil, name: nil)
       raise ArgumentError.new("base_model_id must be provided") if base_model_id.nil?
@@ -339,7 +442,7 @@ module IBMWatson
     # Get model details.
     # Gets information about a translation model, including training status for custom
     #   models. Use this API call to poll the status of your customization request. A
-    #   successfully completed training will have a status of `available`.
+    #   successfully completed training has a status of `available`.
     # @param model_id [String] Model ID of the model to get.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_model(model_id:)
@@ -410,11 +513,13 @@ module IBMWatson
     #   Maximum file size: **20 MB**.
     # @param filename [String] The filename for file.
     # @param file_content_type [String] The content type of file.
-    # @param model_id [String] The model to use for translation. For example, `en-de` selects the IBM provided
-    #   base model for English to German translation. A model ID overrides the source and
-    #   target parameters and is required if you use a custom model. If no model ID is
-    #   specified, you must specify a target language.
-    # @param source [String] Language code that specifies the language of the source document.
+    # @param model_id [String] The model to use for translation. For example, `en-de` selects the IBM-provided
+    #   base model for English-to-German translation. A model ID overrides the `source`
+    #   and `target` parameters and is required if you use a custom model. If no model ID
+    #   is specified, you must specify at least a target language.
+    # @param source [String] Language code that specifies the language of the source document. If omitted, the
+    #   service derives the source language from the input text. The input must contain
+    #   sufficient text for the service to identify the language reliably.
     # @param target [String] Language code that specifies the target language for translation. Required if
     #   model ID is not specified.
     # @param document_id [String] To use a previously submitted document as the source for a new translation, enter

data/lib/ibm_watson/natural_language_classifier_v1.rb

@@ -32,7 +32,7 @@ module IBMWatson
   class NaturalLanguageClassifierV1 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
     DEFAULT_SERVICE_NAME = "natural_language_classifier"
-    DEFAULT_SERVICE_URL = "https://gateway.watsonplatform.net/natural-language-classifier/api"
+    DEFAULT_SERVICE_URL = "https://api.us-south.natural-language-classifier.watson.cloud.ibm.com"
     ##
     # @!method initialize(args)
     # Construct a new client for the Natural Language Classifier service.

data/lib/ibm_watson/natural_language_understanding_v1.rb

@@ -37,7 +37,7 @@ module IBMWatson
   class NaturalLanguageUnderstandingV1 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
     DEFAULT_SERVICE_NAME = "natural_language_understanding"
-    DEFAULT_SERVICE_URL = "https://gateway.watsonplatform.net/natural-language-understanding/api"
+    DEFAULT_SERVICE_URL = "https://api.us-south.natural-language-understanding.watson.cloud.ibm.com"
     ##
     # @!method initialize(args)
     # Construct a new client for the Natural Language Understanding service.
@@ -92,7 +92,7 @@ module IBMWatson
     #   - Relations
     #   - Semantic roles
     #   - Sentiment
-    #   - Syntax (Experimental).
+    #   - Syntax.
     #
     #   If a language for the input text is not specified with the `language` parameter,
     #   the service [automatically detects the
@@ -104,10 +104,9 @@ module IBMWatson
     #   required.
     # @param url [String] The webpage to analyze. One of the `text`, `html`, or `url` parameters is
     #   required.
-    # @param clean [Boolean] Set this to `false` to disable webpage cleaning. To learn more about webpage
-    #   cleaning, see the [Analyzing
-    #   webpages](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-analyzing-webpages)
-    #   documentation.
+    # @param clean [Boolean] Set this to `false` to disable webpage cleaning. For more information about
+    #   webpage cleaning, see [Analyzing
+    #   webpages](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-analyzing-webpages).
     # @param xpath [String] An [XPath
     #   query](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-analyzing-webpages#xpath)
     #   to perform on `html` or `url` input. Results of the query will be appended to the
@@ -117,9 +116,8 @@ module IBMWatson
     # @param return_analyzed_text [Boolean] Whether or not to return the analyzed text.
     # @param language [String] ISO 639-1 code that specifies the language of your text. This overrides automatic
     #   language detection. Language support differs depending on the features you include
-    #   in your analysis. See [Language
-    #   support](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-language-support)
-    #   for more information.
+    #   in your analysis. For more information, see [Language
+    #   support](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-language-support).
     # @param limit_text_characters [Fixnum] Sets the maximum number of characters that are processed by the service.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def analyze(features:, text: nil, html: nil, url: nil, clean: nil, xpath: nil, fallback_to_raw: nil, return_analyzed_text: nil, language: nil, limit_text_characters: nil)

data/lib/ibm_watson/personality_insights_v3.rb

@@ -48,7 +48,7 @@ module IBMWatson
   class PersonalityInsightsV3 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
     DEFAULT_SERVICE_NAME = "personality_insights"
-    DEFAULT_SERVICE_URL = "https://gateway.watsonplatform.net/personality-insights/api"
+    DEFAULT_SERVICE_URL = "https://api.us-south.personality-insights.watson.cloud.ibm.com"
     ##
     # @!method initialize(args)
     # Construct a new client for the Personality Insights service.

data/lib/ibm_watson/speech_to_text_v1.rb

@@ -14,12 +14,12 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# The IBM® Speech to Text service provides APIs that use IBM's speech-recognition
-# capabilities to produce transcripts of spoken audio. The service can transcribe speech
-# from various languages and audio formats. In addition to basic transcription, the
-# service can produce detailed information about many different aspects of the audio. For
-# most languages, the service supports two sampling rates, broadband and narrowband. It
-# returns all JSON response content in the UTF-8 character set.
+# The IBM Watson™ Speech to Text service provides APIs that use IBM's
+# speech-recognition capabilities to produce transcripts of spoken audio. The service can
+# transcribe speech from various languages and audio formats. In addition to basic
+# transcription, the service can produce detailed information about many different aspects
+# of the audio. For most languages, the service supports two sampling rates, broadband and
+# narrowband. It returns all JSON response content in the UTF-8 character set.
 #
 # For speech recognition, the service supports synchronous and asynchronous HTTP
 # Representational State Transfer (REST) interfaces. It also supports a WebSocket
@@ -51,7 +51,7 @@ module IBMWatson
   class SpeechToTextV1 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
     DEFAULT_SERVICE_NAME = "speech_to_text"
-    DEFAULT_SERVICE_URL = "https://stream.watsonplatform.net/speech-to-text/api"
+    DEFAULT_SERVICE_URL = "https://api.us-south.speech-to-text.watson.cloud.ibm.com"
     ##
     # @!method initialize(args)
     # Construct a new client for the Speech to Text service.
@@ -84,7 +84,8 @@ module IBMWatson
     # List models.
     # Lists all language models that are available for use with the service. The
     #   information includes the name of the model and its minimum sampling rate in Hertz,
-    #   among other things.
+    #   among other things. The ordering of the list of models can change from call to
+    #   call; do not rely on an alphabetized or static list of models.
     #
     #   **See also:** [Languages and
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models#models).
@@ -335,11 +336,9 @@ module IBMWatson
     #   parameter to be `true`, regardless of whether you specify `false` for the
     #   parameter.
     #
-    #   **Note:** Applies to US English, German, Japanese, Korean, and Spanish (both
-    #   broadband and narrowband models) and UK English (narrowband model) transcription
-    #   only. To determine whether a language model supports speaker labels, you can also
-    #   use the **Get a model** method and check that the attribute `speaker_labels` is
-    #   set to `true`.
+    #   **Note:** Applies to US English, Australian English, German, Japanese, Korean, and
+    #   Spanish (both broadband and narrowband models) and UK English (narrowband model)
+    #   transcription only.
     #
     #   See [Speaker
     #   labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#speaker_labels).
@@ -681,9 +680,9 @@ module IBMWatson
     # @!method register_callback(callback_url:, user_secret: nil)
     # Register a callback.
     # Registers a callback URL with the service for use with subsequent asynchronous
-    #   recognition requests. The service attempts to register, or white-list, the
-    #   callback URL if it is not already registered by sending a `GET` request to the
-    #   callback URL. The service passes a random alphanumeric challenge string via the
+    #   recognition requests. The service attempts to register, or allowlist, the callback
+    #   URL if it is not already registered by sending a `GET` request to the callback
+    #   URL. The service passes a random alphanumeric challenge string via the
     #   `challenge_string` parameter of the request. The request includes an `Accept`
     #   header that specifies `text/plain` as the required response type.
     #
@@ -695,9 +694,9 @@ module IBMWatson
     #
     #   The service sends only a single `GET` request to the callback URL. If the service
     #   does not receive a reply with a response code of 200 and a body that echoes the
-    #   challenge string sent by the service within five seconds, it does not white-list
+    #   challenge string sent by the service within five seconds, it does not allowlist
     #   the URL; it instead sends status code 400 in response to the **Register a
-    #   callback** request. If the requested callback URL is already white-listed, the
+    #   callback** request. If the requested callback URL is already allowlisted, the
     #   service responds to the initial registration request with response code 200.
     #
     #   If you specify a user secret with the request, the service uses it as a key to
@@ -715,7 +714,7 @@ module IBMWatson
     #   **See also:** [Registering a callback
     #   URL](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#register).
     # @param callback_url [String] An HTTP or HTTPS URL to which callback notifications are to be sent. To be
-    #   white-listed, the URL must successfully echo the challenge string during URL
+    #   allowlisted, the URL must successfully echo the challenge string during URL
     #   verification. During verification, the client can also check the signature that
     #   the service sends in the `X-Callback-Signature` header to verify the origin of the
     #   request.
@@ -753,7 +752,7 @@ module IBMWatson
     ##
     # @!method unregister_callback(callback_url:)
     # Unregister a callback.
-    # Unregisters a callback URL that was previously white-listed with a **Register a
+    # Unregisters a callback URL that was previously allowlisted with a **Register a
     #   callback** request for use with the asynchronous interface. Once unregistered, the
     #   URL can no longer be used with asynchronous recognition requests.
     #
@@ -891,7 +890,7 @@ module IBMWatson
     #   [Languages and
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models#models).
     # @param callback_url [String] A URL to which callback notifications are to be sent. The URL must already be
-    #   successfully white-listed by using the **Register a callback** method. You can
+    #   successfully allowlisted by using the **Register a callback** method. You can
     #   include the same callback URL with any number of job creation requests. Omit the
     #   parameter to poll the service for job completion and results.
     #
@@ -1024,11 +1023,9 @@ module IBMWatson
     #   parameter to be `true`, regardless of whether you specify `false` for the
     #   parameter.
     #
-    #   **Note:** Applies to US English, German, Japanese, Korean, and Spanish (both
-    #   broadband and narrowband models) and UK English (narrowband model) transcription
-    #   only. To determine whether a language model supports speaker labels, you can also
-    #   use the **Get a model** method and check that the attribute `speaker_labels` is
-    #   set to `true`.
+    #   **Note:** Applies to US English, Australian English, German, Japanese, Korean, and
+    #   Spanish (both broadband and narrowband models) and UK English (narrowband model)
+    #   transcription only.
     #
     #   See [Speaker
     #   labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#speaker_labels).
@@ -1393,8 +1390,10 @@ module IBMWatson
     #   **See also:** [Listing custom language
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language).
     # @param language [String] The identifier of the language for which custom language or custom acoustic models
-    #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
-    #   language or custom acoustic models that are owned by the requesting credentials.
+    #   are to be returned. Omit the parameter to see all custom language or custom
+    #   acoustic models that are owned by the requesting credentials. **Note:** The
+    #   `ar-AR` (Modern Standard Arabic) and `zh-CN` (Mandarin Chinese) languages are not
+    #   available for language model customization.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_language_models(language: nil)
       headers = {
@@ -2513,8 +2512,10 @@ module IBMWatson
     #   **See also:** [Listing custom acoustic
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAcousticModels#listModels-acoustic).
     # @param language [String] The identifier of the language for which custom language or custom acoustic models
-    #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
-    #   language or custom acoustic models that are owned by the requesting credentials.
+    #   are to be returned. Omit the parameter to see all custom language or custom
+    #   acoustic models that are owned by the requesting credentials. **Note:** The
+    #   `ar-AR` (Modern Standard Arabic) and `zh-CN` (Mandarin Chinese) languages are not
+    #   available for language model customization.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_acoustic_models(language: nil)
       headers = {
@@ -3131,10 +3132,15 @@ module IBMWatson
     #   deletes all data for the customer ID, regardless of the method by which the
     #   information was added. The method has no effect if no data is associated with the
     #   customer ID. You must issue the request with credentials for the same instance of
-    #   the service that was used to associate the customer ID with the data.
-    #
-    #   You associate a customer ID with data by passing the `X-Watson-Metadata` header
-    #   with a request that passes the data.
+    #   the service that was used to associate the customer ID with the data. You
+    #   associate a customer ID with data by passing the `X-Watson-Metadata` header with a
+    #   request that passes the data.
+    #
+    #   **Note:** If you delete an instance of the service from the service console, all
+    #   data associated with that service instance is automatically deleted. This includes
+    #   all custom language models, corpora, grammars, and words; all custom acoustic
+    #   models and audio resources; all registered endpoints for the asynchronous HTTP
+    #   interface; and all data related to speech recognition requests.
     #
     #   **See also:** [Information
     #   security](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-information-security#information-security).