com.ibm.watson.developer_cloud.discovery.v1

Class Discovery

java.lang.Object

com.ibm.watson.developer_cloud.service.WatsonService

com.ibm.watson.developer_cloud.discovery.v1.Discovery

public class Discovery
extends WatsonService

The IBM Watson™ Discovery Service is a cognitive search and content analytics engine that you can add to applications to identify patterns, trends and actionable insights to drive better decision-making. Securely unify structured and unstructured data with pre-enriched content, and use a simplified query language to eliminate the need for manual filtering of results.

See Also:

Discovery

Field Summary

Fields inherited from class com.ibm.watson.developer_cloud.service.WatsonService

defaultHeaders, JSON_MIME_PATTERN, JSON_PATCH_MIME_PATTERN, MESSAGE_CODE, MESSAGE_ERROR, skipAuthentication, VERSION

Constructor Summary

Constructors

Constructor and Description
Discovery(java.lang.String versionDate) Instantiates a new `Discovery`.
Discovery(java.lang.String versionDate, IamOptions iamOptions) Instantiates a new `Discovery` with IAM.
Discovery(java.lang.String versionDate, java.lang.String username, java.lang.String password) Instantiates a new `Discovery` with username and password.

Method Summary

Methods

Modifier and Type	Method and Description
ServiceCall<DocumentAccepted>	addDocument(AddDocumentOptions addDocumentOptions) Add a document.
ServiceCall<TrainingQuery>	addTrainingData(AddTrainingDataOptions addTrainingDataOptions) Add query to training data.
ServiceCall<Collection>	createCollection(CreateCollectionOptions createCollectionOptions) Create a collection.
ServiceCall<Configuration>	createConfiguration(CreateConfigurationOptions createConfigurationOptions) Add configuration.
ServiceCall<Credentials>	createCredentials(CreateCredentialsOptions createCredentialsOptions) Create credentials.
ServiceCall<Environment>	createEnvironment(CreateEnvironmentOptions createEnvironmentOptions) Create an environment.
ServiceCall<CreateEventResponse>	createEvent(CreateEventOptions createEventOptions) Create event.
ServiceCall<Expansions>	createExpansions(CreateExpansionsOptions createExpansionsOptions) Create or update expansion list.
ServiceCall<TokenDictStatusResponse>	createTokenizationDictionary(CreateTokenizationDictionaryOptions createTokenizationDictionaryOptions) Create tokenization dictionary.
ServiceCall<TrainingExample>	createTrainingExample(CreateTrainingExampleOptions createTrainingExampleOptions) Add example to training data query.
ServiceCall<java.lang.Void>	deleteAllTrainingData(DeleteAllTrainingDataOptions deleteAllTrainingDataOptions) Delete all training data.
ServiceCall<java.lang.Void>	deleteCollection(DeleteCollectionOptions deleteCollectionOptions) Delete a collection.
ServiceCall<java.lang.Void>	deleteConfiguration(DeleteConfigurationOptions deleteConfigurationOptions) Delete a configuration.
ServiceCall<java.lang.Void>	deleteCredentials(DeleteCredentialsOptions deleteCredentialsOptions) Delete credentials.
ServiceCall<java.lang.Void>	deleteDocument(DeleteDocumentOptions deleteDocumentOptions) Delete a document.
ServiceCall<java.lang.Void>	deleteEnvironment(DeleteEnvironmentOptions deleteEnvironmentOptions) Delete environment.
ServiceCall<java.lang.Void>	deleteExpansions(DeleteExpansionsOptions deleteExpansionsOptions) Delete the expansion list.
ServiceCall<java.lang.Void>	deleteTokenizationDictionary(DeleteTokenizationDictionaryOptions deleteTokenizationDictionaryOptions) Delete tokenization dictionary.
ServiceCall<java.lang.Void>	deleteTrainingData(DeleteTrainingDataOptions deleteTrainingDataOptions) Delete a training data query.
ServiceCall<java.lang.Void>	deleteTrainingExample(DeleteTrainingExampleOptions deleteTrainingExampleOptions) Delete example for training data query.
ServiceCall<java.lang.Void>	deleteUserData(DeleteUserDataOptions deleteUserDataOptions) Delete labeled data.
ServiceCall<QueryResponse>	federatedQuery(FederatedQueryOptions federatedQueryOptions) Long environment queries.
ServiceCall<QueryNoticesResponse>	federatedQueryNotices(FederatedQueryNoticesOptions federatedQueryNoticesOptions) Query multiple collection system notices.
ServiceCall<Collection>	getCollection(GetCollectionOptions getCollectionOptions) Get collection details.
ServiceCall<Configuration>	getConfiguration(GetConfigurationOptions getConfigurationOptions) Get configuration details.
ServiceCall<Credentials>	getCredentials(GetCredentialsOptions getCredentialsOptions) View Credentials.
ServiceCall<DocumentStatus>	getDocumentStatus(GetDocumentStatusOptions getDocumentStatusOptions) Get document details.
ServiceCall<Environment>	getEnvironment(GetEnvironmentOptions getEnvironmentOptions) Get environment info.
ServiceCall<MetricResponse>	getMetricsEventRate() Percentage of queries with an associated event.
ServiceCall<MetricResponse>	getMetricsEventRate(GetMetricsEventRateOptions getMetricsEventRateOptions) Percentage of queries with an associated event.
ServiceCall<MetricResponse>	getMetricsQuery() Number of queries over time.
ServiceCall<MetricResponse>	getMetricsQuery(GetMetricsQueryOptions getMetricsQueryOptions) Number of queries over time.
ServiceCall<MetricResponse>	getMetricsQueryEvent() Number of queries with an event over time.
ServiceCall<MetricResponse>	getMetricsQueryEvent(GetMetricsQueryEventOptions getMetricsQueryEventOptions) Number of queries with an event over time.
ServiceCall<MetricResponse>	getMetricsQueryNoResults() Number of queries with no search results over time.
ServiceCall<MetricResponse>	getMetricsQueryNoResults(GetMetricsQueryNoResultsOptions getMetricsQueryNoResultsOptions) Number of queries with no search results over time.
ServiceCall<MetricTokenResponse>	getMetricsQueryTokenEvent() Most frequent query tokens with an event.
ServiceCall<MetricTokenResponse>	getMetricsQueryTokenEvent(GetMetricsQueryTokenEventOptions getMetricsQueryTokenEventOptions) Most frequent query tokens with an event.
ServiceCall<TokenDictStatusResponse>	getTokenizationDictionaryStatus(GetTokenizationDictionaryStatusOptions getTokenizationDictionaryStatusOptions) Get tokenization dictionary status.
ServiceCall<TrainingQuery>	getTrainingData(GetTrainingDataOptions getTrainingDataOptions) Get details about a query.
ServiceCall<TrainingExample>	getTrainingExample(GetTrainingExampleOptions getTrainingExampleOptions) Get details for training data example.
ServiceCall<ListCollectionFieldsResponse>	listCollectionFields(ListCollectionFieldsOptions listCollectionFieldsOptions) List collection fields.
ServiceCall<ListCollectionsResponse>	listCollections(ListCollectionsOptions listCollectionsOptions) List collections.
ServiceCall<ListConfigurationsResponse>	listConfigurations(ListConfigurationsOptions listConfigurationsOptions) List configurations.
ServiceCall<CredentialsList>	listCredentials(ListCredentialsOptions listCredentialsOptions) List credentials.
ServiceCall<ListEnvironmentsResponse>	listEnvironments() List environments.
ServiceCall<ListEnvironmentsResponse>	listEnvironments(ListEnvironmentsOptions listEnvironmentsOptions) List environments.
ServiceCall<Expansions>	listExpansions(ListExpansionsOptions listExpansionsOptions) Get the expansion list.
ServiceCall<ListCollectionFieldsResponse>	listFields(ListFieldsOptions listFieldsOptions) List fields across collections.
ServiceCall<TrainingDataSet>	listTrainingData(ListTrainingDataOptions listTrainingDataOptions) List training data.
ServiceCall<TrainingExampleList>	listTrainingExamples(ListTrainingExamplesOptions listTrainingExamplesOptions) List examples for a training data query.
ServiceCall<QueryResponse>	query(QueryOptions queryOptions) Long collection queries.
ServiceCall<QueryEntitiesResponse>	queryEntities(QueryEntitiesOptions queryEntitiesOptions) Knowledge Graph entity query.
ServiceCall<LogQueryResponse>	queryLog() Search the query and event log.
ServiceCall<LogQueryResponse>	queryLog(QueryLogOptions queryLogOptions) Search the query and event log.
ServiceCall<QueryNoticesResponse>	queryNotices(QueryNoticesOptions queryNoticesOptions) Query system notices.
ServiceCall<QueryRelationsResponse>	queryRelations(QueryRelationsOptions queryRelationsOptions) Knowledge Graph relationship query.
ServiceCall<TestDocument>	testConfigurationInEnvironment(TestConfigurationInEnvironmentOptions testConfigurationInEnvironmentOptions) Test configuration.
ServiceCall<Collection>	updateCollection(UpdateCollectionOptions updateCollectionOptions) Update a collection.
ServiceCall<Configuration>	updateConfiguration(UpdateConfigurationOptions updateConfigurationOptions) Update a configuration.
ServiceCall<Credentials>	updateCredentials(UpdateCredentialsOptions updateCredentialsOptions) Update credentials.
ServiceCall<DocumentAccepted>	updateDocument(UpdateDocumentOptions updateDocumentOptions) Update a document.
ServiceCall<Environment>	updateEnvironment(UpdateEnvironmentOptions updateEnvironmentOptions) Update an environment.
ServiceCall<TrainingExample>	updateTrainingExample(UpdateTrainingExampleOptions updateTrainingExampleOptions) Change label or cross reference for example.

