Natural Language Client Types

class google.cloud.language_v1.types.AnalyzeEntitiesRequest

The entity analysis request message.

document

Input document.

encoding_type

The encoding type used by the API to calculate offsets.

document

Field google.cloud.language.v1.AnalyzeEntitiesRequest.document

encoding_type

Field google.cloud.language.v1.AnalyzeEntitiesRequest.encoding_type

class google.cloud.language_v1.types.AnalyzeEntitiesResponse

The entity analysis response message.

entities

The recognized entities in the input document.

language

The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See [Document.language][googl e.cloud.language.v1.Document.language] field for more details.

entities

Field google.cloud.language.v1.AnalyzeEntitiesResponse.entities

language

Field google.cloud.language.v1.AnalyzeEntitiesResponse.language

class google.cloud.language_v1.types.AnalyzeEntitySentimentRequest

The entity-level sentiment analysis request message.

document

Input document.

encoding_type

The encoding type used by the API to calculate offsets.

document

Field google.cloud.language.v1.AnalyzeEntitySentimentRequest.document

encoding_type

Field google.cloud.language.v1.AnalyzeEntitySentimentRequest.encoding_type

class google.cloud.language_v1.types.AnalyzeEntitySentimentResponse

The entity-level sentiment analysis response message.

entities

The recognized entities in the input document with associated sentiments.

language

The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See [Document.language][googl e.cloud.language.v1.Document.language] field for more details.

entities

Field google.cloud.language.v1.AnalyzeEntitySentimentResponse.entities

language

Field google.cloud.language.v1.AnalyzeEntitySentimentResponse.language

class google.cloud.language_v1.types.AnalyzeSentimentRequest

The sentiment analysis request message.

document

Input document.

encoding_type

The encoding type used by the API to calculate sentence offsets.

document

Field google.cloud.language.v1.AnalyzeSentimentRequest.document

encoding_type

Field google.cloud.language.v1.AnalyzeSentimentRequest.encoding_type

class google.cloud.language_v1.types.AnalyzeSentimentResponse

The sentiment analysis response message.

document_sentiment

The overall sentiment of the input document.

language

The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See [Document.language][googl e.cloud.language.v1.Document.language] field for more details.

sentences

The sentiment for all the sentences in the document.

document_sentiment

Field google.cloud.language.v1.AnalyzeSentimentResponse.document_sentiment

language

Field google.cloud.language.v1.AnalyzeSentimentResponse.language

sentences

Field google.cloud.language.v1.AnalyzeSentimentResponse.sentences

class google.cloud.language_v1.types.AnalyzeSyntaxRequest

The syntax analysis request message.

document

Input document.

encoding_type

The encoding type used by the API to calculate offsets.

document

Field google.cloud.language.v1.AnalyzeSyntaxRequest.document

encoding_type

Field google.cloud.language.v1.AnalyzeSyntaxRequest.encoding_type

class google.cloud.language_v1.types.AnalyzeSyntaxResponse

The syntax analysis response message.

sentences

Sentences in the input document.

tokens

Tokens, along with their syntactic information, in the input document.

language

The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See [Document.language][googl e.cloud.language.v1.Document.language] field for more details.

language

Field google.cloud.language.v1.AnalyzeSyntaxResponse.language

sentences

Field google.cloud.language.v1.AnalyzeSyntaxResponse.sentences

tokens

Field google.cloud.language.v1.AnalyzeSyntaxResponse.tokens

class google.cloud.language_v1.types.AnnotateTextRequest

The request message for the text annotation API, which can perform multiple analysis types (sentiment, entities, and syntax) in one call.

document

Input document.

features

The enabled features.

encoding_type

The encoding type used by the API to calculate offsets.

class Features

All available features for sentiment, syntax, and semantic analysis. Setting each one to true will enable that specific analysis for the input.

extract_syntax

Extract syntax information.

extract_entities

Extract entities.

extract_document_sentiment

Extract document-level sentiment.

extract_entity_sentiment

Extract entities and their associated sentiment.

classify_text

Classify the full document into categories.

classify_text

Field google.cloud.language.v1.AnnotateTextRequest.Features.classify_text

extract_document_sentiment

