google-cloud-translate-v3 0.5.2 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8ef235e837f5215349b30969748a291103abc5ebb3155577daf2bc6e580464e
-  data.tar.gz: fef3eb56aee6d13fa6f670cf9b11a397ec40a726231e3cafe0ce1efba9eff5e2
+  metadata.gz: 18dc76bc75c474fe8cc70cc9dee0d3cf77addd41537cfe4077ca8425a44eb056
+  data.tar.gz: ee253237e5a14f65bc9de241685b096336477625bae6e90f7e1e82f9352f9e60
 SHA512:
-  metadata.gz: f0cc7816eb5bc6203f76ecac7f6e6046793349bf67a76442d61633865302dae8257497428cf9cf3f4d443b62a86e5a4b5de27d4ae954a11a07f22f52de0add2e
-  data.tar.gz: 93d6e02df36bab362b12df679718e27da50e3d35cfcf1846795b1e1cfbb9a647efb9ae486a3ebb44ce268a35882ded8b9238ec9cc3ac9962c30c5c9c9618ee20
+  metadata.gz: f8c95c169cbea4e67bfa27d8574e2d698adfbea3aaadcd4fd8ca6133272aa61daafa73c4bf5f1ab1d1b728fd359ac63b4a127e1fc19c3b37c5b4d4cdcfcf2706
+  data.tar.gz: 9c29ed87e3c76fcd61fa34ce40e83290686a0b19d78668a0e4c305ebf576edc6e75bebd0f6ac197a29529449734abcfed123e1ae7f1666496ba1abf8cda5d85a

data/README.md

@@ -1,6 +1,6 @@
 # Ruby Client for the Cloud Translation V3 API
 
-API Client library for the Cloud Translation V3 API
+Integrates text translation into your website or application.
 
 Cloud Translation can dynamically translate text between thousands of language pairs. Translation lets websites and programs programmatically integrate with the translation service.
 
@@ -47,7 +47,7 @@ for general usage information.
 
 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/current/stdlibs/logger/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+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/translate/v3/rest.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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!
+
+require "google/cloud/translate/v3/translation_service/rest"
+require "google/cloud/translate/v3/version"
+
+module Google
+  module Cloud
+    module Translate
+      ##
+      # To load just the REST part of this package, including all its services, and instantiate a REST client:
+      #
+      # @example
+      #
+      #     require "google/cloud/translate/v3/rest"
+      #     client = ::Google::Cloud::Translate::V3::TranslationService::Rest::Client.new
+      #
+      module V3
+      end
+    end
+  end
+end

data/lib/google/cloud/translate/v3/translation_service/client.rb

@@ -209,20 +209,19 @@ module Google
             #
             #   @param contents [::Array<::String>]
             #     Required. The content of the input in string format.
-            #     We recommend the total content be less than 30k codepoints. The max length
-            #     of this field is 1024.
-            #     Use BatchTranslateText for larger text.
+            #     We recommend the total content be less than 30,000 codepoints. The max
+            #     length of this field is 1024. Use BatchTranslateText for larger text.
             #   @param mime_type [::String]
             #     Optional. The format of the source text, for example, "text/html",
             #      "text/plain". If left blank, the MIME type defaults to "text/html".
             #   @param source_language_code [::String]
-            #     Optional. The BCP-47 language code of the input text if
+            #     Optional. The ISO-639 language code of the input text if
             #     known, for example, "en-US" or "sr-Latn". Supported language codes are
             #     listed in Language Support. If the source language isn't specified, the API
             #     attempts to identify the source language automatically and returns the
             #     source language within the response.
             #   @param target_language_code [::String]
-            #     Required. The BCP-47 language code to use for translation of the input
+            #     Required. The ISO-639 language code to use for translation of the input
             #     text, set to one of the language codes listed in Language Support.
             #   @param parent [::String]
             #     Required. Project or location to make a call. Must refer to a caller's