Methods inherited from class com.ibm.watson.developer_cloud.service.WatsonService

configureClient, configureHttpClient, createServiceCall, getApiKey, getEndPoint, getName, getPassword, getToken, getUsername, isJsonMimeType, isJsonPatchMimeType, isTokenManagerSet, processServiceCall, setApiKey, setAuthentication, setDefaultHeaders, setDefaultHeaders, setEndPoint, setIamCredentials, setSkipAuthentication, setUsernameAndPassword, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Discovery

public Discovery(java.lang.String versionDate)

Instantiates a new `Discovery`.

Parameters:

versionDate - The version date (yyyy-MM-dd) of the REST API to use. Specifying this value will keep your API calls from failing when the service introduces breaking changes.

Discovery

public Discovery(java.lang.String versionDate,
         java.lang.String username,
         java.lang.String password)

Instantiates a new `Discovery` with username and password.

Parameters:

versionDate - The version date (yyyy-MM-dd) of the REST API to use. Specifying this value will keep your API calls from failing when the service introduces breaking changes.

username - the username

password - the password

Discovery

public Discovery(java.lang.String versionDate,
         IamOptions iamOptions)

Instantiates a new `Discovery` with IAM. Note that if the access token is specified in the iamOptions, you accept responsibility for managing the access token yourself. You must set a new access token before this one expires or after receiving a 401 error from the service. Failing to do so will result in authentication errors after this token expires.