Field google.cloud.language.v1.AnnotateTextRequest.Features.extract_document_sentiment

extract_entities

Field google.cloud.language.v1.AnnotateTextRequest.Features.extract_entities

extract_entity_sentiment

Field google.cloud.language.v1.AnnotateTextRequest.Features.extract_entity_sentiment

extract_syntax

Field google.cloud.language.v1.AnnotateTextRequest.Features.extract_syntax

document

Field google.cloud.language.v1.AnnotateTextRequest.document

encoding_type

Field google.cloud.language.v1.AnnotateTextRequest.encoding_type

features

Field google.cloud.language.v1.AnnotateTextRequest.features

class google.cloud.language_v1.types.AnnotateTextResponse

The text annotations response message.

sentences

Sentences in the input document. Populated if the user enables [AnnotateTextRequest.Features.extract_syntax][google.cloud.la nguage.v1.AnnotateTextRequest.Features.extract_syntax].

tokens

Tokens, along with their syntactic information, in the input document. Populated if the user enables [AnnotateTextRequest.F eatures.extract_syntax][google.cloud.language.v1.AnnotateText Request.Features.extract_syntax].

entities

Entities, along with their semantic information, in the input document. Populated if the user enables [AnnotateTextRequest.F eatures.extract_entities][google.cloud.language.v1.AnnotateTe xtRequest.Features.extract_entities].

document_sentiment

The overall sentiment for the document. Populated if the user enables [AnnotateTextRequest.Features.extract_document_senti ment][google.cloud.language.v1.AnnotateTextRequest.Features.ex tract_document_sentiment].

language

The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See [Document.language][googl e.cloud.language.v1.Document.language] field for more details.

categories

Categories identified in the input document.

categories

Field google.cloud.language.v1.AnnotateTextResponse.categories

document_sentiment

Field google.cloud.language.v1.AnnotateTextResponse.document_sentiment

entities

Field google.cloud.language.v1.AnnotateTextResponse.entities

language

Field google.cloud.language.v1.AnnotateTextResponse.language

sentences

Field google.cloud.language.v1.AnnotateTextResponse.sentences

tokens

Field google.cloud.language.v1.AnnotateTextResponse.tokens

class google.cloud.language_v1.types.ClassificationCategory

Represents a category returned from the text classifier.

name

The name of the category representing the document, from the predefined taxonomy.

confidence

The classifier’s confidence of the category. Number represents how certain the classifier is that this category represents the given text.

confidence

Field google.cloud.language.v1.ClassificationCategory.confidence

name

Field google.cloud.language.v1.ClassificationCategory.name

class google.cloud.language_v1.types.ClassifyTextRequest

The document classification request message.

document

Input document.

document

Field google.cloud.language.v1.ClassifyTextRequest.document

class google.cloud.language_v1.types.ClassifyTextResponse

The document classification response message.

categories

Categories representing the input document.

categories

Field google.cloud.language.v1.ClassifyTextResponse.categories

class google.cloud.language_v1.types.CustomHttpPattern
kind

Field google.api.CustomHttpPattern.kind

path

Field google.api.CustomHttpPattern.path

class google.cloud.language_v1.types.DependencyEdge

