google-cloud-language-v1 0.4.5 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c13f2bfa5d69ebf00f48707bbfc20f7433ad31f4e5db2f224ae6eec7bdd382bc
-  data.tar.gz: f99904a6b061a5644ede65372a0ca4ed260ec4a66934fd3935e3bc33e0e459d0
+  metadata.gz: 9adc4f1cd6b86c6aba8ebd140d79a2b5bf7c37e2bc068ab09efeded8e3223b4e
+  data.tar.gz: c72eb057130398c019db8eacaca7760bd6c248a9d11cc1f05db6fe7b838f6df5
 SHA512:
-  metadata.gz: 6308689a706646fa05d1ab8a740b64660e5bf3cc949fedd99701a76a71ed33ae31768ae517aff8a0b60159cc8bb86b183b67c267fba021199e49b2215289dd51
-  data.tar.gz: 3ea4253f9bdb550ca0192a87058521b054b06d386c6feb9b42467dc27b892ff2e159f35f044c4ceeca18151bebe0ed7eedede05c57cdca0b36fa0781ee4d6ffa
+  metadata.gz: b21eaec60cef78aa3cc57cd0e1615e5d9528a7f0c03edad486b2c053ed2e9baa5def3ce1beef465efc79e3fbdf16c517b356f84c5a4468651463938d2d9cca3c
+  data.tar.gz: 88f86e47b58d76ab57f5250a032c9a6ab124ec373279f4cea6d98d9c0050d2df54c2e33bfa1c5dd28290842b8e385075f538f8ef388b48b378035ff1851b441c

data/AUTHENTICATION.md

@@ -114,7 +114,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

data/README.md

@@ -37,7 +37,7 @@ request = ::Google::Cloud::Language::V1::AnalyzeSentimentRequest.new # (request
 response = client.analyze_sentiment request
 ```
 
-View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-language-v1/latest)
+View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-language-v1/latest)
 for class and method documentation.
 
 See also the [Product Documentation](https://cloud.google.com/natural-language)
@@ -69,16 +69,21 @@ module GRPC
 end
 ```
 
+
+## Google Cloud Samples
+
+To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
+
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.5+.
+This library is supported on Ruby 2.6+.
 
 Google provides official support for Ruby versions that are actively supported
 by Ruby Core—that is, Ruby versions that are either in normal maintenance or
-in security maintenance, and not end of life. Currently, this means Ruby 2.5
-and later. Older versions of Ruby _may_ still work, but are unsupported and not
-recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
-about the Ruby support schedule.
+in security maintenance, and not end of life. Older versions of Ruby _may_
+still work, but are unsupported and not recommended. See
+https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
+support schedule.
 
 ## Which client should I use?
 

data/lib/google/cloud/language/v1/language_service/client.rb

@@ -192,7 +192,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
-            #     Input document.
+            #     Required. Input document.
             #   @param encoding_type [::Google::Cloud::Language::V1::EncodingType]
             #     The encoding type used by the API to calculate sentence offsets.
             #
@@ -273,7 +273,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
-            #     Input document.
+            #     Required. Input document.
             #   @param encoding_type [::Google::Cloud::Language::V1::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #
@@ -353,7 +353,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
-            #     Input document.
+            #     Required. Input document.
             #   @param encoding_type [::Google::Cloud::Language::V1::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #
@@ -434,7 +434,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
-            #     Input document.
+            #     Required. Input document.
             #   @param encoding_type [::Google::Cloud::Language::V1::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #
@@ -507,13 +507,16 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload classify_text(document: nil)
+            # @overload classify_text(document: nil, classification_model_options: nil)
             #   Pass arguments to `classify_text` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
-            #     Input document.
+            #     Required. Input document.
+            #   @param classification_model_options [::Google::Cloud::Language::V1::ClassificationModelOptions, ::Hash]
+            #     Model options to use for classification. Defaults to v1 options if not
+            #     specified.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Language::V1::ClassifyTextResponse]
@@ -591,9 +594,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
-            #     Input document.
+            #     Required. Input document.
             #   @param features [::Google::Cloud::Language::V1::AnnotateTextRequest::Features, ::Hash]
-            #     The enabled features.
+            #     Required. The enabled features.
             #   @param encoding_type [::Google::Cloud::Language::V1::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #

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

@@ -1,10 +1,11 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/language/v1/language_service.proto
 
+require 'google/protobuf'
+
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/language/v1/language_service.proto", :syntax => :proto3) do
@@ -285,6 +286,22 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       optional :confidence, :float, 2
     end
