feat: regenrate services using current API def

Author: mamoonraja

Scripts/Services/LanguageTranslator/V3/LanguageTranslatorService.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2020.
+* (C) Copyright IBM Corp. 2020.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -91,8 +91,11 @@ public LanguageTranslatorService(string versionDate, Authenticator authenticator
         /// <summary>
         /// 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`).
+        /// Lists all supported languages for translation. 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`). In addition to basic information about each language, the response indicates whether the
+        /// language is `supported_as_source` for translation and `supported_as_target` for translation. It also lists
+        /// whether the language is `identifiable`.
         /// </summary>
         /// <param name="callback">The callback function that is invoked when the operation completes.</param>
         /// <returns><see cref="Languages" />Languages</returns>
@@ -162,10 +165,13 @@ private void OnListLanguagesResponse(RESTConnector.Request req, RESTConnector.Re
         /// 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.
+        ///
+        /// You can translate a maximum of 50 KB (51,200 bytes) of text with a single request. All input text must be
+        /// encoded in UTF-8 format.
         /// </summary>
         /// <param name="callback">The callback function that is invoked when the operation completes.</param>
-        /// <param name="text">Input text in UTF-8 encoding. Multiple entries result in multiple translations in the
-        /// response.</param>
+        /// <param name="text">Input text in UTF-8 encoding. Submit a maximum of 50 KB (51,200 bytes) of text with a
+        /// single request. Multiple elements result in multiple translations in the response.</param>
         /// <param name="modelId">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
@@ -501,9 +507,11 @@ private void OnListModelsResponse(RESTConnector.Request req, RESTConnector.Respo
         /// * **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.
+        /// The first row must have two language codes. The first column is for the source language code, and the second
+        /// column is for the target 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.
+        /// phrases. The first row must have two language codes. The first column is for the source language code, and
+        /// the second column is for the target 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.
@@ -844,15 +852,15 @@ private void OnListDocumentsResponse(RESTConnector.Request req, RESTConnector.Re
         /// Translate document.
         ///
         /// Submit a document for translation. You can submit the document contents in the `file` parameter, or you can
-        /// reference a previously submitted document by document ID.
+        /// reference a previously submitted document by document ID. The maximum file size for document translation is
+        /// * 20 MB for service instances on the Standard, Advanced, and Premium plans
+        /// * 2 MB for service instances on the Lite plan.
         /// </summary>
         /// <param name="callback">The callback function that is invoked when the operation completes.</param>
-        /// <param name="file">The contents of the source file to translate.
-        ///
-        /// [Supported file
-        /// types](https://cloud.ibm.com/docs/language-translator?topic=language-translator-document-translator-tutorial#supported-file-formats)
-        ///
-        /// Maximum file size: **20 MB**.</param>
+        /// <param name="file">The contents of the source file to translate. The maximum file size for document
+        /// translation is 20 MB for service instances on the Standard, Advanced, and Premium plans, and 2 MB for
+        /// service instances on the Lite plan. For more information, see [Supported file formats
+        /// (Beta)](https://cloud.ibm.com/docs/language-translator?topic=language-translator-document-translator-tutorial#supported-file-formats).</param>
         /// <param name="filename">The filename for file.</param>
         /// <param name="fileContentType">The content type of file. (optional)</param>
         /// <param name="modelId">The model to use for translation. For example, `en-de` selects the IBM-provided base

Scripts/Services/NaturalLanguageUnderstanding/V1/Model/Model.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2020.
+* (C) Copyright IBM Corp. 2020.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -89,8 +89,7 @@ public class StatusValue
         [JsonProperty("model_version", NullValueHandling = NullValueHandling.Ignore)]
         public string ModelVersion { get; set; }
         /// <summary>
-        /// (Deprecated — use `model_version`) The model version, if it was manually provided in Watson Knowledge
-        /// Studio.
+        /// Deprecated — use `model_version`.
         /// </summary>
         [JsonProperty("version", NullValueHandling = NullValueHandling.Ignore)]
         public string Version { get; set; }

Scripts/Services/NaturalLanguageUnderstanding/V1/NaturalLanguageUnderstandingService.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2020.
+* (C) Copyright IBM Corp. 2020.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -101,7 +101,8 @@ public NaturalLanguageUnderstandingService(string versionDate, Authenticator aut
         /// - Relations
         /// - Semantic roles
         /// - Sentiment
-        /// - Syntax.
+        /// - Syntax
+        /// - Summarization (Experimental)
         ///
         /// If a language for the input text is not specified with the `language` parameter, the service [automatically
         /// detects the

Scripts/Services/SpeechToText/V1/SpeechToTextService.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2020.
+* (C) Copyright IBM Corp. 2020.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -1682,8 +1682,11 @@ private void OnCreateLanguageModelResponse(RESTConnector.Request req, RESTConnec
         /// <param name="callback">The callback function that is invoked when the operation completes.</param>
         /// <param name="language">The identifier of the language for which custom language or custom acoustic models
         /// 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. (optional)</param>
+        /// by the requesting credentials.
+        ///
+        /// To determine the languages for which customization is available, see [Language support for
+        /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
+        /// (optional)</param>
         /// <returns><see cref="LanguageModels" />LanguageModels</returns>
         public bool ListLanguageModels(Callback<LanguageModels> callback, string language = null)
         {
@@ -3560,8 +3563,11 @@ private void OnCreateAcousticModelResponse(RESTConnector.Request req, RESTConnec
         /// <param name="callback">The callback function that is invoked when the operation completes.</param>
         /// <param name="language">The identifier of the language for which custom language or custom acoustic models
         /// 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. (optional)</param>
+        /// by the requesting credentials.
+        ///
+        /// To determine the languages for which customization is available, see [Language support for
+        /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
+        /// (optional)</param>
         /// <returns><see cref="AcousticModels" />AcousticModels</returns>
         public bool ListAcousticModels(Callback<AcousticModels> callback, string language = null)
         {
@@ -3779,12 +3785,12 @@ private void OnDeleteAcousticModelResponse(RESTConnector.Request req, RESTConnec
         /// model on the latest audio data. The custom acoustic model does not reflect its changed data until you train
         /// it. You must use credentials for the instance of the service that owns a model to train it.
         ///
-        /// The training method is asynchronous. It can take on the order of minutes or hours to complete depending on
-        /// the total amount of audio data on which the custom acoustic model is being trained and the current load on
-        /// the service. Typically, training a custom acoustic model takes approximately two to four times the length of
-        /// its audio data. The actual time depends on the model being trained and the nature of the audio, such as
-        /// whether the audio is clean or noisy. The method returns an HTTP 200 response code to indicate that the
-        /// training process has begun.
+        /// The training method is asynchronous. Training time depends on the cumulative amount of audio data that the
+        /// custom acoustic model contains and the current load on the service. When you train or retrain a model, the
+        /// service uses all of the model's audio data in the training. Training a custom acoustic model takes
+        /// approximately as long as the length of its cumulative audio data. For example, it takes approximately 2
+        /// hours to train a model that contains a total of 2 hours of audio. The method returns an HTTP 200 response
+        /// code to indicate that the training process has begun.
         ///
         /// You can monitor the status of the training by using the **Get a custom acoustic model** method to poll the
         /// model's status. Use a loop to check the status once a minute. The method returns an `AcousticModel` object