Represents dependency parse tree information for a token. (For more information on dependency labels, see http://www.aclweb.org/anthology/P13-2017

head_token_index

Represents the head of this token in the dependency tree. This is the index of the token which has an arc going to this token. The index is the position of the token in the array of tokens returned by the API method. If this token is a root token, then the head_token_index is its own index.

label

The parse label for the token.

head_token_index

Field google.cloud.language.v1.DependencyEdge.head_token_index

label

Field google.cloud.language.v1.DependencyEdge.label

class google.cloud.language_v1.types.DescriptorProto
class ExtensionRange
end

Field google.protobuf.DescriptorProto.ExtensionRange.end

options

Field google.protobuf.DescriptorProto.ExtensionRange.options

start

Field google.protobuf.DescriptorProto.ExtensionRange.start

class ReservedRange
end

Field google.protobuf.DescriptorProto.ReservedRange.end

start

Field google.protobuf.DescriptorProto.ReservedRange.start

enum_type

Field google.protobuf.DescriptorProto.enum_type

extension

Field google.protobuf.DescriptorProto.extension

extension_range

Field google.protobuf.DescriptorProto.extension_range

field

Field google.protobuf.DescriptorProto.field

name

Field google.protobuf.DescriptorProto.name

nested_type

Field google.protobuf.DescriptorProto.nested_type

oneof_decl

Field google.protobuf.DescriptorProto.oneof_decl

options

Field google.protobuf.DescriptorProto.options

reserved_name

Field google.protobuf.DescriptorProto.reserved_name

reserved_range

Field google.protobuf.DescriptorProto.reserved_range

class google.cloud.language_v1.types.Document

Represents the input to API methods.

type

Required. If the type is not set or is TYPE_UNSPECIFIED, returns an INVALID_ARGUMENT error.

source

The source of the document: a string containing the content or a Google Cloud Storage URI.

content

The content of the input in string format. Cloud audit logging exempt since it is based on user data.

gcs_content_uri

The Google Cloud Storage URI where the file content is located. This URI must be of the form: gs://bucket_name/object_name. For more details, see https://cloud.google.com/storage/docs/reference-uris. NOTE: Cloud Storage object versioning is not supported.

language

The language of the document (if not specified, the language is automatically detected). Both ISO and BCP-47 language codes are accepted. Language Support lists currently supported languages for each API method. If the language (either specified by the caller or automatically detected) is not supported by the called API method, an INVALID_ARGUMENT error is returned.

content

Field google.cloud.language.v1.Document.content

gcs_content_uri

Field google.cloud.language.v1.Document.gcs_content_uri

language

Field google.cloud.language.v1.Document.language

type

Field google.cloud.language.v1.Document.type

class google.cloud.language_v1.types.Entity

Represents a phrase in the text that is a known entity, such as a person, an organization, or location. The API associates information, such as salience and mentions, with entities.

name

The representative name for the entity.

type

The entity type.

metadata

Metadata associated with the entity. For most entity types, the metadata is a Wikipedia URL (wikipedia_url) and Knowledge Graph MID (mid), if they are available. For the metadata associated with other entity types, see the Type table below.

salience

The salience score associated with the entity in the [0, 1.0] range. The salience score for an entity provides information about the importance or centrality of that entity to the entire document text. Scores closer to 0 are less salient, while scores closer to 1.0 are highly salient.

mentions

The mentions of this entity in the input document. The API currently supports proper noun mentions.

sentiment

For calls to [AnalyzeEntitySentiment][] or if [AnnotateTextReq uest.Features.extract_entity_sentiment][google.cloud.languag e.v1.AnnotateTextRequest.Features.extract_entity_sentiment] is set to true, this field will contain the aggregate sentiment expressed for this entity in the provided document.

class MetadataEntry
key

Field google.cloud.language.v1.Entity.MetadataEntry.key

value

Field google.cloud.language.v1.Entity.MetadataEntry.value

mentions

Field google.cloud.language.v1.Entity.mentions

metadata

Field google.cloud.language.v1.Entity.metadata

name

Field google.cloud.language.v1.Entity.name

salience

Field google.cloud.language.v1.Entity.salience

sentiment

Field google.cloud.language.v1.Entity.sentiment

type

Field google.cloud.language.v1.Entity.type

class google.cloud.language_v1.types.EntityMention

Represents a mention for an entity in the text. Currently, proper noun mentions are supported.

text

The mention text.

type

The type of the entity mention.

sentiment

For calls to [AnalyzeEntitySentiment][] or if [AnnotateTextReq uest.Features.extract_entity_sentiment][google.cloud.languag e.v1.AnnotateTextRequest.Features.extract_entity_sentiment] is set to true, this field will contain the sentiment expressed for this mention of the entity in the provided document.

sentiment

Field google.cloud.language.v1.EntityMention.sentiment

text

Field google.cloud.language.v1.EntityMention.text

type

Field google.cloud.language.v1.EntityMention.type

class google.cloud.language_v1.types.EnumDescriptorProto
class EnumReservedRange
end

Field google.protobuf.EnumDescriptorProto.EnumReservedRange.end

start

Field google.protobuf.EnumDescriptorProto.EnumReservedRange.start

name

Field google.protobuf.EnumDescriptorProto.name

options

Field google.protobuf.EnumDescriptorProto.options

reserved_name

Field google.protobuf.EnumDescriptorProto.reserved_name

reserved_range

Field google.protobuf.EnumDescriptorProto.reserved_range

value

Field google.protobuf.EnumDescriptorProto.value

class google.cloud.language_v1.types.EnumOptions
allow_alias

Field google.protobuf.EnumOptions.allow_alias

deprecated

Field google.protobuf.EnumOptions.deprecated

uninterpreted_option

Field google.protobuf.EnumOptions.uninterpreted_option

class google.cloud.language_v1.types.EnumValueDescriptorProto
name

Field google.protobuf.EnumValueDescriptorProto.name

number

Field google.protobuf.EnumValueDescriptorProto.number

options

Field google.protobuf.EnumValueDescriptorProto.options

class google.cloud.language_v1.types.EnumValueOptions
deprecated

Field google.protobuf.EnumValueOptions.deprecated

uninterpreted_option

Field google.protobuf.EnumValueOptions.uninterpreted_option

class google.cloud.language_v1.types.ExtensionRangeOptions
uninterpreted_option

Field google.protobuf.ExtensionRangeOptions.uninterpreted_option

class google.cloud.language_v1.types.FieldDescriptorProto
default_value

Field google.protobuf.FieldDescriptorProto.default_value

extendee

Field google.protobuf.FieldDescriptorProto.extendee

json_name

Field google.protobuf.FieldDescriptorProto.json_name

label

Field google.protobuf.FieldDescriptorProto.label

name

Field google.protobuf.FieldDescriptorProto.name

number

Field google.protobuf.FieldDescriptorProto.number

oneof_index

Field google.protobuf.FieldDescriptorProto.oneof_index

options

Field google.protobuf.FieldDescriptorProto.options

type

Field google.protobuf.FieldDescriptorProto.type

type_name

Field google.protobuf.FieldDescriptorProto.type_name

class google.cloud.language_v1.types.FieldOptions
ctype

Field google.protobuf.FieldOptions.ctype

deprecated

Field google.protobuf.FieldOptions.deprecated

jstype

Field google.protobuf.FieldOptions.jstype

lazy

Field google.protobuf.FieldOptions.lazy

packed

Field google.protobuf.FieldOptions.packed

uninterpreted_option

Field google.protobuf.FieldOptions.uninterpreted_option

weak

Field google.protobuf.FieldOptions.weak

class google.cloud.language_v1.types.FileDescriptorProto
dependency

Field google.protobuf.FileDescriptorProto.dependency

enum_type

Field google.protobuf.FileDescriptorProto.enum_type

extension

Field google.protobuf.FileDescriptorProto.extension

message_type

Field google.protobuf.FileDescriptorProto.message_type

name

Field google.protobuf.FileDescriptorProto.name

options

Field google.protobuf.FileDescriptorProto.options

package

Field google.protobuf.FileDescriptorProto.package

public_dependency

Field google.protobuf.FileDescriptorProto.public_dependency

service

Field google.protobuf.FileDescriptorProto.service

source_code_info

Field google.protobuf.FileDescriptorProto.source_code_info

syntax

Field google.protobuf.FileDescriptorProto.syntax

weak_dependency

Field google.protobuf.FileDescriptorProto.weak_dependency

class google.cloud.language_v1.types.FileDescriptorSet
file

Field google.protobuf.FileDescriptorSet.file

class google.cloud.language_v1.types.FileOptions
cc_enable_arenas

Field google.protobuf.FileOptions.cc_enable_arenas

cc_generic_services

Field google.protobuf.FileOptions.cc_generic_services

csharp_namespace

Field google.protobuf.FileOptions.csharp_namespace

deprecated

Field google.protobuf.FileOptions.deprecated

go_package

Field google.protobuf.FileOptions.go_package

java_generate_equals_and_hash

Field google.protobuf.FileOptions.java_generate_equals_and_hash

java_generic_services

Field google.protobuf.FileOptions.java_generic_services

java_multiple_files

Field google.protobuf.FileOptions.java_multiple_files

java_outer_classname

Field google.protobuf.FileOptions.java_outer_classname

java_package

Field google.protobuf.FileOptions.java_package

java_string_check_utf8

Field google.protobuf.FileOptions.java_string_check_utf8

objc_class_prefix

Field google.protobuf.FileOptions.objc_class_prefix

optimize_for

Field google.protobuf.FileOptions.optimize_for

php_class_prefix

Field google.protobuf.FileOptions.php_class_prefix

php_generic_services

Field google.protobuf.FileOptions.php_generic_services

php_metadata_namespace

Field google.protobuf.FileOptions.php_metadata_namespace

php_namespace

Field google.protobuf.FileOptions.php_namespace

py_generic_services

Field google.protobuf.FileOptions.py_generic_services

ruby_package

Field google.protobuf.FileOptions.ruby_package

swift_prefix

Field google.protobuf.FileOptions.swift_prefix

uninterpreted_option

Field google.protobuf.FileOptions.uninterpreted_option

class google.cloud.language_v1.types.GeneratedCodeInfo
class Annotation
begin

Field google.protobuf.GeneratedCodeInfo.Annotation.begin

end

Field google.protobuf.GeneratedCodeInfo.Annotation.end

path

Field google.protobuf.GeneratedCodeInfo.Annotation.path

source_file

Field google.protobuf.GeneratedCodeInfo.Annotation.source_file

annotation

Field google.protobuf.GeneratedCodeInfo.annotation

class google.cloud.language_v1.types.Http
fully_decode_reserved_expansion

Field google.api.Http.fully_decode_reserved_expansion

rules

Field google.api.Http.rules

class google.cloud.language_v1.types.HttpRule
additional_bindings

Field google.api.HttpRule.additional_bindings

body

Field google.api.HttpRule.body

custom

Field google.api.HttpRule.custom

delete

Field google.api.HttpRule.delete

get

Field google.api.HttpRule.get

patch

Field google.api.HttpRule.patch

post

Field google.api.HttpRule.post

put

Field google.api.HttpRule.put

response_body

Field google.api.HttpRule.response_body

selector

Field google.api.HttpRule.selector

class google.cloud.language_v1.types.MessageOptions
deprecated

Field google.protobuf.MessageOptions.deprecated

map_entry

Field google.protobuf.MessageOptions.map_entry

message_set_wire_format

Field google.protobuf.MessageOptions.message_set_wire_format

no_standard_descriptor_accessor

Field google.protobuf.MessageOptions.no_standard_descriptor_accessor

uninterpreted_option

Field google.protobuf.MessageOptions.uninterpreted_option

class google.cloud.language_v1.types.MethodDescriptorProto
client_streaming

Field google.protobuf.MethodDescriptorProto.client_streaming

input_type

Field google.protobuf.MethodDescriptorProto.input_type

name

Field google.protobuf.MethodDescriptorProto.name

options

Field google.protobuf.MethodDescriptorProto.options

output_type

Field google.protobuf.MethodDescriptorProto.output_type

server_streaming

Field google.protobuf.MethodDescriptorProto.server_streaming

class google.cloud.language_v1.types.MethodOptions
deprecated

Field google.protobuf.MethodOptions.deprecated

idempotency_level

Field google.protobuf.MethodOptions.idempotency_level

uninterpreted_option

Field google.protobuf.MethodOptions.uninterpreted_option

class google.cloud.language_v1.types.OneofDescriptorProto
name

Field google.protobuf.OneofDescriptorProto.name

options

Field google.protobuf.OneofDescriptorProto.options

class google.cloud.language_v1.types.OneofOptions
uninterpreted_option

Field google.protobuf.OneofOptions.uninterpreted_option

class google.cloud.language_v1.types.PartOfSpeech

Represents part of speech information for a token. Parts of speech are as defined in http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf

tag

The part of speech tag.

aspect

The grammatical aspect.

case

The grammatical case.

form

The grammatical form.

gender

The grammatical gender.

mood

The grammatical mood.

number

The grammatical number.

person

The grammatical person.

proper

The grammatical properness.

reciprocity

The grammatical reciprocity.

tense

The grammatical tense.

voice

The grammatical voice.

aspect

Field google.cloud.language.v1.PartOfSpeech.aspect

case

Field google.cloud.language.v1.PartOfSpeech.case

form

Field google.cloud.language.v1.PartOfSpeech.form

gender

Field google.cloud.language.v1.PartOfSpeech.gender

mood

Field google.cloud.language.v1.PartOfSpeech.mood

number

Field google.cloud.language.v1.PartOfSpeech.number

person

Field google.cloud.language.v1.PartOfSpeech.person

proper

Field google.cloud.language.v1.PartOfSpeech.proper

reciprocity

Field google.cloud.language.v1.PartOfSpeech.reciprocity

tag

Field google.cloud.language.v1.PartOfSpeech.tag

tense

Field google.cloud.language.v1.PartOfSpeech.tense

voice

Field google.cloud.language.v1.PartOfSpeech.voice

class google.cloud.language_v1.types.Sentence

Represents a sentence in the input document.

text

The sentence text.

sentiment

For calls to [AnalyzeSentiment][] or if [AnnotateTextRequest.F eatures.extract_document_sentiment][google.cloud.language.v1 .AnnotateTextRequest.Features.extract_document_sentiment] is set to true, this field will contain the sentiment for the sentence.

sentiment

Field google.cloud.language.v1.Sentence.sentiment

text

Field google.cloud.language.v1.Sentence.text

class google.cloud.language_v1.types.Sentiment

Represents the feeling associated with the entire text or entities in the text.

magnitude

A non-negative number in the [0, +inf) range, which represents the absolute magnitude of sentiment regardless of score (positive or negative).

score

Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).

