ibm_watson 0.11.0 → 0.12.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -20,8 +20,8 @@
20
20
  # can ignore most advertisements and other unwanted content.
21
21
  #
22
22
  # You can create [custom
23
- # models](https://console.bluemix.net/docs/services/natural-language-understanding/customizing.html) with Watson
24
- # Knowledge Studio to detect custom entities and relations in Natural Language
23
+ # models](https://cloud.ibm.com/docs/services/natural-language-understanding/customizing.html)
24
+ # with Watson Knowledge Studio to detect custom entities and relations in Natural Language
25
25
  # Understanding.
26
26
 
27
27
  require "concurrent"
@@ -88,6 +88,7 @@ module IBMWatson
88
88
  args[:vcap_services_name] = "natural-language-understanding"
89
89
  super
90
90
  @version = args[:version]
91
+ args[:display_name] = "Natural Language Understanding"
91
92
  end
92
93
 
93
94
  #########################
@@ -116,10 +117,10 @@ module IBMWatson
116
117
  # required.
117
118
  # @param clean [Boolean] Set this to `false` to disable webpage cleaning. To learn more about webpage
118
119
  # cleaning, see the [Analyzing
119
- # webpages](https://console.bluemix.net/docs/services/natural-language-understanding/analyzing-webpages.html)
120
+ # webpages](https://cloud.ibm.com/docs/services/natural-language-understanding/analyzing-webpages.html)
120
121
  # documentation.
121
122
  # @param xpath [String] An [XPath
122
- # query](https://console.bluemix.net/docs/services/natural-language-understanding/analyzing-webpages.html#xpath)
123
+ # query](https://cloud.ibm.com/docs/services/natural-language-understanding/analyzing-webpages.html#xpath)
123
124
  # to perform on `html` or `url` input. Results of the query will be appended to the
124
125
  # cleaned webpage text before it is analyzed. To analyze only the results of the
125
126
  # XPath query, set the `clean` parameter to `false`.
@@ -137,6 +138,7 @@ module IBMWatson
137
138
 
138
139
  headers = {
139
140
  }
141
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=natural-language-understanding;service_version=V1;operation_id=analyze"
140
142
 