+    add_message "google.cloud.language.v1.ClassificationModelOptions" do
+      oneof :model_type do
+        optional :v1_model, :message, 1, "google.cloud.language.v1.ClassificationModelOptions.V1Model"
+        optional :v2_model, :message, 2, "google.cloud.language.v1.ClassificationModelOptions.V2Model"
+      end
+    end
+    add_message "google.cloud.language.v1.ClassificationModelOptions.V1Model" do
+    end
+    add_message "google.cloud.language.v1.ClassificationModelOptions.V2Model" do
+      optional :content_categories_version, :enum, 1, "google.cloud.language.v1.ClassificationModelOptions.V2Model.ContentCategoriesVersion"
+    end
+    add_enum "google.cloud.language.v1.ClassificationModelOptions.V2Model.ContentCategoriesVersion" do
+      value :CONTENT_CATEGORIES_VERSION_UNSPECIFIED, 0
+      value :V1, 1
+      value :V2, 2
+    end
     add_message "google.cloud.language.v1.AnalyzeSentimentRequest" do
       optional :document, :message, 1, "google.cloud.language.v1.Document"
       optional :encoding_type, :enum, 2, "google.cloud.language.v1.EncodingType"
@@ -321,6 +338,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.language.v1.ClassifyTextRequest" do
       optional :document, :message, 1, "google.cloud.language.v1.Document"
+      optional :classification_model_options, :message, 3, "google.cloud.language.v1.ClassificationModelOptions"
     end
     add_message "google.cloud.language.v1.ClassifyTextResponse" do
       repeated :categories, :message, 1, "google.cloud.language.v1.ClassificationCategory"
@@ -336,6 +354,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :extract_document_sentiment, :bool, 3
       optional :extract_entity_sentiment, :bool, 4
       optional :classify_text, :bool, 6
+      optional :classification_model_options, :message, 10, "google.cloud.language.v1.ClassificationModelOptions"
     end
     add_message "google.cloud.language.v1.AnnotateTextResponse" do
       repeated :sentences, :message, 1, "google.cloud.language.v1.Sentence"
@@ -384,6 +403,10 @@ module Google
         EntityMention::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1.EntityMention.Type").enummodule
         TextSpan = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1.TextSpan").msgclass
         ClassificationCategory = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1.ClassificationCategory").msgclass
+        ClassificationModelOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1.ClassificationModelOptions").msgclass
+        ClassificationModelOptions::V1Model = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1.ClassificationModelOptions.V1Model").msgclass
+        ClassificationModelOptions::V2Model = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1.ClassificationModelOptions.V2Model").msgclass
+        ClassificationModelOptions::V2Model::ContentCategoriesVersion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1.ClassificationModelOptions.V2Model.ContentCategoriesVersion").enummodule
         AnalyzeSentimentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1.AnalyzeSentimentRequest").msgclass
         AnalyzeSentimentResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1.AnalyzeSentimentResponse").msgclass
         AnalyzeEntitySentimentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1.AnalyzeEntitySentimentRequest").msgclass

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

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/cloud/language/v1/language_service.proto for package 'google.cloud.language.v1'
 # Original file comments:
-# Copyright 2019 Google LLC.
+# Copyright 2022 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,7 +15,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-#
 
 require 'grpc'
 require 'google/cloud/language/v1/language_service_pb'

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Language
       module V1
-        VERSION = "0.4.5"
+        VERSION = "0.6.0"
       end
     end
   end

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

@@ -25,6 +25,8 @@ module Google
       ##
       # To load this package, including all its services, and instantiate a client:
       #
+      # @example
+      #
       #     require "google/cloud/language/v1"
       #     client = ::Google::Cloud::Language::V1::LanguageService::Client.new
       #

data/proto_docs/google/cloud/language/v1/language_service.rb

@@ -153,44 +153,53 @@ module Google
             # Other types of entities
             OTHER = 7
 
-            # Phone number<br><br>
+            # Phone number
+            #
             # The metadata lists the phone number, formatted according to local
-            # convention, plus whichever additional elements appear in the text:<ul>
-            # <li><code>number</code> &ndash; the actual number, broken down into
-            # sections as per local convention</li> <li><code>national_prefix</code>
-            # &ndash; country code, if detected</li> <li><code>area_code</code> &ndash;
-            # region or area code, if detected</li> <li><code>extension</code> &ndash;
-            # phone extension (to be dialed after connection), if detected</li></ul>
+            # 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<br><br>
+            # Address
+            #
             # The metadata identifies the street number and locality plus whichever
-            # additional elements appear in the text:<ul>
-            # <li><code>street_number</code> &ndash; street number</li>
-            # <li><code>locality</code> &ndash; city or town</li>
-            # <li><code>street_name</code> &ndash; street/route name, if detected</li>
-            # <li><code>postal_code</code> &ndash; postal code, if detected</li>
-            # <li><code>country</code> &ndash; country, if detected</li>
-            # <li><code>broad_region</code> &ndash; administrative area, such as the
-            # state, if detected</li> <li><code>narrow_region</code> &ndash; smaller
-            # administrative area, such as county, if detected</li>
-            # <li><code>sublocality</code> &ndash; used in Asian addresses to demark a
-            # district within a city, if detected</li></ul>
+            # 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<br><br>
-            # The metadata identifies the components of the date:<ul>
-            # <li><code>year</code> &ndash; four digit year, if detected</li>
-            # <li><code>month</code> &ndash; two digit month number, if detected</li>
-            # <li><code>day</code> &ndash; two digit day number, if detected</li></ul>
+            # 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<br><br>
+            # Number
+            #
             # The metadata is the number itself.
             NUMBER = 12
 