magnitude

Field google.cloud.language.v1.Sentiment.magnitude

score

Field google.cloud.language.v1.Sentiment.score

class google.cloud.language_v1.types.ServiceDescriptorProto
method

Field google.protobuf.ServiceDescriptorProto.method

name

Field google.protobuf.ServiceDescriptorProto.name

options

Field google.protobuf.ServiceDescriptorProto.options

class google.cloud.language_v1.types.ServiceOptions
deprecated

Field google.protobuf.ServiceOptions.deprecated

uninterpreted_option

Field google.protobuf.ServiceOptions.uninterpreted_option

class google.cloud.language_v1.types.SourceCodeInfo
class Location
leading_comments

Field google.protobuf.SourceCodeInfo.Location.leading_comments

leading_detached_comments

Field google.protobuf.SourceCodeInfo.Location.leading_detached_comments

path

Field google.protobuf.SourceCodeInfo.Location.path

span

Field google.protobuf.SourceCodeInfo.Location.span

trailing_comments

Field google.protobuf.SourceCodeInfo.Location.trailing_comments

location

Field google.protobuf.SourceCodeInfo.location

class google.cloud.language_v1.types.TextSpan

Represents an output piece of text.

content

The content of the output text.

begin_offset

The API calculates the beginning offset of the content in the original document according to the [EncodingType][google.cloud.language.v1.EncodingType] specified in the API request.