Parameters:

versionDate - The version date (yyyy-MM-dd) of the REST API to use. Specifying this value will keep your API calls from failing when the service introduces breaking changes.

iamOptions - the options for authenticating through IAM

Method Detail

createEnvironment

public ServiceCall<Environment> createEnvironment(CreateEnvironmentOptions createEnvironmentOptions)

Create an environment. Creates a new environment for private data. An environment must be created before collections can be created. **Note**: You can create only one environment for private data per service instance. An attempt to create another environment results in an error.

Parameters:

createEnvironmentOptions - the CreateEnvironmentOptions containing the options for the call

Returns:

a ServiceCall with a response type of Environment

deleteEnvironment

public ServiceCall<java.lang.Void> deleteEnvironment(DeleteEnvironmentOptions deleteEnvironmentOptions)

Delete environment.

Parameters:

deleteEnvironmentOptions - the DeleteEnvironmentOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

getEnvironment

public ServiceCall<Environment> getEnvironment(GetEnvironmentOptions getEnvironmentOptions)

Get environment info.

Parameters:

getEnvironmentOptions - the GetEnvironmentOptions containing the options for the call

Returns:

a ServiceCall with a response type of Environment

listEnvironments

public ServiceCall<ListEnvironmentsResponse> listEnvironments(ListEnvironmentsOptions listEnvironmentsOptions)

List environments. List existing environments for the service instance.

Parameters:

listEnvironmentsOptions - the ListEnvironmentsOptions containing the options for the call

Returns:

a ServiceCall with a response type of ListEnvironmentsResponse

listEnvironments

public ServiceCall<ListEnvironmentsResponse> listEnvironments()

List environments. List existing environments for the service instance.

Returns:

a ServiceCall with a response type of ListEnvironmentsResponse

listFields

public ServiceCall<ListCollectionFieldsResponse> listFields(ListFieldsOptions listFieldsOptions)

List fields across collections. Gets a list of the unique fields (and their types) stored in the indexes of the specified collections.

Parameters:

listFieldsOptions - the ListFieldsOptions containing the options for the call

Returns:

a ServiceCall with a response type of ListCollectionFieldsResponse

updateEnvironment

public ServiceCall<Environment> updateEnvironment(UpdateEnvironmentOptions updateEnvironmentOptions)

Update an environment. Updates an environment. The environment's **name** and **description** parameters can be changed. You must specify a **name** for the environment.

Parameters:

updateEnvironmentOptions - the UpdateEnvironmentOptions containing the options for the call

Returns:

a ServiceCall with a response type of Environment

createConfiguration

public ServiceCall<Configuration> createConfiguration(CreateConfigurationOptions createConfigurationOptions)