-            # Price<br><br>
-            # The metadata identifies the <code>value</code> and <code>currency</code>.
+            # Price
+            #
+            # The metadata identifies the `value` and `currency`.
             PRICE = 13
           end
         end
@@ -890,10 +899,53 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Model options available for classification requests.
+        # @!attribute [rw] v1_model
+        #   @return [::Google::Cloud::Language::V1::ClassificationModelOptions::V1Model]
+        #     Setting this field will use the V1 model and V1 content categories
+        #     version. The V1 model is a legacy model; support for this will be
+        #     discontinued in the future.
+        # @!attribute [rw] v2_model
+        #   @return [::Google::Cloud::Language::V1::ClassificationModelOptions::V2Model]
+        #     Setting this field will use the V2 model with the appropriate content
+        #     categories version. The V2 model is a better performing model.
+        class ClassificationModelOptions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Options for the V1 model.
+          class V1Model
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Options for the V2 model.
+          # @!attribute [rw] content_categories_version
+          #   @return [::Google::Cloud::Language::V1::ClassificationModelOptions::V2Model::ContentCategoriesVersion]
+          #     The content categories used for classification.
+          class V2Model
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # The content categories used for classification.
+            module ContentCategoriesVersion
+              # If `ContentCategoriesVersion` is not specified, this option will
+              # default to `V1`.
+              CONTENT_CATEGORIES_VERSION_UNSPECIFIED = 0
+
+              # Legacy content categories of our initial launch in 2017.
+              V1 = 1
+
+              # Updated content categories in 2022.
+              V2 = 2
+            end
+          end
+        end
+
         # The sentiment analysis request message.
         # @!attribute [rw] document
         #   @return [::Google::Cloud::Language::V1::Document]
-        #     Input document.
+        #     Required. Input document.
         # @!attribute [rw] encoding_type
         #   @return [::Google::Cloud::Language::V1::EncodingType]
         #     The encoding type used by the API to calculate sentence offsets.
@@ -922,7 +974,7 @@ module Google
         # The entity-level sentiment analysis request message.
         # @!attribute [rw] document
         #   @return [::Google::Cloud::Language::V1::Document]
-        #     Input document.
+        #     Required. Input document.
         # @!attribute [rw] encoding_type
         #   @return [::Google::Cloud::Language::V1::EncodingType]
         #     The encoding type used by the API to calculate offsets.
@@ -948,7 +1000,7 @@ module Google
         # The entity analysis request message.
         # @!attribute [rw] document
         #   @return [::Google::Cloud::Language::V1::Document]
-        #     Input document.
+        #     Required. Input document.
         # @!attribute [rw] encoding_type
         #   @return [::Google::Cloud::Language::V1::EncodingType]
         #     The encoding type used by the API to calculate offsets.
@@ -974,7 +1026,7 @@ module Google
         # The syntax analysis request message.
         # @!attribute [rw] document
         #   @return [::Google::Cloud::Language::V1::Document]
-        #     Input document.
+        #     Required. Input document.
         # @!attribute [rw] encoding_type
         #   @return [::Google::Cloud::Language::V1::EncodingType]
         #     The encoding type used by the API to calculate offsets.
@@ -1003,7 +1055,11 @@ module Google
         # The document classification request message.
         # @!attribute [rw] document
         #   @return [::Google::Cloud::Language::V1::Document]
-        #     Input document.
+        #     Required. Input document.
+        # @!attribute [rw] classification_model_options
+        #   @return [::Google::Cloud::Language::V1::ClassificationModelOptions]
+        #     Model options to use for classification. Defaults to v1 options if not
+        #     specified.
         class ClassifyTextRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1022,10 +1078,10 @@ module Google
         # analysis types (sentiment, entities, and syntax) in one call.
         # @!attribute [rw] document
         #   @return [::Google::Cloud::Language::V1::Document]
-        #     Input document.
+        #     Required. Input document.
         # @!attribute [rw] features
         #   @return [::Google::Cloud::Language::V1::AnnotateTextRequest::Features]
-        #     The enabled features.
+        #     Required. The enabled features.
         # @!attribute [rw] encoding_type
         #   @return [::Google::Cloud::Language::V1::EncodingType]
         #     The encoding type used by the API to calculate offsets.
@@ -1050,6 +1106,10 @@ module Google
           # @!attribute [rw] classify_text
           #   @return [::Boolean]
           #     Classify the full document into categories.
+          # @!attribute [rw] classification_model_options
+          #   @return [::Google::Cloud::Language::V1::ClassificationModelOptions]
+          #     The model options to use for classification. Defaults to v1 options
+          #     if not specified. Only used if `classify_text` is set to true.
           class Features
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-language-v1
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-11 00:00:00.000000000 Z
+date: 2022-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -50,28 +50,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
 - !ruby/object:Gem::Dependency
   name: minitest-focus
   requirement: !ruby/object:Gem::Requirement
@@ -106,14 +106,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
@@ -194,14 +194,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.4
+rubygems_version: 3.3.14
 signing_key: 
 specification_version: 4
 summary: API Client library for the Natural Language V1 API