Discovery (parent 6.14.0 API)

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<Gateway>`	`createGateway(CreateGatewayOptions createGatewayOptions)` Create Gateway.
`ServiceCall<TokenDictStatusResponse>`	`createStopwordList(CreateStopwordListOptions createStopwordListOptions)` Create stopword 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>`	`deleteGateway(DeleteGatewayOptions deleteGatewayOptions)` Delete Gateway.
`ServiceCall<java.lang.Void>`	`deleteStopwordList(DeleteStopwordListOptions deleteStopwordListOptions)` Delete a custom stopword 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<Gateway>`	`getGateway(GetGatewayOptions getGatewayOptions)` List Gateway Details.
`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>`	`getStopwordListStatus(GetStopwordListStatusOptions getStopwordListStatusOptions)` Get stopword list status.
`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<GatewayList>`	`listGateways(ListGatewaysOptions listGatewaysOptions)` List Gateways.
`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
  - createStopwordList
```
public ServiceCall<TokenDictStatusResponse> createStopwordList(CreateStopwordListOptions createStopwordListOptions)
```
    Create stopword list. Upload a custom stopword list to use with the specified collection.
    
    Parameters:
    createStopwordListOptions - the CreateStopwordListOptions containing the options for the call
    
    Returns:
    a ServiceCall with a response type of TokenDictStatusResponse
  - 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
  - deleteStopwordList
```
public ServiceCall<java.lang.Void> deleteStopwordList(DeleteStopwordListOptions deleteStopwordListOptions)
```
    Delete a custom stopword list. Delete a custom stopword list from the collection. After a custom stopword list is deleted, the default list is used for the collection.
    
    Parameters:
    deleteStopwordListOptions - the DeleteStopwordListOptions 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
  - getStopwordListStatus
```
public ServiceCall<TokenDictStatusResponse> getStopwordListStatus(GetStopwordListStatusOptions getStopwordListStatusOptions)
```
    Get stopword list status. Returns the current status of the stopword list for the specified collection.
    
    Parameters:
    getStopwordListStatusOptions - the GetStopwordListStatusOptions containing the options for the call
    
    Returns:
    a ServiceCall with a response type of TokenDictStatusResponse
  - 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
  - createGateway
```
public ServiceCall<Gateway> createGateway(CreateGatewayOptions createGatewayOptions)
```
    Create Gateway. Create a gateway configuration to use with a remotely installed gateway.
    
    Parameters:
    createGatewayOptions - the CreateGatewayOptions containing the options for the call
    
    Returns:
    a ServiceCall with a response type of Gateway
  - deleteGateway
```
public ServiceCall<java.lang.Void> deleteGateway(DeleteGatewayOptions deleteGatewayOptions)
```
    Delete Gateway. Delete the specified gateway configuration.
    
    Parameters:
    deleteGatewayOptions - the DeleteGatewayOptions containing the options for the call
    
    Returns:
    a ServiceCall with a response type of Void
  - getGateway
```
public ServiceCall<Gateway> getGateway(GetGatewayOptions getGatewayOptions)
```
    List Gateway Details. List information about the specified gateway.
    
    Parameters:
    getGatewayOptions - the GetGatewayOptions containing the options for the call
    
    Returns:
    a ServiceCall with a response type of Gateway
  - listGateways
```
public ServiceCall<GatewayList> listGateways(ListGatewaysOptions listGatewaysOptions)
```
    List Gateways. List the currently configured gateways.
    
    Parameters:
    listGatewaysOptions - the ListGatewaysOptions containing the options for the call
    
    Returns:
    a ServiceCall with a response type of GatewayList

Class Discovery

Field Summary

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

Constructor Summary

Method Summary

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

Methods inherited from class java.lang.Object

Constructor Detail

Discovery

Discovery

Discovery

Method Detail

createEnvironment

deleteEnvironment

getEnvironment

listEnvironments

listEnvironments

listFields

updateEnvironment

createConfiguration

deleteConfiguration

getConfiguration

listConfigurations

updateConfiguration

testConfigurationInEnvironment

createCollection

deleteCollection

getCollection

listCollectionFields

listCollections

updateCollection

createExpansions

createStopwordList

createTokenizationDictionary

deleteExpansions

deleteStopwordList

deleteTokenizationDictionary

getStopwordListStatus

getTokenizationDictionaryStatus

listExpansions

addDocument

deleteDocument

getDocumentStatus

updateDocument

federatedQuery

federatedQueryNotices

query

queryEntities

queryNotices

queryRelations

addTrainingData

createTrainingExample

deleteAllTrainingData

deleteTrainingData

deleteTrainingExample

getTrainingData

getTrainingExample

listTrainingData

listTrainingExamples

updateTrainingExample

deleteUserData

createEvent

getMetricsEventRate

getMetricsEventRate

getMetricsQuery

getMetricsQuery

getMetricsQueryEvent

getMetricsQueryEvent

getMetricsQueryNoResults

getMetricsQueryNoResults

getMetricsQueryTokenEvent

getMetricsQueryTokenEvent

queryLog

queryLog

createCredentials

deleteCredentials

getCredentials

listCredentials

updateCredentials

createGateway