begin_offset

Field google.cloud.language.v1.TextSpan.begin_offset

content

Field google.cloud.language.v1.TextSpan.content

class google.cloud.language_v1.types.Token

Represents the smallest syntactic building block of the text.

text

The token text.

part_of_speech

Parts of speech tag for this token.

dependency_edge

Dependency tree parse for this token.

lemma

Lemma of the token.

dependency_edge

Field google.cloud.language.v1.Token.dependency_edge

lemma

Field google.cloud.language.v1.Token.lemma

part_of_speech

Field google.cloud.language.v1.Token.part_of_speech

text

Field google.cloud.language.v1.Token.text

class google.cloud.language_v1.types.UninterpretedOption
class NamePart
is_extension

Field google.protobuf.UninterpretedOption.NamePart.is_extension

name_part

Field google.protobuf.UninterpretedOption.NamePart.name_part

aggregate_value

Field google.protobuf.UninterpretedOption.aggregate_value

double_value

Field google.protobuf.UninterpretedOption.double_value

identifier_value

Field google.protobuf.UninterpretedOption.identifier_value

name

Field google.protobuf.UninterpretedOption.name

negative_int_value

Field google.protobuf.UninterpretedOption.negative_int_value

positive_int_value

Field google.protobuf.UninterpretedOption.positive_int_value

string_value

Field google.protobuf.UninterpretedOption.string_value