v4.0.0

Breaking changes

Assistant v1

Model changes

• CreateCounterexample renamed to Counterexample
• CreateDialogNode renamed to DialogNode
• CreateExample renamed to Example
• EntityExport renamed to Entity
• InputData renamed to MessageInput
• IntentExport renamed to Intent
• LogExport renamed to Log
• Mentions renamed to Mention
• ValueExport renamed to Value
• WorkspaceExport renamed to Workspace

Property changes

• DialogNode
  • dialogNodeId renamed to dialogNode
• Entity
  • entityName renamed to entity
• EntityMention
  • exampleText renamed to text
  • intentName renamed to intent
• Example
  • exampleText renamed to text
• Intent
  • intentName renamed to intent
• Synonym
  • synonymText renamed to synonym
• Value
  • valueText renamed to value

Other

• MessageInput is now dynamic
• addValue() method in CreateEntityOptionsBuilder renamed to addValues()

Assistant v2

Model changes

• MessageContextSkill has been deleted

Compare and Comply

Model changes

• Category renamed to CategoryComparison
• TypeLabel renamed to TypeLabelComparison

Property changes

• BodyCells
  • rowHeaderIds type changed from List<String> to List<RowHeaderIds>
  • rowHeaderTexts type changed from List<String> to List<RowHeaderTexts>
  • rowHeaderTextsNormalized type changed from List<String> to List<RowHeaderTextsNormalized>
  • columnHeaderIds type changed from List<String> to List<ColumnHeaderIds>
  • columnHeaderTexts type changed from List<String> to List<ColumnHeaderTexts>
  • columnHeaderTextsNormalized type changed from List<String> to List<ColumnHeaderTextsNormalized>
• ClassifyElementsOptions
  • modelId renamed to model
  • filename has been deleted
• CompareDocumentsOptions
  • modelId renamed to model
  • file1Filename has been deleted
  • file2Filename has been deleted
• ConvertToHtmlOptions
  • modelId renamed to model
• CreateBatchOptions
  • modelId renamed to model
  • inputCredentialsFilename has been deleted
  • outputCredentialsFilename has been deleted
• DeleteFeedbackOptions
  • modelId renamed to model
• ExtractTablesOptions
  • modelId renamed to model
  • filename has been deleted
• GetFeedbackOptions
  • modelId renamed to model
• UpdateBatchOptions
  • modelId renamed to model

Discovery

Property changes

• CreateConfigurationOptions
  • name is now required
• CreateExpansionsOptions
  • expansions is now required
• DiskUsage
  • percentUsed has been deleted
  • total has been deleted
  • totalBytes has been deleted
  • used has been deleted
• DocumentStatus
  • created has been deleted
  • updated has been deleted
• FederatedQueryOptions
  • collectionIds type changed from List<String> to String
  • passagesFields type changed from List<String> to String
  • returnFields type changed from List<String> to String
  • similarDocumentIds type changed from List<String> to String
  • similarFields type changed from List<String> to String
  • sort type changed from List<String> to String
• IndexCapacity
  • memoryUsage has been deleted
• QueryResult
  • score has been deleted
• QueryNoticesResult
  • score has been deleted
• QueryOptions
  • collectionIds type changed from List<String> to String
  • passagesFields type changed from List<String> to String
  • returnFields type changed from List<String> to String
  • similarDocumentIds type changed from List<String> to String
  • similarFields type changed from List<String> to String
  • sort type changed from List<String> to String
• UpdateConfigurationOptions
  • name is now required

Other

• CreateConfigurationOptionsBuilder
  • CreateConfigurationOptionsBuilder(String environmentId) changed to CreateConfigurationOptionsBuilder(String environmentId, String name)
  • addEnrichments() renamed to addEnrichment()
  • addNormalizations() renamed to addNormalization()
• CreateExpansionsOptionsBuilder
  • CreateExpansionsOptionsBuilder(String environmentId, String collectionId) changed to CreateExpansionsOptionsBuilder(String environmentId, String collectionId, List<Expansion> expansions)
• UpdateConfigurationOptionsBuilder
  • UpdateConfigurationOptionsBuilder(String environmentId, String configurationId) changed to UpdateConfigurationOptionsBuilder(String environmentId, String configurationId, String name)
  • addEnrichments() renamed to addEnrichment()
  • addNormalizations() renamed to addNormalization()