Add configuration. Creates a new configuration. If the input configuration contains the **configuration_id**, **created**, or **updated** properties, then they are ignored and overridden by the system, and an error is not returned so that the overridden fields do not need to be removed when copying a configuration. The configuration can contain unrecognized JSON fields. Any such fields are ignored and do not generate an error. This makes it easier to use newer configuration files with older versions of the API and the service. It also makes it possible for the tooling to add additional metadata and information to the configuration.

Parameters:

createConfigurationOptions - the CreateConfigurationOptions containing the options for the call

Returns:

a ServiceCall with a response type of Configuration

deleteConfiguration

public ServiceCall<java.lang.Void> deleteConfiguration(DeleteConfigurationOptions deleteConfigurationOptions)

Delete a configuration. The deletion is performed unconditionally. A configuration deletion request succeeds even if the configuration is referenced by a collection or document ingestion. However, documents that have already been submitted for processing continue to use the deleted configuration. Documents are always processed with a snapshot of the configuration as it existed at the time the document was submitted.

Parameters:

deleteConfigurationOptions - the DeleteConfigurationOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

getConfiguration

public ServiceCall<Configuration> getConfiguration(GetConfigurationOptions getConfigurationOptions)

Get configuration details.

Parameters:

getConfigurationOptions - the GetConfigurationOptions containing the options for the call

Returns:

a ServiceCall with a response type of Configuration

listConfigurations

public ServiceCall<ListConfigurationsResponse> listConfigurations(ListConfigurationsOptions listConfigurationsOptions)

List configurations. Lists existing configurations for the service instance.

Parameters:

listConfigurationsOptions - the ListConfigurationsOptions containing the options for the call

Returns:

a ServiceCall with a response type of ListConfigurationsResponse

updateConfiguration

public ServiceCall<Configuration> updateConfiguration(UpdateConfigurationOptions updateConfigurationOptions)

Update a configuration. Replaces an existing configuration. * Completely replaces the original configuration. * The **configuration_id**, **updated**, and **created** fields are accepted in the request, but they are ignored, and an error is not generated. It is also acceptable for users to submit an updated configuration with none of the three properties. * Documents are processed with a snapshot of the configuration as it was at the time the document was submitted to be ingested. This means that already submitted documents will not see any updates made to the configuration.

Parameters:

updateConfigurationOptions - the UpdateConfigurationOptions containing the options for the call

Returns:

a ServiceCall with a response type of Configuration

testConfigurationInEnvironment

public ServiceCall<TestDocument> testConfigurationInEnvironment(TestConfigurationInEnvironmentOptions testConfigurationInEnvironmentOptions)

Test configuration. Runs a sample document through the default or your configuration and returns diagnostic information designed to help you understand how the document was processed. The document is not added to the index.

Parameters:

testConfigurationInEnvironmentOptions - the TestConfigurationInEnvironmentOptions containing the options for the call

Returns:

a ServiceCall with a response type of TestDocument

createCollection

public ServiceCall<Collection> createCollection(CreateCollectionOptions createCollectionOptions)

Create a collection.

Parameters:

createCollectionOptions - the CreateCollectionOptions containing the options for the call

Returns:

a ServiceCall with a response type of Collection

deleteCollection

public ServiceCall<java.lang.Void> deleteCollection(DeleteCollectionOptions deleteCollectionOptions)

Delete a collection.

Parameters:

deleteCollectionOptions - the DeleteCollectionOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

getCollection

public ServiceCall<Collection> getCollection(GetCollectionOptions getCollectionOptions)

Get collection details.

Parameters:

getCollectionOptions - the GetCollectionOptions containing the options for the call

Returns:

a ServiceCall with a response type of Collection

listCollectionFields

public ServiceCall<ListCollectionFieldsResponse> listCollectionFields(ListCollectionFieldsOptions listCollectionFieldsOptions)

List collection fields. Gets a list of the unique fields (and their types) stored in the index.

Parameters:

listCollectionFieldsOptions - the ListCollectionFieldsOptions containing the options for the call

Returns:

a ServiceCall with a response type of ListCollectionFieldsResponse

listCollections

public ServiceCall<ListCollectionsResponse> listCollections(ListCollectionsOptions listCollectionsOptions)

List collections. Lists existing collections for the service instance.

Parameters:

listCollectionsOptions - the ListCollectionsOptions containing the options for the call

Returns:

a ServiceCall with a response type of ListCollectionsResponse

updateCollection

public ServiceCall<Collection> updateCollection(UpdateCollectionOptions updateCollectionOptions)

Update a collection.

Parameters:

updateCollectionOptions - the UpdateCollectionOptions containing the options for the call

Returns:

a ServiceCall with a response type of Collection

createExpansions

