google-cloud-language-v1 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9adc4f1cd6b86c6aba8ebd140d79a2b5bf7c37e2bc068ab09efeded8e3223b4e
-  data.tar.gz: c72eb057130398c019db8eacaca7760bd6c248a9d11cc1f05db6fe7b838f6df5
+  metadata.gz: 57b3621633efdcf5ed36ae27fa2c760b8d9eef4a80cf5673d987eef5bae262f3
+  data.tar.gz: b5a70cc8b6a46cf0d2b4755217fa3132245a4c8316c68f580b39bba423f963ec
 SHA512:
-  metadata.gz: b21eaec60cef78aa3cc57cd0e1615e5d9528a7f0c03edad486b2c053ed2e9baa5def3ce1beef465efc79e3fbdf16c517b356f84c5a4468651463938d2d9cca3c
-  data.tar.gz: 88f86e47b58d76ab57f5250a032c9a6ab124ec373279f4cea6d98d9c0050d2df54c2e33bfa1c5dd28290842b8e385075f538f8ef388b48b378035ff1851b441c
+  metadata.gz: c5cca96d308085f9653821e4293a4e64f8fa502bc5530321a8b801eabb034612e20926faeb5e0d81f5b62fd19546699577898b50e8270048063b9a3ff6091ce5
+  data.tar.gz: 1cb0ae3259d58e2eb469a0f25a7887eeef778656a970d8699ad7fd4b5167ff9fce8f72712c0768b0032d7919aa8da3feb1e4541060420dc931997e342dd7bd90

data/README.md

@@ -1,6 +1,6 @@
 # Ruby Client for the Natural Language V1 API
 
-API Client library for the Natural Language V1 API
+Provides natural language understanding technologies, such as sentiment analysis, entity recognition, entity sentiment analysis, and other text annotations, to developers.
 
 Provides natural language understanding technologies, such as sentiment analysis, entity recognition, entity sentiment analysis, and other text annotations.
 
@@ -46,8 +46,8 @@ for general usage information.
 ## Enabling Logging
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
-The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
+or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
 that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
 

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

@@ -334,8 +334,10 @@ module Google
             end
 
             ##
-            # Finds entities, similar to {::Google::Cloud::Language::V1::LanguageService::Client#analyze_entities AnalyzeEntities} in the text and analyzes
-            # sentiment associated with each entity and its mentions.
+            # Finds entities, similar to
+            # {::Google::Cloud::Language::V1::LanguageService::Client#analyze_entities AnalyzeEntities}
+            # in the text and analyzes sentiment associated with each entity and its
+            # mentions.
             #
             # @overload analyze_entity_sentiment(request, options = nil)
             #   Pass arguments to `analyze_entity_sentiment` via a request object, either of type
@@ -574,6 +576,83 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Moderates a document for harmful and sensitive categories.
+            #
+            # @overload moderate_text(request, options = nil)
+            #   Pass arguments to `moderate_text` via a request object, either of type
+            #   {::Google::Cloud::Language::V1::ModerateTextRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Language::V1::ModerateTextRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload moderate_text(document: nil)
+            #   Pass arguments to `moderate_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]
+            #     Required. Input document.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Language::V1::ModerateTextResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Language::V1::ModerateTextResponse]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/language/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Language::V1::LanguageService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Language::V1::ModerateTextRequest.new
+            #
+            #   # Call the moderate_text method.
+            #   result = client.moderate_text request
+            #
+            #   # The returned object is of type Google::Cloud::Language::V1::ModerateTextResponse.
+            #   p result
+            #
+            def moderate_text request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1::ModerateTextRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.moderate_text.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Language::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              options.apply_defaults timeout:      @config.rpcs.moderate_text.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.moderate_text.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @language_service_stub.call_rpc :moderate_text, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # A convenience method that provides all the features that analyzeSentiment,
             # analyzeEntities, and analyzeSyntax provide in one call.
@@ -694,9 +773,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
@@ -817,6 +896,11 @@ module Google
                 #
                 attr_reader :classify_text
                 ##
+                # RPC-specific configuration for `moderate_text`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :moderate_text
+                ##
                 # RPC-specific configuration for `annotate_text`
                 # @return [::Gapic::Config::Method]
                 #
@@ -834,6 +918,8 @@ module Google
                   @analyze_syntax = ::Gapic::Config::Method.new analyze_syntax_config
                   classify_text_config = parent_rpcs.classify_text if parent_rpcs.respond_to? :classify_text
                   @classify_text = ::Gapic::Config::Method.new classify_text_config
+                  moderate_text_config = parent_rpcs.moderate_text if parent_rpcs.respond_to? :moderate_text
+                  @moderate_text = ::Gapic::Config::Method.new moderate_text_config
                   annotate_text_config = parent_rpcs.annotate_text if parent_rpcs.respond_to? :annotate_text
                   @annotate_text = ::Gapic::Config::Method.new annotate_text_config