Language Translator

Property changes

• CreateModelOptions
  • forcedGlossaryFilename has been deleted
  • parallelCorpusFilename has been deleted

Natural Language Classifier

Property changes

• CreateClassifierOptions
  • metadataFilename has been deleted
  • trainingDataFilename has been deleted

Other

• Old versions of classify(), createClassifier(), deleteClassifier(), getClassifier(), and getClassifiers() without options model parameters have been removed

Natural Language Understanding

Model changes

• CategoriesOptions is no longer dynamic
• MetadataOptions is no longer dynamic
• MetadataResult renamed to AnalysisResultsMetadata
• SemanticRolesAction renamed to SemanticRolesResultAction
• SemanticRolesObject renamed to SemanticRolesResultObject
• SemanticRolesSubject renamed to SemanticRolesResultSubject
• Usage renamed to AnalysisResultsUsage

Speech to Text

Property changes

• AddCorpusOptions
  • corpusFilename has been deleted
• AudioListing
  • duration type changed from Double to Long
• AudioResource
  • duration type changed from Double to Long

Other

• CreateJobOptionsBuilder constructor with InputStream audio and String contentType parameters removed
• RecognizeOptionsBuilder constructor with InputStream audio and String contentType parameters removed

Text to Speech

Property changes

• AddWordOptions
  • translation is now required
• AddWordsOptions
  • words is now required

Visual Recognition

Property changes

• ClassifyOptions
  • parameters property has been deleted
  • imagesFilename now required if imagesFile is specified
• CreateClassifierOptions
  • positiveExamplesFilename property has been deleted
• DetectFacesOptions
  • parameters property has been deleted
  • imagesFilename now required if imagesFile is specified
• UpdateClassifierOptions
  • positiveExamplesFilename property has been deleted

Non-breaking changes

Assistant v1

Model changes

• Counterexample
  • Now has a builder
• CreateCounterexampleOptions
  • Allows for setting a Counterexample object in the builder
• CreateDialogNodeOptions
  • Allows for setting a DialogNode object in the builder
• CreateSynonymOptions
  • Allows for setting a Synonym object in the builder
• CreateValueOptions
  • Allows for setting a CreateValue object in the builder
• DialogNode
  • Now has a builder
• Example
  • Now has a builder
• Synonym
  • Now has a builder
• Value
  • Now has a builder

Property changes

• CreateEntity
  • created has been added
  • updated has been added
• CreateIntent
  • created has been added
  • updated has been added
• DialogRuntimeResponseGeneric
  • dialogNode has been added
• DialogSuggestion
  • dialogNode has been added
• Entity
  • values has been added
• Intent
  • examples has been added
• MessageRequest
  • actions has been added
• Workspace
  • counterexamples has been added
  • dialogNodes has been added
  • entities has been added
  • intents has been added
  • status property has been added
  • Status interface has been added

Compare and Comply

Model changes

• ColumnHeaderIds added
• ColumnHeaderTexts added
• ColumnHeaderTextsNormalized added
• ContractType added
• Key added
• KeyValuePair added
• RowHeaderIds added
• RowHeaderTexts added
• RowHeaderTextsNormalized added
• Value added

Property changes

• ClassifyReturn
  • contractType added
• Tables
  • keyValuePairs added

Discovery

Model changes

• SourceOptionsBuckets added

Property changes

• CreateCredentialsOptions
  • CLOUD_OBJECT_STORAGE constant added to SourceType interface
• Credentials
  • CLOUD_OBJECT_STORAGE constant added to SourceType interface
• CredentialDetails
  • accessKeyId added
  • endpoint added
  • secretAccessKey added
• QueryNoticesResult
  • title added
• QueryResult
  • title added
• SourceOptions
  • buckets added
  • crawlAllBuckets added

Natural Language Understanding

Model changes

• CategoriesOptions
  • Now has a builder
• SentenceResult added
• SyntaxOptions added
• SyntaxOptionsTokens added
• TokenResult added

Property changes

• AnalysisResults
  • syntax added
• CategoriesOptions
  • model added
• Features
  • syntax added