public ServiceCall<Expansions> createExpansions(CreateExpansionsOptions createExpansionsOptions)

Create or update expansion list. Create or replace the Expansion list for this collection. The maximum number of expanded terms per collection is `500`. The current expansion list is replaced with the uploaded content.

Parameters:

createExpansionsOptions - the CreateExpansionsOptions containing the options for the call

Returns:

a ServiceCall with a response type of Expansions

createTokenizationDictionary

public ServiceCall<TokenDictStatusResponse> createTokenizationDictionary(CreateTokenizationDictionaryOptions createTokenizationDictionaryOptions)

Create tokenization dictionary. Upload a custom tokenization dictionary to use with the specified collection.

Parameters:

createTokenizationDictionaryOptions - the CreateTokenizationDictionaryOptions containing the options for the call

Returns:

a ServiceCall with a response type of TokenDictStatusResponse

deleteExpansions

public ServiceCall<java.lang.Void> deleteExpansions(DeleteExpansionsOptions deleteExpansionsOptions)

Delete the expansion list. Remove the expansion information for this collection. The expansion list must be deleted to disable query expansion for a collection.

Parameters:

deleteExpansionsOptions - the DeleteExpansionsOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

deleteTokenizationDictionary

public ServiceCall<java.lang.Void> deleteTokenizationDictionary(DeleteTokenizationDictionaryOptions deleteTokenizationDictionaryOptions)

Delete tokenization dictionary. Delete the tokenization dictionary from the collection.

Parameters:

deleteTokenizationDictionaryOptions - the DeleteTokenizationDictionaryOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

getTokenizationDictionaryStatus

public ServiceCall<TokenDictStatusResponse> getTokenizationDictionaryStatus(GetTokenizationDictionaryStatusOptions getTokenizationDictionaryStatusOptions)

Get tokenization dictionary status. Returns the current status of the tokenization dictionary for the specified collection.

Parameters:

getTokenizationDictionaryStatusOptions - the GetTokenizationDictionaryStatusOptions containing the options for the call

Returns:

a ServiceCall with a response type of TokenDictStatusResponse

listExpansions

public ServiceCall<Expansions> listExpansions(ListExpansionsOptions listExpansionsOptions)

Get the expansion list. Returns the current expansion list for the specified collection. If an expansion list is not specified, an object with empty expansion arrays is returned.

Parameters:

listExpansionsOptions - the ListExpansionsOptions containing the options for the call

Returns:

a ServiceCall with a response type of Expansions

addDocument

public ServiceCall<DocumentAccepted> addDocument(AddDocumentOptions addDocumentOptions)

Add a document. Add a document to a collection with optional metadata. * The **version** query parameter is still required. * Returns immediately after the system has accepted the document for processing. * The user must provide document content, metadata, or both. If the request is missing both document content and metadata, it is rejected. * The user can set the **Content-Type** parameter on the **file** part to indicate the media type of the document. If the **Content-Type** parameter is missing or is one of the generic media types (for example, `application/octet-stream`), then the service attempts to automatically detect the document's media type. * The following field names are reserved and will be filtered out if present after normalization: `id`, `score`, `highlight`, and any field with the prefix of: `_`, `+`, or `-` * Fields with empty name values after normalization are filtered out before indexing. * Fields containing the following characters after normalization are filtered out before indexing: `#` and `,`.

Parameters:

addDocumentOptions - the AddDocumentOptions containing the options for the call

Returns:

a ServiceCall with a response type of DocumentAccepted

deleteDocument

public ServiceCall<java.lang.Void> deleteDocument(DeleteDocumentOptions deleteDocumentOptions)

Delete a document. If the given document ID is invalid, or if the document is not found, then the a success response is returned (HTTP status code `200`) with the status set to 'deleted'.

Parameters:

deleteDocumentOptions - the DeleteDocumentOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

getDocumentStatus

public ServiceCall<DocumentStatus> getDocumentStatus(GetDocumentStatusOptions getDocumentStatusOptions)

Get document details. Fetch status details about a submitted document. **Note:** this operation does not return the document itself. Instead, it returns only the document's processing status and any notices (warnings or errors) that were generated when the document was ingested. Use the query API to retrieve the actual document content.

Parameters:

getDocumentStatusOptions - the GetDocumentStatusOptions containing the options for the call

Returns:

a ServiceCall with a response type of DocumentStatus

updateDocument

public ServiceCall<DocumentAccepted> updateDocument(UpdateDocumentOptions updateDocumentOptions)

Update a document. Replace an existing document. Starts ingesting a document with optional metadata.

Parameters:

updateDocumentOptions - the UpdateDocumentOptions containing the options for the call

Returns:

a ServiceCall with a response type of DocumentAccepted

federatedQuery