141
143
  params = {
142
144
  "version" => @version
@@ -175,12 +177,13 @@ module IBMWatson
175
177
  # @!method list_models
176
178
  # List models.
177
179
  # Lists Watson Knowledge Studio [custom
178
- # models](https://console.bluemix.net/docs/services/natural-language-understanding/customizing.html) that are
179
- # deployed to your Natural Language Understanding service.
180
+ # models](https://cloud.ibm.com/docs/services/natural-language-understanding/customizing.html)
181
+ # that are deployed to your Natural Language Understanding service.
180
182
  # @return [DetailedResponse] A `DetailedResponse` object representing the response.
181
183
  def list_models
182
184
  headers = {
183
185
  }
186
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=natural-language-understanding;service_version=V1;operation_id=list_models"
184
187
 
185
188
  params = {
186
189
  "version" => @version
@@ -202,13 +205,14 @@ module IBMWatson
202
205
  # @!method delete_model(model_id:)
203
206
  # Delete model.
204
207
  # Deletes a custom model.
205
- # @param model_id [String] model_id of the model to delete.
208
+ # @param model_id [String] Model ID of the model to delete.
206
209
  # @return [DetailedResponse] A `DetailedResponse` object representing the response.
207
210
  def delete_model(model_id:)
208
211
  raise ArgumentError.new("model_id must be provided") if model_id.nil?
209
212
 
210
213
  headers = {
211
214
  }
215
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=natural-language-understanding;service_version=V1;operation_id=delete_model"
212
216
 
213
217
  params = {
214
218
  "version" => @version
@@ -26,9 +26,10 @@
26
26
  # is timestamped, can report temporal behavior.
27
27
  # * For information about the meaning of the models that the service uses to describe
28
28
  # personality characteristics, see [Personality
29
- # models](https://console.bluemix.net/docs/services/personality-insights/models.html).
29
+ # models](https://cloud.ibm.com/docs/services/personality-insights/models.html).
30
30
  # * For information about the meaning of the consumption preferences, see [Consumption
31
- # preferences](https://console.bluemix.net/docs/services/personality-insights/preferences.html).
31
+ # preferences](https://cloud.ibm.com/docs/services/personality-insights/preferences.html).
32
+ #
32
33
  #
33
34
  # **Note:** Request logging is disabled for the Personality Insights service. Regardless
34
35
  # of whether you set the `X-Watson-Learning-Opt-Out` request header, the service does not
@@ -98,6 +99,7 @@ module IBMWatson
98
99
  args[:vcap_services_name] = "personality_insights"
99
100
  super
100
101
  @version = args[:version]
102
+ args[:display_name] = "Personality Insights"
101
103
  end
102
104
 
103
105
  #########################
@@ -114,9 +116,11 @@ module IBMWatson
114
116
  #
115
117
  #
116
118
  # **See also:**
117
- # * [Requesting a profile](https://console.bluemix.net/docs/services/personality-insights/input.html)
119
+ # * [Requesting a
120
+ # profile](https://cloud.ibm.com/docs/services/personality-insights/input.html)
118
121
  # * [Providing sufficient
119
- # input](https://console.bluemix.net/docs/services/personality-insights/input.html#sufficient)
122
+ # input](https://cloud.ibm.com/docs/services/personality-insights/input.html#sufficient)
123
+ #
120
124
  #
121
125
  # ### Content types
122
126
  #
@@ -133,7 +137,8 @@ module IBMWatson
133
137
  # `Content-Type: text/plain;charset=utf-8`.
134
138
  #
135
139
  # **See also:** [Specifying request and response
136
- # formats](https://console.bluemix.net/docs/services/personality-insights/input.html#formats)
140
+ # formats](https://cloud.ibm.com/docs/services/personality-insights/input.html#formats)
141
+ #
137
142
  #
138
143
  # ### Accept types
139
144
  #
@@ -143,13 +148,14 @@ module IBMWatson
143
148
  # optional column headers for CSV output.
144
149
  #
145
150
  # **See also:**
146
- # * [Understanding a JSON profile](https://console.bluemix.net/docs/services/personality-insights/output.html)
151
+ # * [Understanding a JSON
152
+ # profile](https://cloud.ibm.com/docs/services/personality-insights/output.html)
147
153
  # * [Understanding a CSV
148
- # profile](https://console.bluemix.net/docs/services/personality-insights/output-csv.html).
154
+ # profile](https://cloud.ibm.com/docs/services/personality-insights/output-csv.html).
149
155
  # @param content [Content] A maximum of 20 MB of content to analyze, though the service requires much less
150
156
  # text; for more information, see [Providing sufficient
151
- # input](https://console.bluemix.net/docs/services/personality-insights/input.html#sufficient). For JSON input,
152
- # provide an object of type `Content`.
157
+ # input](https://cloud.ibm.com/docs/services/personality-insights/input.html#sufficient).
158
+ # For JSON input, provide an object of type `Content`.
153
159
  # @param accept [String] The type of the response. For more information, see **Accept types** in the method
154
160
  # description.
155
161
  # @param content_type [String] The type of the input. For more information, see **Content types** in the method
@@ -192,6 +198,7 @@ module IBMWatson
192
198
  "Content-Language" => content_language,
193
199
  "Accept-Language" => accept_language
194
200
  }
201
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=personality_insights;service_version=V3;operation_id=profile"
195
202
 
196
203
  params = {
197
204
  "version" => @version,
@@ -16,7 +16,7 @@
16
16
 
17
17
  # The IBM® Speech to Text service provides APIs that use IBM's speech-recognition
18
18
  # capabilities to produce transcripts of spoken audio. The service can transcribe speech
19
- # from various languages and audio formats. It addition to basic transcription, the
19
+ # from various languages and audio formats. In addition to basic transcription, the
20
20
  # service can produce detailed information about many different aspects of the audio. For
21
21
  # most languages, the service supports two sampling rates, broadband and narrowband. It
22
22
  # returns all JSON response content in the UTF-8 character set.
@@ -90,6 +90,7 @@ module IBMWatson
90
90
  args = defaults.merge(args)
91
91
  args[:vcap_services_name] = "speech_to_text"
92
92
  super
93
+ args[:display_name] = "Speech to Text"
93
94
  end
94
95
 
95
96
  #########################
@@ -109,6 +110,7 @@ module IBMWatson
109
110
  def list_models
110
111
  headers = {
111
112
  }
113
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=list_models"
112
114
 
113
115
  method_url = "/v1/models"
114
116
 
@@ -138,6 +140,7 @@ module IBMWatson
138
140
 
139
141
  headers = {
140
142
  }
143
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=get_model"
141
144
 
142
145
  method_url = "/v1/models/%s" % [ERB::Util.url_encode(model_id)]
143
146
 
@@ -375,6 +378,8 @@ module IBMWatson
375
378
  "Content-Type" => content_type
376
379
  }
377
380
  keywords *= "," unless keywords.nil?
381
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=recognize"
382
+
378
383
  params = {
379
384
  "model" => model,
380
385
  "language_customization_id" => language_customization_id,
@@ -487,7 +492,9 @@ module IBMWatson
487
492
  raise TypeError("Callback is not a derived class of RecognizeCallback") unless recognize_callback.is_a?(IBMWatson::RecognizeCallback)
488
493
 
489
494
  require_relative("./websocket/speech_to_text_websocket_listener.rb")
490
- headers = {}
495
+ headers = {
496
+ }
497
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=discovery;service_version=V1;operation_id=recognize_using_websocket"
491
498
  headers = conn.default_options.headers.to_hash unless conn.default_options.headers.to_hash.empty?
492
499
  if !token_manager.nil?
493
500
  access_token = token_manager.token
@@ -502,9 +509,7 @@ module IBMWatson
502
509
  "langauge_customization_id" => language_customization_id,
503
510
  "acoustic_customization_id" => acoustic_customization_id,
504
511
  "customization_weight" => customization_weight,
505
- "base_model_version" => base_model_version,
506
- "grammar_name" => grammar_name,
507
- "redaction" => redaction
512
+ "base_model_version" => base_model_version
508
513
  }
509
514
  params.delete_if { |_, v| v.nil? }
510
515
  url += "/v1/recognize?" + HTTP::URI.form_encode(params)
@@ -520,7 +525,9 @@ module IBMWatson
520
525
  "timestamps" => timestamps,
521
526
  "profanity_filter" => profanity_filter,
522
527
  "smart_formatting" => smart_formatting,
523
- "speaker_labels" => speaker_labels
528
+ "speaker_labels" => speaker_labels,
529
+ "grammar_name" => grammar_name,
530
+ "redaction" => redaction
524
531
  }
525
532
  options.delete_if { |_, v| v.nil? }
526
533
  WebSocketClient.new(audio: audio, chunk_data: chunk_data, options: options, recognize_callback: recognize_callback, url: url, headers: headers)
@@ -632,6 +639,7 @@ module IBMWatson
632
639
 
633
640
  headers = {
634
641
  }
642
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=register_callback"
635
643
 
636
644
  params = {
637
645
  "callback_url" => callback_url,
@@ -666,6 +674,7 @@ module IBMWatson
666
674
 
667
675
  headers = {
668
676
  }
677
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=unregister_callback"
669
678
 
670
679
  params = {
671
680
  "callback_url" => callback_url
@@ -949,6 +958,7 @@ module IBMWatson
949
958
  headers = {
950
959
  "Content-Type" => content_type
951
960
  }
961
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=create_job"
952
962
 
953
963
  params = {
954
964
  "model" => model,
@@ -1008,6 +1018,7 @@ module IBMWatson
1008
1018
  def check_jobs
1009
1019
  headers = {
1010
1020
  }
1021
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=check_jobs"
1011
1022
 
1012
1023
  method_url = "/v1/recognitions"
1013
1024
 
@@ -1046,6 +1057,7 @@ module IBMWatson
1046
1057
 
1047
1058
  headers = {
1048
1059
  }
1060
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=check_job"
1049
1061
 
1050
1062
  method_url = "/v1/recognitions/%s" % [ERB::Util.url_encode(id)]
1051
1063
 
@@ -1078,6 +1090,7 @@ module IBMWatson
1078
1090
 
1079
1091
  headers = {
1080
1092
  }
1093
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=delete_job"
1081
1094
 
1082
1095
  method_url = "/v1/recognitions/%s" % [ERB::Util.url_encode(id)]
1083
1096
 
@@ -1136,6 +1149,7 @@ module IBMWatson
1136
1149
 
1137
1150
  headers = {
1138
1151
  }
1152
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=create_language_model"
1139
1153
 
1140
1154
  data = {
1141
1155
  "name" => name,
@@ -1174,6 +1188,7 @@ module IBMWatson
1174
1188
  def list_language_models(language: nil)
1175
1189
  headers = {
1176
1190
  }
1191
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=list_language_models"
1177
1192
 
1178
1193
  params = {
1179
1194
  "language" => language
@@ -1208,6 +1223,7 @@ module IBMWatson
1208
1223
 
1209
1224
  headers = {
1210
1225
  }
1226
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=get_language_model"
1211
1227
 
1212
1228
  method_url = "/v1/customizations/%s" % [ERB::Util.url_encode(customization_id)]
1213
1229
 
@@ -1239,6 +1255,7 @@ module IBMWatson
1239
1255
 
1240
1256
  headers = {
1241
1257
  }
1258
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=delete_language_model"
1242
1259
 
1243
1260
  method_url = "/v1/customizations/%s" % [ERB::Util.url_encode(customization_id)]
1244
1261
 
@@ -1314,6 +1331,7 @@ module IBMWatson
1314
1331
 
1315
1332
  headers = {
1316
1333
  }
1334
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=train_language_model"
1317
1335
 
1318
1336
  params = {
1319
1337
  "word_type_to_add" => word_type_to_add,
@@ -1353,6 +1371,7 @@ module IBMWatson
1353
1371
 
1354
1372
  headers = {
1355
1373
  }
1374
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=reset_language_model"
1356
1375
 
1357
1376
  method_url = "/v1/customizations/%s/reset" % [ERB::Util.url_encode(customization_id)]
1358
1377
 
@@ -1395,6 +1414,7 @@ module IBMWatson
1395
1414
 
1396
1415
  headers = {
1397
1416
  }
1417
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=upgrade_language_model"
1398
1418
 
1399
1419
  method_url = "/v1/customizations/%s/upgrade_model" % [ERB::Util.url_encode(customization_id)]
1400
1420
 
@@ -1429,6 +1449,7 @@ module IBMWatson
1429
1449
 
1430
1450
  headers = {
1431
1451
  }
1452
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=list_corpora"
1432
1453
 
1433
1454
  method_url = "/v1/customizations/%s/corpora" % [ERB::Util.url_encode(customization_id)]
1434
1455
 
@@ -1527,6 +1548,7 @@ module IBMWatson
1527
1548
 
1528
1549
  headers = {
1529
1550
  }
1551
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=add_corpus"
1530
1552
 
1531
1553
  params = {
1532
1554
  "allow_overwrite" => allow_overwrite
@@ -1575,6 +1597,7 @@ module IBMWatson
1575
1597
 
1576
1598
  headers = {
1577
1599
  }
1600
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=get_corpus"
1578
1601
 
1579
1602
  method_url = "/v1/customizations/%s/corpora/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(corpus_name)]
1580
1603
 
@@ -1613,6 +1636,7 @@ module IBMWatson
1613
1636
 
1614
1637
  headers = {
1615
1638
  }
1639
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=delete_corpus"
1616
1640
 
1617
1641
  method_url = "/v1/customizations/%s/corpora/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(corpus_name)]
1618
1642
 
@@ -1662,6 +1686,7 @@ module IBMWatson
1662
1686
 
1663
1687
  headers = {
1664
1688
  }
1689
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=list_words"
1665
1690
 
1666
1691
  params = {
1667
1692
  "word_type" => word_type,
@@ -1752,6 +1777,7 @@ module IBMWatson
1752
1777
 
1753
1778
  headers = {
1754
1779
  }
1780
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=add_words"
1755
1781
 
1756
1782
  data = {
1757
1783
  "words" => words
@@ -1844,6 +1870,7 @@ module IBMWatson
1844
1870
 
1845
1871
  headers = {
1846
1872
  }
1873
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=add_word"
1847
1874
 
1848
1875
  data = {
1849
1876
  "word" => word,
@@ -1886,6 +1913,7 @@ module IBMWatson
1886
1913
 
1887
1914
  headers = {
1888
1915
  }
1916
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=get_word"
1889
1917
 
1890
1918
  method_url = "/v1/customizations/%s/words/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(word_name)]
1891
1919
 
@@ -1925,6 +1953,7 @@ module IBMWatson
1925
1953
 
1926
1954
  headers = {
1927
1955
  }
1956
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=delete_word"
1928
1957
 
1929
1958
  method_url = "/v1/customizations/%s/words/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(word_name)]
1930
1959
 
@@ -1959,6 +1988,7 @@ module IBMWatson
1959
1988
 
1960
1989
  headers = {
1961
1990
  }
1991
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=list_grammars"
1962
1992
 
1963
1993
  method_url = "/v1/customizations/%s/grammars" % [ERB::Util.url_encode(customization_id)]
1964
1994
 
@@ -2052,6 +2082,7 @@ module IBMWatson
2052
2082
  headers = {
2053
2083
  "Content-Type" => content_type
2054
2084
  }
2085
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=add_grammar"
2055
2086
 
2056
2087
  params = {
2057
2088
  "allow_overwrite" => allow_overwrite
@@ -2094,6 +2125,7 @@ module IBMWatson
2094
2125
 
2095
2126
  headers = {
2096
2127
  }
2128
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=get_grammar"
2097
2129
 
2098
2130
  method_url = "/v1/customizations/%s/grammars/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(grammar_name)]
2099
2131
 
@@ -2131,6 +2163,7 @@ module IBMWatson
2131
2163
 
2132
2164
  headers = {
2133
2165
  }
2166
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=delete_grammar"
2134
2167
 
2135
2168
  method_url = "/v1/customizations/%s/grammars/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(grammar_name)]
2136
2169
 
@@ -2178,6 +2211,7 @@ module IBMWatson
2178
2211
 
2179
2212
  headers = {
2180
2213
  }
2214
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=create_acoustic_model"
2181
2215
 
2182
2216
  data = {
2183
2217
  "name" => name,
@@ -2215,6 +2249,7 @@ module IBMWatson
2215
2249
  def list_acoustic_models(language: nil)
2216
2250
  headers = {
2217
2251
  }
2252
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=list_acoustic_models"
2218
2253
 
2219
2254
  params = {
2220
2255
  "language" => language
@@ -2249,6 +2284,7 @@ module IBMWatson
2249
2284
 
2250
2285
  headers = {
2251
2286
  }
2287
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=get_acoustic_model"
2252
2288
 
2253
2289
  method_url = "/v1/acoustic_customizations/%s" % [ERB::Util.url_encode(customization_id)]
2254
2290
 
@@ -2280,6 +2316,7 @@ module IBMWatson
2280
2316
 
2281
2317
  headers = {
2282
2318
  }
2319
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=delete_acoustic_model"
2283
2320
 
2284
2321
  method_url = "/v1/acoustic_customizations/%s" % [ERB::Util.url_encode(customization_id)]
2285
2322
 
@@ -2331,6 +2368,9 @@ module IBMWatson
2331
2368
  # * The custom model contains less than 10 minutes or more than 100 hours of audio
2332
2369
  # data.
2333
2370
  # * One or more of the custom model's audio resources is invalid.
2371
+ # * You passed an incompatible custom language model with the
2372
+ # `custom_language_model_id` query parameter. Both custom models must be based on
2373
+ # the same version of the same base model.
2334
2374
  #
2335
2375
  # **See also:** [Train the custom acoustic
2336
2376
  # model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-create.html#trainModel).
@@ -2340,13 +2380,17 @@ module IBMWatson
2340
2380
  # @param custom_language_model_id [String] The customization ID (GUID) of a custom language model that is to be used during
2341
2381
  # training of the custom acoustic model. Specify a custom language model that has
2342
2382
  # been trained with verbatim transcriptions of the audio resources or that contains
2343
- # words that are relevant to the contents of the audio resources.
2383
+ # words that are relevant to the contents of the audio resources. The custom
2384
+ # language model must be based on the same version of the same base model as the
2385
+ # custom acoustic model. The credentials specified with the request must own both
2386
+ # custom models.
2344
2387
  # @return [nil]
2345
2388
  def train_acoustic_model(customization_id:, custom_language_model_id: nil)
2346
2389
  raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
2347
2390
 
2348
2391
  headers = {
2349
2392
  }
2393
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=train_acoustic_model"
2350
2394
 
2351
2395
  params = {
2352
2396
  "custom_language_model_id" => custom_language_model_id
@@ -2384,6 +2428,7 @@ module IBMWatson
2384
2428
 
2385
2429
  headers = {
2386
2430
  }
2431
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=reset_acoustic_model"
2387
2432
 
2388
2433
  method_url = "/v1/acoustic_customizations/%s/reset" % [ERB::Util.url_encode(customization_id)]
2389
2434
 
@@ -2397,7 +2442,7 @@ module IBMWatson
2397
2442
  end
2398
2443
 
2399
2444
  ##
2400
- # @!method upgrade_acoustic_model(customization_id:, custom_language_model_id: nil)
2445
+ # @!method upgrade_acoustic_model(customization_id:, custom_language_model_id: nil, force: nil)
2401
2446
  # Upgrade a custom acoustic model.
2402
2447
  # Initiates the upgrade of a custom acoustic model to the latest version of its base
2403
2448
  # language model. The upgrade method is asynchronous. It can take on the order of
@@ -2429,16 +2474,25 @@ module IBMWatson
2429
2474
  # service that owns the custom model.
2430
2475
  # @param custom_language_model_id [String] If the custom acoustic model was trained with a custom language model, the
2431
2476
  # customization ID (GUID) of that custom language model. The custom language model
2432
- # must be upgraded before the custom acoustic model can be upgraded.
2477
+ # must be upgraded before the custom acoustic model can be upgraded. The credentials
2478
+ # specified with the request must own both custom models.
2479
+ # @param force [Boolean] If `true`, forces the upgrade of a custom acoustic model for which no input data
2480
+ # has been modified since it was last trained. Use this parameter only to force the
2481
+ # upgrade of a custom acoustic model that is trained with a custom language model,
2482
+ # and only if you receive a 400 response code and the message `No input data
2483
+ # modified since last training`. See [Upgrading a custom acoustic
2484
+ # model](https://cloud.ibm.com/docs/services/speech-to-text/custom-upgrade.html#upgradeAcoustic).
2433
2485
  # @return [nil]
2434
- def upgrade_acoustic_model(customization_id:, custom_language_model_id: nil)
2486
+ def upgrade_acoustic_model(customization_id:, custom_language_model_id: nil, force: nil)
2435
2487
  raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
2436
2488
 
2437
2489
  headers = {
2438
2490
  }
2491
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=upgrade_acoustic_model"
2439
2492
 
2440
2493
  params = {
2441
- "custom_language_model_id" => custom_language_model_id
2494
+ "custom_language_model_id" => custom_language_model_id,
2495
+ "force" => force
2442
2496
  }
2443
2497
 
2444
2498
  method_url = "/v1/acoustic_customizations/%s/upgrade_model" % [ERB::Util.url_encode(customization_id)]
@@ -2477,6 +2531,7 @@ module IBMWatson
2477
2531
 
2478
2532
  headers = {
2479
2533
  }
2534
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=list_audio"
2480
2535
 
2481
2536
  method_url = "/v1/acoustic_customizations/%s/audio" % [ERB::Util.url_encode(customization_id)]
2482
2537
 
@@ -2629,6 +2684,7 @@ module IBMWatson
2629
2684
  "Content-Type" => content_type,
2630
2685
  "Contained-Content-Type" => contained_content_type
2631
2686
  }
2687
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=add_audio"
2632
2688
 
2633
2689
  params = {
2634
2690
  "allow_overwrite" => allow_overwrite
@@ -2687,6 +2743,7 @@ module IBMWatson
2687
2743
 
2688
2744
  headers = {
2689
2745
  }
2746
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=get_audio"
2690
2747
 
2691
2748
  method_url = "/v1/acoustic_customizations/%s/audio/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(audio_name)]
2692
2749
 
@@ -2724,6 +2781,7 @@ module IBMWatson
2724
2781
 
2725
2782
  headers = {
2726
2783
  }
2784
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=delete_audio"
2727
2785
 
2728
2786
  method_url = "/v1/acoustic_customizations/%s/audio/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(audio_name)]
2729
2787
 
@@ -2760,6 +2818,7 @@ module IBMWatson
2760
2818
 
2761
2819
  headers = {
2762
2820
  }
2821
+ headers["X-IBMCloud-SDK-Analytics"] = "service_name=speech_to_text;service_version=V1;operation_id=delete_user_data"
2763
2822
 
2764
2823
  params = {
2765
2824
  "customer_id" => customer_id