@@ -583,7 +582,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload translate_document(parent: nil, source_language_code: nil, target_language_code: nil, document_input_config: nil, document_output_config: nil, model: nil, glossary_config: nil, labels: nil)
+            # @overload translate_document(parent: nil, source_language_code: nil, target_language_code: nil, document_input_config: nil, document_output_config: nil, model: nil, glossary_config: nil, labels: nil, customized_attribution: nil, is_translate_native_pdf_only: nil, enable_shadow_removal_native_pdf: nil)
             #   Pass arguments to `translate_document` 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).
@@ -602,14 +601,14 @@ module Google
             #     Models and glossaries must be within the same region (have the same
             #     location-id), otherwise an INVALID_ARGUMENT (400) error is returned.
             #   @param source_language_code [::String]
-            #     Optional. The BCP-47 language code of the input document if known, for
+            #     Optional. The ISO-639 language code of the input document if known, for
             #     example, "en-US" or "sr-Latn". Supported language codes are listed in
             #     Language Support. If the source language isn't specified, the API attempts
             #     to identify the source language automatically and returns the source
             #     language within the response. Source language must be specified if the
             #     request contains a glossary or a custom model.
             #   @param target_language_code [::String]
-            #     Required. The BCP-47 language code to use for translation of the input
+            #     Required. The ISO-639 language code to use for translation of the input
             #     document, set to one of the language codes listed in Language Support.
             #   @param document_input_config [::Google::Cloud::Translate::V3::DocumentInputConfig, ::Hash]
             #     Required. Input configurations.
@@ -647,6 +646,19 @@ module Google
             #
             #     See https://cloud.google.com/translate/docs/advanced/labels for more
             #     information.
+            #   @param customized_attribution [::String]
+            #     Optional. This flag is to support user customized attribution.
+            #     If not provided, the default is `Machine Translated by Google`.
+            #     Customized attribution should follow rules in
+            #     https://cloud.google.com/translate/attribution#attribution_and_logos
+            #   @param is_translate_native_pdf_only [::Boolean]
+            #     Optional. If true, the page limit of online native pdf translation is 300
+            #     and only native pdf pages will be translated.
+            #   @param enable_shadow_removal_native_pdf [::Boolean]
+            #     Optional. If true, use the text removal to remove the shadow text on
+            #     background image for native pdf translation.
+            #     Shadow removal feature can only be enabled when
+            #     is_translate_native_pdf_only is false
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Translate::V3::TranslateDocumentResponse]
@@ -880,7 +892,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload batch_translate_document(parent: nil, source_language_code: nil, target_language_codes: nil, input_configs: nil, output_config: nil, models: nil, glossaries: nil, format_conversions: nil)
+            # @overload batch_translate_document(parent: nil, source_language_code: nil, target_language_codes: nil, input_configs: nil, output_config: nil, models: nil, glossaries: nil, format_conversions: nil, customized_attribution: nil)
             #   Pass arguments to `batch_translate_document` 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).
@@ -896,11 +908,11 @@ module Google
             #     the same location-id) can be used, otherwise an INVALID_ARGUMENT (400)
             #     error is returned.
             #   @param source_language_code [::String]
-            #     Required. The BCP-47 language code of the input document if known, for
+            #     Required. The ISO-639 language code of the input document if known, for
             #     example, "en-US" or "sr-Latn". Supported language codes are listed in
-            #     Language Support (https://cloud.google.com/translate/docs/languages).
+            #     [Language Support](https://cloud.google.com/translate/docs/languages).
             #   @param target_language_codes [::Array<::String>]
-            #     Required. The BCP-47 language code to use for translation of the input
+            #     Required. The ISO-639 language code to use for translation of the input
             #     document. Specify up to 10 language codes here.
             #   @param input_configs [::Array<::Google::Cloud::Translate::V3::BatchDocumentInputConfig, ::Hash>]
             #     Required. Input configurations.
@@ -940,6 +952,11 @@ module Google
             #
             #     If nothing specified, output files will be in the same format as the
             #     original file.
+            #   @param customized_attribution [::String]
+            #     Optional. This flag is to support user customized attribution.
+            #     If not provided, the default is `Machine Translated by Google`.
+            #     Customized attribution should follow rules in
+            #     https://cloud.google.com/translate/attribution#attribution_and_logos
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -1444,9 +1461,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

data/lib/google/cloud/translate/v3/translation_service/operations.rb

@@ -628,9 +628,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