/**
* Analyzes the sentiment of the provided document.
*
* Example:
* ```
* $annotation = $language->analyzeSentiment('Google Cloud Platform is a powerful tool.');
* $sentiment = $annotation->sentiment();
*
* if ($sentiment['score'] > 0) {
* echo 'This is a positive message.';
* }
* ```
*
* @codingStandardsIgnoreStart
* @see https://cloud.google.com/natural-language/reference/rest/v1beta1/documents/analyzeSentiment Analyze Sentiment API documentation
* @codingStandardsIgnoreEnd
*
* @param string|StorageObject $content The content to analyze.
* @param array $options [optional] {
* Configuration options.
*
* @type string $type The document type. Acceptable values are
* `PLAIN_TEXT` or `HTML`. **Defaults to** `"PLAIN_TEXT"`.
* @type string $language The language of the document. Both ISO
* (e.g., en, es) and BCP-47 (e.g., en-US, es-ES) language codes
* are accepted. If no value is provided, the language will be
* detected by the service.
* @type string $encodingType The text encoding type used by the API to
* calculate offsets. Acceptable values are `"NONE"`, `"UTF8"`,
* `"UTF16"` and `"UTF32"`. **Defaults to** `"UTF8"`.
* }
* @return Annotation
*/
public function analyzeSentiment($content, array $options = [])
{
return new Annotation($this->connection->analyzeSentiment($this->formatRequest($content, $options)));
}