google-cloud-language 0.33.1 → 0.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58f8cf8b51f275e7265b27ef1504dac3df1d9a3f17300b3af84a3d892cd0b598
-  data.tar.gz: 3625d7633d2efeddc8e8ea04123aff3f93b54e555a51d5fe5c24119441c3a18e
+  metadata.gz: 9e9de61824a89be458485342e9e57335609fad2ffb07d764546088848ffb2c6f
+  data.tar.gz: d444740ca28ff379ca8bf7a03a4dee229f844e1026c6ed27d664689e2bf44bff
 SHA512:
-  metadata.gz: 9a2d78215cb535512d9ef79088529b34a6a92c5827f3e441d3146ffd5869afa76683fc0b90622013e80698e4f3d458fe72b4e9a1edc4cb7ba201feda4810c3ea
-  data.tar.gz: 7c00b29dc0622077fefc39e1e73caf985f48bb1342e049a5f8a9c50be18b1cb3e280d7d697c3341f01a436f97a5b2c95777672e071b59eca8185461baca1ed7a
+  metadata.gz: 693f398b70c59aa6df35aa6f895805cac627a3b913d000692fa42f485296c869ea6846efdfd87b88b4affc778c02ee805687d86d6a6562c6cf604a1ccc18bfbe
+  data.tar.gz: 421f7fcdaec40040424e1fb4add3ebb6196c21867c49eec330011034f9e1795ffcde352caab3766b203c0bd375003bbadd1472db260253007f684594d5c541e7

data/lib/google/cloud/language/v1beta2/doc/google/cloud/language/v1beta2/language_service.rb

@@ -27,6 +27,7 @@ module Google
         # @!attribute [rw] content
         #   @return [String]
         #     The content of the input in string format.
+        #     Cloud audit logging exempt since it is based on user data.
         # @!attribute [rw] gcs_content_uri
         #   @return [String]
         #     The Google Cloud Storage URI where the file content is located.
@@ -64,8 +65,8 @@ module Google
         # @!attribute [rw] sentiment
         #   @return [Google::Cloud::Language::V1beta2::Sentiment]
         #     For calls to {AnalyzeSentiment} or if
-        #     {Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features#extract_document_sentiment AnnotateTextRequest::Features#extract_document_sentiment}
-        #     is set to true, this field will contain the sentiment for the sentence.
+        #     {Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features#extract_document_sentiment AnnotateTextRequest::Features#extract_document_sentiment} is set to
+        #     true, this field will contain the sentiment for the sentence.
         class Sentence; end
 
         # Represents a phrase in the text that is a known entity, such as
@@ -81,8 +82,9 @@ module Google
         #   @return [Hash{String => String}]
         #     Metadata associated with the entity.
         #
-        #     Currently, Wikipedia URLs and Knowledge Graph MIDs are provided, if
-        #     available. The associated keys are "wikipedia_url" and "mid", respectively.
+        #     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.
         # @!attribute [rw] salience
         #   @return [Float]
         #     The salience score associated with the entity in the [0, 1.0] range.
@@ -98,11 +100,14 @@ module Google
         # @!attribute [rw] sentiment
         #   @return [Google::Cloud::Language::V1beta2::Sentiment]
         #     For calls to {AnalyzeEntitySentiment} or if
-        #     {Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features#extract_entity_sentiment AnnotateTextRequest::Features#extract_entity_sentiment}
-        #     is set to true, this field will contain the aggregate sentiment expressed
-        #     for this entity in the provided document.
+        #     {Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features#extract_entity_sentiment 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 Entity
-          # The type of the entity.
+          # The type of the entity. For most entity types, the associated metadata is a
+          # Wikipedia URL (`wikipedia_url`) and Knowledge Graph MID (`mid`). The table
+          # below lists the associated fields for entities that have different
+          # metadata.
           module Type
             # Unknown
             UNKNOWN = 0
@@ -119,14 +124,63 @@ module Google
             # Event
             EVENT = 4
 
-            # Work of art
+            # Artwork
             WORK_OF_ART = 5
 
-            # Consumer goods
+            # Consumer product
             CONSUMER_GOOD = 6
 
-            # Other types
+            # Other types of entities
             OTHER = 7