public ServiceCall<QueryResponse> federatedQuery(FederatedQueryOptions federatedQueryOptions)

Long environment queries. Complex queries might be too long for a standard method query. By using this method, you can construct longer queries. However, these queries may take longer to complete than the standard method. For details, see the [Discovery service documentation](https://console.bluemix.net/docs/services/discovery/using.html).

Parameters:

federatedQueryOptions - the FederatedQueryOptions containing the options for the call

Returns:

a ServiceCall with a response type of QueryResponse

federatedQueryNotices

public ServiceCall<QueryNoticesResponse> federatedQueryNotices(FederatedQueryNoticesOptions federatedQueryNoticesOptions)

Query multiple collection system notices. Queries for notices (errors or warnings) that might have been generated by the system. Notices are generated when ingesting documents and performing relevance training. See the [Discovery service documentation](https://console.bluemix.net/docs/services/discovery/using.html) for more details on the query language.

Parameters:

federatedQueryNoticesOptions - the FederatedQueryNoticesOptions containing the options for the call

Returns:

a ServiceCall with a response type of QueryNoticesResponse

query

public ServiceCall<QueryResponse> query(QueryOptions queryOptions)

Long collection queries. Complex queries might be too long for a standard method query. By using this method, you can construct longer queries. However, these queries may take longer to complete than the standard method. For details, see the [Discovery service documentation](https://console.bluemix.net/docs/services/discovery/using.html).

Parameters:

queryOptions - the QueryOptions containing the options for the call

Returns:

a ServiceCall with a response type of QueryResponse

queryEntities

public ServiceCall<QueryEntitiesResponse> queryEntities(QueryEntitiesOptions queryEntitiesOptions)

Knowledge Graph entity query. See the [Knowledge Graph documentation](https://console.bluemix.net/docs/services/discovery/building-kg.html) for more details.

Parameters:

queryEntitiesOptions - the QueryEntitiesOptions containing the options for the call

Returns:

a ServiceCall with a response type of QueryEntitiesResponse

queryNotices

public ServiceCall<QueryNoticesResponse> queryNotices(QueryNoticesOptions queryNoticesOptions)

Query system notices. Queries for notices (errors or warnings) that might have been generated by the system. Notices are generated when ingesting documents and performing relevance training. See the [Discovery service documentation](https://console.bluemix.net/docs/services/discovery/using.html) for more details on the query language.

Parameters:

queryNoticesOptions - the QueryNoticesOptions containing the options for the call

Returns:

a ServiceCall with a response type of QueryNoticesResponse

queryRelations

public ServiceCall<QueryRelationsResponse> queryRelations(QueryRelationsOptions queryRelationsOptions)

Knowledge Graph relationship query. See the [Knowledge Graph documentation](https://console.bluemix.net/docs/services/discovery/building-kg.html) for more details.

Parameters:

queryRelationsOptions - the QueryRelationsOptions containing the options for the call

Returns:

a ServiceCall with a response type of QueryRelationsResponse

addTrainingData

public ServiceCall<TrainingQuery> addTrainingData(AddTrainingDataOptions addTrainingDataOptions)

Add query to training data. Adds a query to the training data for this collection. The query can contain a filter and natural language query.

Parameters:

addTrainingDataOptions - the AddTrainingDataOptions containing the options for the call

Returns:

a ServiceCall with a response type of TrainingQuery

createTrainingExample

public ServiceCall<TrainingExample> createTrainingExample(CreateTrainingExampleOptions createTrainingExampleOptions)

Add example to training data query. Adds a example to this training data query.

Parameters:

createTrainingExampleOptions - the CreateTrainingExampleOptions containing the options for the call

Returns:

a ServiceCall with a response type of TrainingExample

deleteAllTrainingData

public ServiceCall<java.lang.Void> deleteAllTrainingData(DeleteAllTrainingDataOptions deleteAllTrainingDataOptions)

Delete all training data. Deletes all training data from a collection.

Parameters:

deleteAllTrainingDataOptions - the DeleteAllTrainingDataOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

deleteTrainingData

public ServiceCall<java.lang.Void> deleteTrainingData(DeleteTrainingDataOptions deleteTrainingDataOptions)

Delete a training data query. Removes the training data query and all associated examples from the training data set.

Parameters:

deleteTrainingDataOptions - the DeleteTrainingDataOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

deleteTrainingExample

public ServiceCall<java.lang.Void> deleteTrainingExample(DeleteTrainingExampleOptions deleteTrainingExampleOptions)

Delete example for training data query. Deletes the example document with the given ID from the training data query.

Parameters:

deleteTrainingExampleOptions - the DeleteTrainingExampleOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

getTrainingData

public ServiceCall<TrainingQuery> getTrainingData(GetTrainingDataOptions getTrainingDataOptions)

Get details about a query. Gets details for a specific training data query, including the query string and all examples.

Parameters:

getTrainingDataOptions - the GetTrainingDataOptions containing the options for the call

Returns:

a ServiceCall with a response type of TrainingQuery

getTrainingExample

public ServiceCall<TrainingExample> getTrainingExample(GetTrainingExampleOptions getTrainingExampleOptions)

Get details for training data example. Gets the details for this training example.

Parameters:

getTrainingExampleOptions - the GetTrainingExampleOptions containing the options for the call

Returns:

a ServiceCall with a response type of TrainingExample

listTrainingData

public ServiceCall<TrainingDataSet> listTrainingData(ListTrainingDataOptions listTrainingDataOptions)

List training data. Lists the training data for the specified collection.

Parameters:

listTrainingDataOptions - the ListTrainingDataOptions containing the options for the call

Returns:

a ServiceCall with a response type of TrainingDataSet

listTrainingExamples

public ServiceCall<TrainingExampleList> listTrainingExamples(ListTrainingExamplesOptions listTrainingExamplesOptions)

List examples for a training data query. List all examples for this training data query.

Parameters:

listTrainingExamplesOptions - the ListTrainingExamplesOptions containing the options for the call

Returns:

a ServiceCall with a response type of TrainingExampleList

updateTrainingExample

public ServiceCall<TrainingExample> updateTrainingExample(UpdateTrainingExampleOptions updateTrainingExampleOptions)

Change label or cross reference for example. Changes the label or cross reference query for this training data example.

Parameters:

updateTrainingExampleOptions - the UpdateTrainingExampleOptions containing the options for the call

Returns:

a ServiceCall with a response type of TrainingExample

deleteUserData

public ServiceCall<java.lang.Void> deleteUserData(DeleteUserDataOptions deleteUserDataOptions)

Delete labeled data. Deletes all data associated with a specified customer ID. The method has no effect if no data is associated with the customer ID. 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://console.bluemix.net/docs/services/discovery/information-security.html).

Parameters:

deleteUserDataOptions - the DeleteUserDataOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

createEvent

public ServiceCall<CreateEventResponse> createEvent(CreateEventOptions createEventOptions)

Create event. The **Events** API can be used to create log entries that are associated with specific queries. For example, you can record which documents in the results set were \"clicked\" by a user and when that click occured.

Parameters:

createEventOptions - the CreateEventOptions containing the options for the call

Returns:

a ServiceCall with a response type of CreateEventResponse

getMetricsEventRate

public ServiceCall<MetricResponse> getMetricsEventRate(GetMetricsEventRateOptions getMetricsEventRateOptions)

Percentage of queries with an associated event. The percentage of queries using the **natural_language_query** parameter that have a corresponding \"click\" event over a specified time window. This metric requires having integrated event tracking in your application using the **Events** API.

Parameters:

getMetricsEventRateOptions - the GetMetricsEventRateOptions containing the options for the call

Returns:

a ServiceCall with a response type of MetricResponse

getMetricsEventRate

public ServiceCall<MetricResponse> getMetricsEventRate()

Percentage of queries with an associated event. The percentage of queries using the **natural_language_query** parameter that have a corresponding \"click\" event over a specified time window. This metric requires having integrated event tracking in your application using the **Events** API.

Returns:

a ServiceCall with a response type of MetricResponse

getMetricsQuery

public ServiceCall<MetricResponse> getMetricsQuery(GetMetricsQueryOptions getMetricsQueryOptions)

Number of queries over time. Total number of queries using the **natural_language_query** parameter over a specific time window.

Parameters:

getMetricsQueryOptions - the GetMetricsQueryOptions containing the options for the call

Returns:

a ServiceCall with a response type of MetricResponse

getMetricsQuery

public ServiceCall<MetricResponse> getMetricsQuery()

Number of queries over time. Total number of queries using the **natural_language_query** parameter over a specific time window.

Returns:

a ServiceCall with a response type of MetricResponse

getMetricsQueryEvent

public ServiceCall<MetricResponse> getMetricsQueryEvent(GetMetricsQueryEventOptions getMetricsQueryEventOptions)

Number of queries with an event over time. Total number of queries using the **natural_language_query** parameter that have a corresponding \"click\" event over a specified time window. This metric requires having integrated event tracking in your application using the **Events** API.

Parameters:

getMetricsQueryEventOptions - the GetMetricsQueryEventOptions containing the options for the call

Returns:

a ServiceCall with a response type of MetricResponse

getMetricsQueryEvent

public ServiceCall<MetricResponse> getMetricsQueryEvent()

Number of queries with an event over time. Total number of queries using the **natural_language_query** parameter that have a corresponding \"click\" event over a specified time window. This metric requires having integrated event tracking in your application using the **Events** API.

Returns:

a ServiceCall with a response type of MetricResponse

getMetricsQueryNoResults

public ServiceCall<MetricResponse> getMetricsQueryNoResults(GetMetricsQueryNoResultsOptions getMetricsQueryNoResultsOptions)

Number of queries with no search results over time. Total number of queries using the **natural_language_query** parameter that have no results returned over a specified time window.

Parameters:

getMetricsQueryNoResultsOptions - the GetMetricsQueryNoResultsOptions containing the options for the call

Returns:

a ServiceCall with a response type of MetricResponse

getMetricsQueryNoResults

public ServiceCall<MetricResponse> getMetricsQueryNoResults()

Number of queries with no search results over time. Total number of queries using the **natural_language_query** parameter that have no results returned over a specified time window.

Returns:

a ServiceCall with a response type of MetricResponse

getMetricsQueryTokenEvent

public ServiceCall<MetricTokenResponse> getMetricsQueryTokenEvent(GetMetricsQueryTokenEventOptions getMetricsQueryTokenEventOptions)

Most frequent query tokens with an event. The most frequent query tokens parsed from the **natural_language_query** parameter and their corresponding \"click\" event rate within the recording period (queries and events are stored for 30 days). A query token is an individual word or unigram within the query string.

Parameters:

getMetricsQueryTokenEventOptions - the GetMetricsQueryTokenEventOptions containing the options for the call

Returns:

a ServiceCall with a response type of MetricTokenResponse

getMetricsQueryTokenEvent

public ServiceCall<MetricTokenResponse> getMetricsQueryTokenEvent()

Most frequent query tokens with an event. The most frequent query tokens parsed from the **natural_language_query** parameter and their corresponding \"click\" event rate within the recording period (queries and events are stored for 30 days). A query token is an individual word or unigram within the query string.

Returns:

a ServiceCall with a response type of MetricTokenResponse

queryLog

public ServiceCall<LogQueryResponse> queryLog(QueryLogOptions queryLogOptions)

Search the query and event log. Searches the query and event log to find query sessions that match the specified criteria. Searching the **logs** endpoint uses the standard Discovery query syntax for the parameters that are supported.

Parameters:

queryLogOptions - the QueryLogOptions containing the options for the call

Returns:

a ServiceCall with a response type of LogQueryResponse

queryLog

public ServiceCall<LogQueryResponse> queryLog()

Search the query and event log. Searches the query and event log to find query sessions that match the specified criteria. Searching the **logs** endpoint uses the standard Discovery query syntax for the parameters that are supported.

Returns:

a ServiceCall with a response type of LogQueryResponse

createCredentials

public ServiceCall<Credentials> createCredentials(CreateCredentialsOptions createCredentialsOptions)

Create credentials. Creates a set of credentials to connect to a remote source. Created credentials are used in a configuration to associate a collection with the remote source. **Note:** All credentials are sent over an encrypted connection and encrypted at rest.

Parameters:

createCredentialsOptions - the CreateCredentialsOptions containing the options for the call

Returns:

a ServiceCall with a response type of Credentials

deleteCredentials

public ServiceCall<java.lang.Void> deleteCredentials(DeleteCredentialsOptions deleteCredentialsOptions)

Delete credentials. Deletes a set of stored credentials from your Discovery instance.

Parameters:

deleteCredentialsOptions - the DeleteCredentialsOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

getCredentials

public ServiceCall<Credentials> getCredentials(GetCredentialsOptions getCredentialsOptions)

View Credentials. Returns details about the specified credentials. **Note:** Secure credential information such as a password or SSH key is never returned and must be obtained from the source system.

Parameters:

getCredentialsOptions - the GetCredentialsOptions containing the options for the call

Returns:

a ServiceCall with a response type of Credentials

listCredentials

public ServiceCall<CredentialsList> listCredentials(ListCredentialsOptions listCredentialsOptions)

List credentials. List all the source credentials that have been created for this service instance. **Note:** All credentials are sent over an encrypted connection and encrypted at rest.

Parameters:

listCredentialsOptions - the ListCredentialsOptions containing the options for the call

Returns:

a ServiceCall with a response type of CredentialsList

updateCredentials

public ServiceCall<Credentials> updateCredentials(UpdateCredentialsOptions updateCredentialsOptions)

Update credentials. Updates an existing set of source credentials. **Note:** All credentials are sent over an encrypted connection and encrypted at rest.

Parameters:

updateCredentialsOptions - the UpdateCredentialsOptions containing the options for the call

Returns:

a ServiceCall with a response type of Credentials