Documentation ¶
Overview ¶
Package textanalytics implements the Azure ARM Textanalytics service API version v2.1-preview.
The Text Analytics API is a suite of text analytics web services built with best-in-class Microsoft machine learning algorithms. The API can be used to analyze unstructured text for tasks such as sentiment analysis, key phrase extraction and language detection. No training data is needed to use this API; just bring your text data. This API uses advanced natural language processing techniques to deliver best in class predictions. Further documentation can be found in https://docs.microsoft.com/en-us/azure/cognitive-services/text-analytics/overview
Index ¶
- func UserAgent() string
- func Version() string
- type BaseClient
- func (client BaseClient) DetectLanguage(ctx context.Context, input BatchInput) (result LanguageBatchResult, err error)
- func (client BaseClient) DetectLanguagePreparer(ctx context.Context, input BatchInput) (*http.Request, error)
- func (client BaseClient) DetectLanguageResponder(resp *http.Response) (result LanguageBatchResult, err error)
- func (client BaseClient) DetectLanguageSender(req *http.Request) (*http.Response, error)
- func (client BaseClient) Entities(ctx context.Context, input MultiLanguageBatchInput) (result EntitiesBatchResultV2dot1, err error)
- func (client BaseClient) EntitiesPreparer(ctx context.Context, input MultiLanguageBatchInput) (*http.Request, error)
- func (client BaseClient) EntitiesResponder(resp *http.Response) (result EntitiesBatchResultV2dot1, err error)
- func (client BaseClient) EntitiesSender(req *http.Request) (*http.Response, error)
- func (client BaseClient) KeyPhrases(ctx context.Context, input MultiLanguageBatchInput) (result KeyPhraseBatchResult, err error)
- func (client BaseClient) KeyPhrasesPreparer(ctx context.Context, input MultiLanguageBatchInput) (*http.Request, error)
- func (client BaseClient) KeyPhrasesResponder(resp *http.Response) (result KeyPhraseBatchResult, err error)
- func (client BaseClient) KeyPhrasesSender(req *http.Request) (*http.Response, error)
- func (client BaseClient) Sentiment(ctx context.Context, input MultiLanguageBatchInput) (result SentimentBatchResult, err error)
- func (client BaseClient) SentimentPreparer(ctx context.Context, input MultiLanguageBatchInput) (*http.Request, error)
- func (client BaseClient) SentimentResponder(resp *http.Response) (result SentimentBatchResult, err error)
- func (client BaseClient) SentimentSender(req *http.Request) (*http.Response, error)
- type BatchInput
- type DetectedLanguage
- type EntitiesBatchResultItemV2dot1
- type EntitiesBatchResultV2dot1
- type EntityRecordV2dot1
- type ErrorRecord
- type ErrorResponse
- type Input
- type InternalError
- type KeyPhraseBatchResult
- type KeyPhraseBatchResultItem
- type LanguageBatchResult
- type LanguageBatchResultItem
- type MatchRecordV2dot1
- type MultiLanguageBatchInput
- type MultiLanguageInput
- type SentimentBatchResult
- type SentimentBatchResultItem
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func UserAgent ¶
func UserAgent() string
UserAgent returns the UserAgent string to use when sending http.Requests.
func Version ¶
func Version() string
Version returns the semantic version (see http://semver.org) of the client.
Types ¶
type BaseClient ¶
BaseClient is the base client for Textanalytics.
func NewWithoutDefaults ¶
func NewWithoutDefaults(endpoint string) BaseClient
NewWithoutDefaults creates an instance of the BaseClient client.
func (BaseClient) DetectLanguage ¶
func (client BaseClient) DetectLanguage(ctx context.Context, input BatchInput) (result LanguageBatchResult, err error)
DetectLanguage scores close to 1 indicate 100% certainty that the identified language is true. A total of 120 languages are supported. Parameters: input - collection of documents to analyze.
func (BaseClient) DetectLanguagePreparer ¶
func (client BaseClient) DetectLanguagePreparer(ctx context.Context, input BatchInput) (*http.Request, error)
DetectLanguagePreparer prepares the DetectLanguage request.
func (BaseClient) DetectLanguageResponder ¶
func (client BaseClient) DetectLanguageResponder(resp *http.Response) (result LanguageBatchResult, err error)
DetectLanguageResponder handles the response to the DetectLanguage request. The method always closes the http.Response Body.
func (BaseClient) DetectLanguageSender ¶
DetectLanguageSender sends the DetectLanguage request. The method will close the http.Response Body if it receives an error.
func (BaseClient) Entities ¶
func (client BaseClient) Entities(ctx context.Context, input MultiLanguageBatchInput) (result EntitiesBatchResultV2dot1, err error)
Entities the API returns a list of recognized entities in a given document. To get even more information on each recognized entity we recommend using the Bing Entity Search API by querying for the recognized entities names. See the <a href="https://docs.microsoft.com/en-us/azure/cognitive-services/text-analytics/text-analytics-supported-languages">Supported languages in Text Analytics API</a> for the list of enabled languages.The API returns a list of known entities and general named entities ("Person", "Location", "Organization" etc) in a given document. Known entities are returned with Wikipedia Id and Wikipedia link, and also Bing Id which can be used in Bing Entity Search API. General named entities are returned with entity types. If a general named entity is also a known entity, then all information regarding it (Wikipedia Id, Bing Id, entity type etc) will be returned. See the <a href="https://docs.microsoft.com/en-us/azure/cognitive-services/text-analytics/how-tos/text-analytics-how-to-entity-linking#supported-types-for-named-entity-recognition">Supported Entity Types in Text Analytics API</a> for the list of supported Entity Types. See the <a href="https://docs.microsoft.com/en-us/azure/cognitive-services/text-analytics/text-analytics-supported-languages">Supported languages in Text Analytics API</a> for the list of enabled languages. Parameters: input - collection of documents to analyze.
func (BaseClient) EntitiesPreparer ¶
func (client BaseClient) EntitiesPreparer(ctx context.Context, input MultiLanguageBatchInput) (*http.Request, error)
EntitiesPreparer prepares the Entities request.
func (BaseClient) EntitiesResponder ¶
func (client BaseClient) EntitiesResponder(resp *http.Response) (result EntitiesBatchResultV2dot1, err error)
EntitiesResponder handles the response to the Entities request. The method always closes the http.Response Body.
func (BaseClient) EntitiesSender ¶
EntitiesSender sends the Entities request. The method will close the http.Response Body if it receives an error.
func (BaseClient) KeyPhrases ¶
func (client BaseClient) KeyPhrases(ctx context.Context, input MultiLanguageBatchInput) (result KeyPhraseBatchResult, err error)
KeyPhrases see the <a href="https://docs.microsoft.com/en-us/azure/cognitive-services/text-analytics/overview#supported-languages">Text Analytics Documentation</a> for details about the languages that are supported by key phrase extraction. Parameters: input - collection of documents to analyze. Documents can now contain a language field to indicate the text language
func (BaseClient) KeyPhrasesPreparer ¶
func (client BaseClient) KeyPhrasesPreparer(ctx context.Context, input MultiLanguageBatchInput) (*http.Request, error)
KeyPhrasesPreparer prepares the KeyPhrases request.
func (BaseClient) KeyPhrasesResponder ¶
func (client BaseClient) KeyPhrasesResponder(resp *http.Response) (result KeyPhraseBatchResult, err error)
KeyPhrasesResponder handles the response to the KeyPhrases request. The method always closes the http.Response Body.
func (BaseClient) KeyPhrasesSender ¶
KeyPhrasesSender sends the KeyPhrases request. The method will close the http.Response Body if it receives an error.
func (BaseClient) Sentiment ¶
func (client BaseClient) Sentiment(ctx context.Context, input MultiLanguageBatchInput) (result SentimentBatchResult, err error)
Sentiment scores close to 1 indicate positive sentiment, while scores close to 0 indicate negative sentiment. A score of 0.5 indicates the lack of sentiment (e.g. a factoid statement). See the <a href="https://docs.microsoft.com/en-us/azure/cognitive-services/text-analytics/overview#supported-languages">Text Analytics Documentation</a> for details about the languages that are supported by sentiment analysis. Parameters: input - collection of documents to analyze.
func (BaseClient) SentimentPreparer ¶
func (client BaseClient) SentimentPreparer(ctx context.Context, input MultiLanguageBatchInput) (*http.Request, error)
SentimentPreparer prepares the Sentiment request.
func (BaseClient) SentimentResponder ¶
func (client BaseClient) SentimentResponder(resp *http.Response) (result SentimentBatchResult, err error)
SentimentResponder handles the response to the Sentiment request. The method always closes the http.Response Body.
func (BaseClient) SentimentSender ¶
SentimentSender sends the Sentiment request. The method will close the http.Response Body if it receives an error.
type BatchInput ¶
type BatchInput struct {
Documents *[]Input `json:"documents,omitempty"`
}
BatchInput ...
type DetectedLanguage ¶
type DetectedLanguage struct { // Name - Long name of a detected language (e.g. English, French). Name *string `json:"name,omitempty"` // Iso6391Name - A two letter representation of the detected language according to the ISO 639-1 standard (e.g. en, fr). Iso6391Name *string `json:"iso6391Name,omitempty"` // Score - A confidence score between 0 and 1. Scores close to 1 indicate 100% certainty that the identified language is true. Score *float64 `json:"score,omitempty"` }
DetectedLanguage ...
type EntitiesBatchResultItemV2dot1 ¶
type EntitiesBatchResultItemV2dot1 struct { // ID - Unique document identifier. ID *string `json:"id,omitempty"` // Entities - Recognized entities in the document. Entities *[]EntityRecordV2dot1 `json:"entities,omitempty"` }
EntitiesBatchResultItemV2dot1 ...
type EntitiesBatchResultV2dot1 ¶
type EntitiesBatchResultV2dot1 struct { autorest.Response `json:"-"` Documents *[]EntitiesBatchResultItemV2dot1 `json:"documents,omitempty"` Errors *[]ErrorRecord `json:"errors,omitempty"` }
EntitiesBatchResultV2dot1 ...
type EntityRecordV2dot1 ¶
type EntityRecordV2dot1 struct { // Name - Entity formal name. Name *string `json:"name,omitempty"` // Matches - List of instances this entity appears in the text. Matches *[]MatchRecordV2dot1 `json:"matches,omitempty"` // WikipediaLanguage - Wikipedia language for which the WikipediaId and WikipediaUrl refers to. WikipediaLanguage *string `json:"wikipediaLanguage,omitempty"` // WikipediaID - Wikipedia unique identifier of the recognized entity. WikipediaID *string `json:"wikipediaId,omitempty"` // WikipediaURL - URL for the entity's English Wikipedia page. WikipediaURL *string `json:"wikipediaUrl,omitempty"` // BingID - Bing unique identifier of the recognized entity. Use in conjunction with the Bing Entity Search API to fetch additional relevant information. BingID *string `json:"bingId,omitempty"` // Type - Entity type from Named Entity Recognition model Type *string `json:"type,omitempty"` // SubType - Entity sub type from Named Entity Recognition model SubType *string `json:"subType,omitempty"` }
EntityRecordV2dot1 ...
type ErrorRecord ¶
type ErrorRecord struct { // ID - Input document unique identifier the error refers to. ID *string `json:"id,omitempty"` // Message - Error message. Message *string `json:"message,omitempty"` }
ErrorRecord ...
type ErrorResponse ¶
type ErrorResponse struct { Code *string `json:"code,omitempty"` Message *string `json:"message,omitempty"` Target *string `json:"target,omitempty"` InnerError *InternalError `json:"innerError,omitempty"` }
ErrorResponse ...
type Input ¶
type Input struct { // ID - Unique, non-empty document identifier. ID *string `json:"id,omitempty"` Text *string `json:"text,omitempty"` }
Input ...
type InternalError ¶
type InternalError struct { Code *string `json:"code,omitempty"` Message *string `json:"message,omitempty"` InnerError *InternalError `json:"innerError,omitempty"` }
InternalError ...
type KeyPhraseBatchResult ¶
type KeyPhraseBatchResult struct { autorest.Response `json:"-"` Documents *[]KeyPhraseBatchResultItem `json:"documents,omitempty"` Errors *[]ErrorRecord `json:"errors,omitempty"` }
KeyPhraseBatchResult ...
type KeyPhraseBatchResultItem ¶
type KeyPhraseBatchResultItem struct { // KeyPhrases - A list of representative words or phrases. The number of key phrases returned is proportional to the number of words in the input document. KeyPhrases *[]string `json:"keyPhrases,omitempty"` // ID - Unique document identifier. ID *string `json:"id,omitempty"` }
KeyPhraseBatchResultItem ...
type LanguageBatchResult ¶
type LanguageBatchResult struct { autorest.Response `json:"-"` Documents *[]LanguageBatchResultItem `json:"documents,omitempty"` Errors *[]ErrorRecord `json:"errors,omitempty"` }
LanguageBatchResult ...
type LanguageBatchResultItem ¶
type LanguageBatchResultItem struct { // ID - Unique document identifier. ID *string `json:"id,omitempty"` // DetectedLanguages - A list of extracted languages. DetectedLanguages *[]DetectedLanguage `json:"detectedLanguages,omitempty"` }
LanguageBatchResultItem ...
type MatchRecordV2dot1 ¶
type MatchRecordV2dot1 struct { // Text - Entity text as appears in the request. Text *string `json:"text,omitempty"` // Offset - Start position (in Unicode characters) for the entity match text. Offset *int32 `json:"offset,omitempty"` // Length - Length (in Unicode characters) for the entity match text. Length *int32 `json:"length,omitempty"` }
MatchRecordV2dot1 ...
type MultiLanguageBatchInput ¶
type MultiLanguageBatchInput struct {
Documents *[]MultiLanguageInput `json:"documents,omitempty"`
}
MultiLanguageBatchInput ...
type MultiLanguageInput ¶
type MultiLanguageInput struct { // Language - This is the 2 letter ISO 639-1 representation of a language. For example, use "en" for English; "es" for Spanish etc., Language *string `json:"language,omitempty"` // ID - Unique, non-empty document identifier. ID *string `json:"id,omitempty"` Text *string `json:"text,omitempty"` }
MultiLanguageInput ...
type SentimentBatchResult ¶
type SentimentBatchResult struct { autorest.Response `json:"-"` Documents *[]SentimentBatchResultItem `json:"documents,omitempty"` Errors *[]ErrorRecord `json:"errors,omitempty"` }
SentimentBatchResult ...
type SentimentBatchResultItem ¶
type SentimentBatchResultItem struct { // Score - A decimal number between 0 and 1 denoting the sentiment of the document. A score above 0.7 usually refers to a positive document while a score below 0.3 normally has a negative connotation. Mid values refer to neutral text. Score *float64 `json:"score,omitempty"` // ID - Unique document identifier. ID *string `json:"id,omitempty"` }
SentimentBatchResultItem ...