+
+            # Phone number
+            #
+            # The metadata lists the phone number, formatted according to local
+            # convention, plus whichever additional elements appear in the text:
+            #
+            # * `number` - the actual number, broken down into sections as per local
+            #   convention
+            # * `national_prefix` - country code, if detected
+            # * `area_code` - region or area code, if detected
+            # * `extension` - phone extension (to be dialed after connection), if
+            #   detected
+            PHONE_NUMBER = 9
+
+            # Address
+            #
+            # The metadata identifies the street number and locality plus whichever
+            # additional elements appear in the text:
+            #
+            # * `street_number` - street number
+            # * `locality` - city or town
+            # * `street_name` - street/route name, if detected
+            # * `postal_code` - postal code, if detected
+            # * `country` - country, if detected<
+            # * `broad_region` - administrative area, such as the state, if detected
+            # * `narrow_region` - smaller administrative area, such as county, if
+            #   detected
+            # * `sublocality` - used in Asian addresses to demark a district within a
+            #   city, if detected
+            ADDRESS = 10
+
+            # Date
+            #
+            # The metadata identifies the components of the date:
+            #
+            # * `year` - four digit year, if detected
+            # * `month` - two digit month number, if detected
+            # * `day` - two digit day number, if detected
+            DATE = 11
+
+            # Number
+            #
+            # The metadata is the number itself.
+            NUMBER = 12
+
+            # Price
+            #
+            # The metadata identifies the `value` and `currency`.
+            PRICE = 13
           end
         end
 
@@ -147,6 +201,7 @@ module Google
 
         # Represents the feeling associated with the entire text or entities in
         # the text.
+        # Next ID: 6
         # @!attribute [rw] magnitude
         #   @return [Float]
         #     A non-negative number in the [0, +inf) range, which represents
@@ -762,9 +817,9 @@ module Google
         # @!attribute [rw] sentiment
         #   @return [Google::Cloud::Language::V1beta2::Sentiment]
         #     For calls to {AnalyzeEntitySentiment} or if
-        #     {Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features#extract_entity_sentiment 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.
+        #     {Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features#extract_entity_sentiment 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.
         class EntityMention
           # The supported types of mentions.
           module Type
@@ -786,15 +841,14 @@ module Google
         # @!attribute [rw] begin_offset
         #   @return [Integer]
         #     The API calculates the beginning offset of the content in the original
-        #     document according to the
-        #     {Google::Cloud::Language::V1beta2::EncodingType EncodingType} specified in the
-        #     API request.
+        #     document according to the {Google::Cloud::Language::V1beta2::EncodingType EncodingType} specified in the API request.
         class TextSpan; end
 
         # Represents a category returned from the text classifier.
         # @!attribute [rw] name
         #   @return [String]
-        #     The name of the category representing the document.
+        #     The name of the category representing the document, from the [predefined
+        #     taxonomy](/natural-language/docs/categories).
         # @!attribute [rw] confidence
         #   @return [Float]
         #     The classifier's confidence of the category. Number represents how certain
@@ -804,7 +858,7 @@ module Google
         # The sentiment analysis request message.
         # @!attribute [rw] document
         #   @return [Google::Cloud::Language::V1beta2::Document]
-        #     Input document.
+        #     Required. Input document.
         # @!attribute [rw] encoding_type
         #   @return [Google::Cloud::Language::V1beta2::EncodingType]
         #     The encoding type used by the API to calculate sentence offsets for the
@@ -819,8 +873,7 @@ module Google
         #   @return [String]
         #     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 {Google::Cloud::Language::V1beta2::Document#language Document#language}
-        #     field for more details.
+        #     See {Google::Cloud::Language::V1beta2::Document#language Document#language} field for more details.
         # @!attribute [rw] sentences
         #   @return [Array<Google::Cloud::Language::V1beta2::Sentence>]
         #     The sentiment for all the sentences in the document.
@@ -829,7 +882,7 @@ module Google
         # The entity-level sentiment analysis request message.
         # @!attribute [rw] document
         #   @return [Google::Cloud::Language::V1beta2::Document]
-        #     Input document.
+        #     Required. Input document.
         # @!attribute [rw] encoding_type
         #   @return [Google::Cloud::Language::V1beta2::EncodingType]
         #     The encoding type used by the API to calculate offsets.
@@ -843,14 +896,13 @@ module Google
         #   @return [String]
         #     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 {Google::Cloud::Language::V1beta2::Document#language Document#language}
