google-cloud-language-v1beta2 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56f9e9b312a79ef923972f23ee2e8da6163dabf1a861c175489524a3fdfc29e2
-  data.tar.gz: 913de7079429ec3610ffbe74f48b0d1d2cacd00dec8127b86d70288ceb91a9e8
+  metadata.gz: 54edb9b0db12a1443da0bdbaefc899d151ea1f4d62ee48739ddccb2028472c01
+  data.tar.gz: c64d9f82f2936a70d140cecf3baba4d855763566fa731a1e240b47d0f47192ae
 SHA512:
-  metadata.gz: c2f78891180cee7dcd3cbfb0d940d0f559b9da743804c1f6cb19654568829f25811d84b443b9f849e5cbf8157a2b294ec18e5e8dff148023fd7d5b21dedb8532
-  data.tar.gz: 473801d11693a76525321de423a2f603aa82f2e44a0ac0b108c556c3a23206d27390c683f9e148cf388bc7ef3a982c12ed7f62bc96066ae3cd55fc310fe41c1f
+  metadata.gz: 70a0015537cc76fedbf5568a4df22197b5c78b3b5ad19322ddbe84a0e6f058649eef41274a1351e160573bbc4c6d4dbec11bebf9dbec0fc798a30c546eda26d2
+  data.tar.gz: 83c1ea529ab771c558beed222cd7a5336a75a142df43e455166ecc2f869399e1b9356485d5411a23730ec5a0c9bf6d296c9f39a315bfacf811c235435bbaa568

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/lib/google/cloud/language/v1beta2/language_service/client.rb

@@ -416,7 +416,7 @@ module Google
 
             ##
             # Analyzes the syntax of the text and provides sentence boundaries and
-            # tokenization along with part-of-speech tags, dependency trees, and other
+            # tokenization along with part of speech tags, dependency trees, and other
             # properties.
             #
             # @overload analyze_syntax(request, options = nil)
@@ -508,13 +508,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::V1beta2::Document, ::Hash]
             #     Required. Input document.
+            #   @param classification_model_options [::Google::Cloud::Language::V1beta2::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::V1beta2::ClassifyTextResponse]

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

@@ -6,13 +6,14 @@ require 'google/protobuf'
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
-require 'google/protobuf/timestamp_pb'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/language/v1beta2/language_service.proto", :syntax => :proto3) do
     add_message "google.cloud.language.v1beta2.Document" do
       optional :type, :enum, 1, "google.cloud.language.v1beta2.Document.Type"
       optional :language, :string, 4
+      optional :reference_web_uri, :string, 5
+      optional :boilerplate_handling, :enum, 6, "google.cloud.language.v1beta2.Document.BoilerplateHandling"
       oneof :source do
         optional :content, :string, 2
         optional :gcs_content_uri, :string, 3
@@ -23,6 +24,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :PLAIN_TEXT, 1
       value :HTML, 2
     end
+    add_enum "google.cloud.language.v1beta2.Document.BoilerplateHandling" do
+      value :BOILERPLATE_HANDLING_UNSPECIFIED, 0
+      value :SKIP_BOILERPLATE, 1
+      value :KEEP_BOILERPLATE, 2
+    end
     add_message "google.cloud.language.v1beta2.Sentence" do
       optional :text, :message, 1, "google.cloud.language.v1beta2.TextSpan"
       optional :sentiment, :message, 2, "google.cloud.language.v1beta2.Sentiment"
@@ -287,6 +293,22 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       optional :confidence, :float, 2
     end
+    add_message "google.cloud.language.v1beta2.ClassificationModelOptions" do
+      oneof :model_type do
+        optional :v1_model, :message, 1, "google.cloud.language.v1beta2.ClassificationModelOptions.V1Model"
+        optional :v2_model, :message, 2, "google.cloud.language.v1beta2.ClassificationModelOptions.V2Model"
+      end
+    end
+    add_message "google.cloud.language.v1beta2.ClassificationModelOptions.V1Model" do
+    end
+    add_message "google.cloud.language.v1beta2.ClassificationModelOptions.V2Model" do
+      optional :content_categories_version, :enum, 1, "google.cloud.language.v1beta2.ClassificationModelOptions.V2Model.ContentCategoriesVersion"
+    end
+    add_enum "google.cloud.language.v1beta2.ClassificationModelOptions.V2Model.ContentCategoriesVersion" do
+      value :CONTENT_CATEGORIES_VERSION_UNSPECIFIED, 0
+      value :V1, 1
+      value :V2, 2
+    end
     add_message "google.cloud.language.v1beta2.AnalyzeSentimentRequest" do
       optional :document, :message, 1, "google.cloud.language.v1beta2.Document"
       optional :encoding_type, :enum, 2, "google.cloud.language.v1beta2.EncodingType"