-        #     field for more details.
+        #     See {Google::Cloud::Language::V1beta2::Document#language Document#language} field for more details.
         class AnalyzeEntitySentimentResponse; end
 
         # The entity analysis request message.
         # @!attribute [rw] document
         #   @return [Google::Cloud::Language::V1beta2::Document]
-        #     Input document.
+        #     Required. Input document.
         # @!attribute [rw] encoding_type
         #   @return [Google::Cloud::Language::V1beta2::EncodingType]
         #     The encoding type used by the API to calculate offsets.
@@ -864,14 +916,13 @@ module Google
         #   @return [String]
         #     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 {Google::Cloud::Language::V1beta2::Document#language Document#language}
-        #     field for more details.
+        #     See {Google::Cloud::Language::V1beta2::Document#language Document#language} field for more details.
         class AnalyzeEntitiesResponse; end
 
         # The syntax analysis request message.
         # @!attribute [rw] document
         #   @return [Google::Cloud::Language::V1beta2::Document]
-        #     Input document.
+        #     Required. Input document.
         # @!attribute [rw] encoding_type
         #   @return [Google::Cloud::Language::V1beta2::EncodingType]
         #     The encoding type used by the API to calculate offsets.
@@ -888,14 +939,13 @@ module Google
         #   @return [String]
         #     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 {Google::Cloud::Language::V1beta2::Document#language Document#language}
-        #     field for more details.
+        #     See {Google::Cloud::Language::V1beta2::Document#language Document#language} field for more details.
         class AnalyzeSyntaxResponse; end
 
         # The document classification request message.
         # @!attribute [rw] document
         #   @return [Google::Cloud::Language::V1beta2::Document]
-        #     Input document.
+        #     Required. Input document.
         class ClassifyTextRequest; end
 
         # The document classification response message.
@@ -908,16 +958,17 @@ module Google
         # analysis types (sentiment, entities, and syntax) in one call.
         # @!attribute [rw] document
         #   @return [Google::Cloud::Language::V1beta2::Document]
-        #     Input document.
+        #     Required. Input document.
         # @!attribute [rw] features
         #   @return [Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features]
-        #     The enabled features.
+        #     Required. The enabled features.
         # @!attribute [rw] encoding_type
         #   @return [Google::Cloud::Language::V1beta2::EncodingType]
         #     The encoding type used by the API to calculate offsets.
         class AnnotateTextRequest
           # All available features for sentiment, syntax, and semantic analysis.
           # Setting each one to true will enable that specific analysis for the input.
+          # Next ID: 10
           # @!attribute [rw] extract_syntax
           #   @return [true, false]
           #     Extract syntax information.
@@ -932,7 +983,9 @@ module Google
           #     Extract entities and their associated sentiment.
           # @!attribute [rw] classify_text
           #   @return [true, false]
-          #     Classify the full document into categories.
+          #     Classify the full document into categories. If this is true,
+          #     the API will use the default model which classifies into a
+          #     [predefined taxonomy](https://cloud.google.com/natural-language/docs/categories).
           class Features; end
         end
 
@@ -959,8 +1012,7 @@ module Google
         #   @return [String]
         #     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 {Google::Cloud::Language::V1beta2::Document#language Document#language}
-        #     field for more details.
+        #     See {Google::Cloud::Language::V1beta2::Document#language Document#language} field for more details.
         # @!attribute [rw] categories
         #   @return [Array<Google::Cloud::Language::V1beta2::ClassificationCategory>]
         #     Categories identified in the input document.
@@ -982,7 +1034,7 @@ module Google
           UTF8 = 1
 
           # Encoding-dependent information (such as `begin_offset`) is calculated based
-          # on the UTF-16 encoding of the input. Java and Javascript are examples of
+          # on the UTF-16 encoding of the input. Java and JavaScript are examples of
           # languages that use this encoding natively.
           UTF16 = 2
 

data/lib/google/cloud/language/v1beta2/language_service_client.rb

@@ -205,7 +205,7 @@ module Google
           # Analyzes the sentiment of the provided text.
           #
           # @param document [Google::Cloud::Language::V1beta2::Document | Hash]
-          #   Input document.
+          #   Required. Input document.
           #   A hash of the same form as `Google::Cloud::Language::V1beta2::Document`
           #   can also be provided.
           # @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
@@ -246,7 +246,7 @@ module Google
           # other properties.
           #
           # @param document [Google::Cloud::Language::V1beta2::Document | Hash]
-          #   Input document.
+          #   Required. Input document.
           #   A hash of the same form as `Google::Cloud::Language::V1beta2::Document`
           #   can also be provided.
           # @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
@@ -281,13 +281,11 @@ module Google
             @analyze_entities.call(req, options, &block)
           end
 
-          # Finds entities, similar to
-          # {Google::Cloud::Language::V1beta2::LanguageService::AnalyzeEntities AnalyzeEntities}
-          # in the text and analyzes sentiment associated with each entity and its
-          # mentions.
+          # Finds entities, similar to {Google::Cloud::Language::V1beta2::LanguageService::AnalyzeEntities AnalyzeEntities} in the text and analyzes
+          # sentiment associated with each entity and its mentions.
           #
           # @param document [Google::Cloud::Language::V1beta2::Document | Hash]
-          #   Input document.
+          #   Required. Input document.
           #   A hash of the same form as `Google::Cloud::Language::V1beta2::Document`
           #   can also be provided.
           # @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
@@ -327,7 +325,7 @@ module Google
           # properties.
           #
           # @param document [Google::Cloud::Language::V1beta2::Document | Hash]
-          #   Input document.
+          #   Required. Input document.
           #   A hash of the same form as `Google::Cloud::Language::V1beta2::Document`
           #   can also be provided.
           # @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
@@ -365,7 +363,7 @@ module Google
           # Classifies a document into categories.
           #
           # @param document [Google::Cloud::Language::V1beta2::Document | Hash]
-          #   Input document.
+          #   Required. Input document.
           #   A hash of the same form as `Google::Cloud::Language::V1beta2::Document`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
@@ -400,11 +398,11 @@ module Google
           # classification features in one call.
           #
           # @param document [Google::Cloud::Language::V1beta2::Document | Hash]
-          #   Input document.
+          #   Required. Input document.
           #   A hash of the same form as `Google::Cloud::Language::V1beta2::Document`
           #   can also be provided.
           # @param features [Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features | Hash]
-          #   The enabled features.
+          #   Required. The enabled features.
           #   A hash of the same form as `Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features`
           #   can also be provided.
           # @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]

data/lib/google/cloud/language/v1beta2/language_service_pb.rb

@@ -5,9 +5,9 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
-require 'google/longrunning/operations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
 require 'google/protobuf/timestamp_pb'
-require 'google/rpc/status_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.language.v1beta2.Document" do
     optional :type, :enum, 1, "google.cloud.language.v1beta2.Document.Type"
@@ -43,6 +43,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     value :WORK_OF_ART, 5
     value :CONSUMER_GOOD, 6
     value :OTHER, 7
+    value :PHONE_NUMBER, 9
+    value :ADDRESS, 10
+    value :DATE, 11
+    value :NUMBER, 12
+    value :PRICE, 13
   end
   add_message "google.cloud.language.v1beta2.Token" do
     optional :text, :message, 1, "google.cloud.language.v1beta2.TextSpan"

data/lib/google/cloud/language/v1beta2/language_service_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/cloud/language/v1beta2/language_service.proto for package 'google.cloud.language.v1beta2'
 # Original file comments:
-# Copyright 2017 Google Inc.
+# Copyright 2019 Google LLC.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+#
 
 
 require 'grpc'
@@ -41,10 +42,8 @@ module Google
             # along with entity types, salience, mentions for each entity, and
             # other properties.
             rpc :AnalyzeEntities, AnalyzeEntitiesRequest, AnalyzeEntitiesResponse
-            # Finds entities, similar to
-            # [AnalyzeEntities][google.cloud.language.v1beta2.LanguageService.AnalyzeEntities]
-            # in the text and analyzes sentiment associated with each entity and its
-            # mentions.
+            # Finds entities, similar to [AnalyzeEntities][google.cloud.language.v1beta2.LanguageService.AnalyzeEntities] in the text and analyzes
+            # sentiment associated with each entity and its mentions.
             rpc :AnalyzeEntitySentiment, AnalyzeEntitySentimentRequest, AnalyzeEntitySentimentResponse
             # Analyzes the syntax of the text and provides sentence boundaries and
             # tokenization along with part of speech tags, dependency trees, and other

data/lib/google/cloud/language/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Language
-      VERSION = "0.33.1".freeze
+      VERSION = "0.34.0".freeze
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-language
 version: !ruby/object:Gem::Version
-  version: 0.33.1
+  version: 0.34.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-08-23 00:00:00.000000000 Z
+date: 2019-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-gax