@@ -323,6 +345,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.language.v1beta2.ClassifyTextRequest" do
       optional :document, :message, 1, "google.cloud.language.v1beta2.Document"
+      optional :classification_model_options, :message, 3, "google.cloud.language.v1beta2.ClassificationModelOptions"
     end
     add_message "google.cloud.language.v1beta2.ClassifyTextResponse" do
       repeated :categories, :message, 1, "google.cloud.language.v1beta2.ClassificationCategory"
@@ -338,6 +361,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.v1beta2.ClassificationModelOptions"
     end
     add_message "google.cloud.language.v1beta2.AnnotateTextResponse" do
       repeated :sentences, :message, 1, "google.cloud.language.v1beta2.Sentence"
@@ -362,6 +386,7 @@ module Google
       module V1beta2
         Document = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.Document").msgclass
         Document::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.Document.Type").enummodule
+        Document::BoilerplateHandling = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.Document.BoilerplateHandling").enummodule
         Sentence = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.Sentence").msgclass
         Entity = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.Entity").msgclass
         Entity::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.Entity.Type").enummodule
@@ -386,6 +411,10 @@ module Google
         EntityMention::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.EntityMention.Type").enummodule
         TextSpan = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.TextSpan").msgclass
         ClassificationCategory = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.ClassificationCategory").msgclass
+        ClassificationModelOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.ClassificationModelOptions").msgclass
+        ClassificationModelOptions::V1Model = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.ClassificationModelOptions.V1Model").msgclass
+        ClassificationModelOptions::V2Model = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.ClassificationModelOptions.V2Model").msgclass
+        ClassificationModelOptions::V2Model::ContentCategoriesVersion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.ClassificationModelOptions.V2Model.ContentCategoriesVersion").enummodule
         AnalyzeSentimentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.AnalyzeSentimentRequest").msgclass
         AnalyzeSentimentResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.AnalyzeSentimentResponse").msgclass
         AnalyzeEntitySentimentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.language.v1beta2.AnalyzeEntitySentimentRequest").msgclass

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 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/v1beta2/language_service_pb'
@@ -45,7 +44,7 @@ module Google
             # sentiment associated with each entity and its mentions.
             rpc :AnalyzeEntitySentiment, ::Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentRequest, ::Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentResponse
             # Analyzes the syntax of the text and provides sentence boundaries and
-            # tokenization along with part-of-speech tags, dependency trees, and other
+            # tokenization along with part of speech tags, dependency trees, and other
             # properties.
             rpc :AnalyzeSyntax, ::Google::Cloud::Language::V1beta2::AnalyzeSyntaxRequest, ::Google::Cloud::Language::V1beta2::AnalyzeSyntaxResponse
             # Classifies a document into categories.

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Language
       module V1beta2
-        VERSION = "0.5.0"
+        VERSION = "0.6.0"
       end
     end
   end

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

@@ -46,6 +46,15 @@ module Google
         #     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.
+        # @!attribute [rw] reference_web_uri
+        #   @return [::String]
+        #     The web URI where the document comes from. This URI is not used for
+        #     fetching the content, but as a hint for analyzing the document.
+        # @!attribute [rw] boilerplate_handling
+        #   @return [::Google::Cloud::Language::V1beta2::Document::BoilerplateHandling]
+        #     Indicates how detected boilerplate(e.g. advertisements, copyright
+        #     declarations, banners) should be handled for this document. If not
+        #     specified, boilerplate will be treated the same as content.
         class Document
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -61,6 +70,19 @@ module Google
             # HTML
             HTML = 2
           end
+
+          # Ways of handling boilerplate detected in the document
+          module BoilerplateHandling
+            # The boilerplate handling is not specified.
+            BOILERPLATE_HANDLING_UNSPECIFIED = 0
+
+            # Do not analyze detected boilerplate. Reference web URI is required for
+            # detecting boilerplate.
+            SKIP_BOILERPLATE = 1
+
+            # Treat boilerplate the same as content.
+            KEEP_BOILERPLATE = 2
+          end
         end
 
         # Represents a sentence in the input document.
@@ -896,6 +918,49 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Model options available for classification requests.
+        # @!attribute [rw] v1_model
+        #   @return [::Google::Cloud::Language::V1beta2::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::V1beta2::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::V1beta2::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::V1beta2::Document]
@@ -1011,6 +1076,10 @@ module Google
         # @!attribute [rw] document
         #   @return [::Google::Cloud::Language::V1beta2::Document]
         #     Required. Input document.
+        # @!attribute [rw] classification_model_options
+        #   @return [::Google::Cloud::Language::V1beta2::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
@@ -1042,7 +1111,7 @@ module Google
 
           # 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
+          # Next ID: 11
           # @!attribute [rw] extract_syntax
           #   @return [::Boolean]
           #     Extract syntax information.
@@ -1061,6 +1130,10 @@ module Google
           #     the API will use the default model which classifies into a
           #     [predefined
           #     taxonomy](https://cloud.google.com/natural-language/docs/categories).
+          # @!attribute [rw] classification_model_options
+          #   @return [::Google::Cloud::Language::V1beta2::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-v1beta2
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-02 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.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -182,7 +182,6 @@ files:
 - proto_docs/google/api/field_behavior.rb
 - proto_docs/google/api/resource.rb
 - proto_docs/google/cloud/language/v1beta2/language_service.rb
-- proto_docs/google/protobuf/timestamp.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0

data/proto_docs/google/protobuf/timestamp.rb

@@ -1,129 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright 2020 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
-
-
-module Google
-  module Protobuf
-    # A Timestamp represents a point in time independent of any time zone or local
-    # calendar, encoded as a count of seconds and fractions of seconds at
-    # nanosecond resolution. The count is relative to an epoch at UTC midnight on
-    # January 1, 1970, in the proleptic Gregorian calendar which extends the
-    # Gregorian calendar backwards to year one.
-    #
-    # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
-    # second table is needed for interpretation, using a [24-hour linear
-    # smear](https://developers.google.com/time/smear).
-    #
-    # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
-    # restricting to that range, we ensure that we can convert to and from [RFC
-    # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
-    #
-    # # Examples
-    #
-    # Example 1: Compute Timestamp from POSIX `time()`.
-    #
-    #     Timestamp timestamp;
-    #     timestamp.set_seconds(time(NULL));
-    #     timestamp.set_nanos(0);
-    #
-    # Example 2: Compute Timestamp from POSIX `gettimeofday()`.
-    #
-    #     struct timeval tv;
-    #     gettimeofday(&tv, NULL);
-    #
-    #     Timestamp timestamp;
-    #     timestamp.set_seconds(tv.tv_sec);
-    #     timestamp.set_nanos(tv.tv_usec * 1000);
-    #
-    # Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
-    #
-    #     FILETIME ft;
-    #     GetSystemTimeAsFileTime(&ft);
-    #     UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;
-    #
-    #     // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
-    #     // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
-    #     Timestamp timestamp;
-    #     timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
-    #     timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
-    #
-    # Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
-    #
-    #     long millis = System.currentTimeMillis();
-    #
-    #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
-    #         .setNanos((int) ((millis % 1000) * 1000000)).build();
-    #
-    #
-    # Example 5: Compute Timestamp from Java `Instant.now()`.
-    #
-    #     Instant now = Instant.now();
-    #
-    #     Timestamp timestamp =
-    #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
-    #             .setNanos(now.getNano()).build();
-    #
-    #
-    # Example 6: Compute Timestamp from current time in Python.
-    #
-    #     timestamp = Timestamp()
-    #     timestamp.GetCurrentTime()
-    #
-    # # JSON Mapping
-    #
-    # In JSON format, the Timestamp type is encoded as a string in the
-    # [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
-    # format is "\\{year}-\\{month}-\\{day}T\\{hour}:\\{min}:\\{sec}[.\\{frac_sec}]Z"
-    # where \\{year} is always expressed using four digits while \\{month}, \\{day},
-    # \\{hour}, \\{min}, and \\{sec} are zero-padded to two digits each. The fractional
-    # seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
-    # are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
-    # is required. A proto3 JSON serializer should always use UTC (as indicated by
-    # "Z") when printing the Timestamp type and a proto3 JSON parser should be
-    # able to accept both UTC and other timezones (as indicated by an offset).
-    #
-    # For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
-    # 01:30 UTC on January 15, 2017.
-    #
-    # In JavaScript, one can convert a Date object to this format using the
-    # standard
-    # [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
-    # method. In Python, a standard `datetime.datetime` object can be converted
-    # to this format using
-    # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
-    # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
-    # the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
-    # ) to obtain a formatter capable of generating timestamps in this format.
-    # @!attribute [rw] seconds
-    #   @return [::Integer]
-    #     Represents seconds of UTC time since Unix epoch
-    #     1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
-    #     9999-12-31T23:59:59Z inclusive.
-    # @!attribute [rw] nanos
-    #   @return [::Integer]
-    #     Non-negative fractions of a second at nanosecond resolution. Negative
-    #     second values with fractions must still have non-negative nanos values
-    #     that count forward in time. Must be from 0 to 999,999,999
-    #     inclusive.
-    class Timestamp
-      include ::Google::Protobuf::MessageExts
-      extend ::Google::Protobuf::MessageExts::ClassMethods
-    end
-  end
-end