google-cloud-translate-v3 0.5.2 → 0.6.0

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

@@ -0,0 +1,53 @@
+# 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 "gapic/rest"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/translate/v3/version"
+
+require "google/cloud/translate/v3/translation_service/credentials"
+require "google/cloud/translate/v3/translation_service/paths"
+require "google/cloud/translate/v3/translation_service/rest/operations"
+require "google/cloud/translate/v3/translation_service/rest/client"
+
+module Google
+  module Cloud
+    module Translate
+      module V3
+        ##
+        # Provides natural language translation operations.
+        #
+        # To load this service and instantiate a REST client:
+        #
+        #     require "google/cloud/translate/v3/translation_service/rest"
+        #     client = ::Google::Cloud::Translate::V3::TranslationService::Rest::Client.new
+        #
+        module TranslationService
+          # Client for the REST transport
+          module Rest
+          end
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "rest", "helpers.rb"
+require "google/cloud/translate/v3/translation_service/rest/helpers" if ::File.file? helper_path

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

@@ -26,6 +26,7 @@ require "google/cloud/translate/v3/translation_service/credentials"
 require "google/cloud/translate/v3/translation_service/paths"
 require "google/cloud/translate/v3/translation_service/operations"
 require "google/cloud/translate/v3/translation_service/client"
+require "google/cloud/translate/v3/translation_service/rest"
 
 module Google
   module Cloud
@@ -39,6 +40,11 @@ module Google
         #     require "google/cloud/translate/v3/translation_service"
         #     client = ::Google::Cloud::Translate::V3::TranslationService::Client.new
         #
+        # @example Load this service and instantiate a REST client
+        #
+        #     require "google/cloud/translate/v3/translation_service/rest"
+        #     client = ::Google::Cloud::Translate::V3::TranslationService::Rest::Client.new
+        #
         module TranslationService
         end
       end

data/lib/google/cloud/translate/v3/translation_service_pb.rb

@@ -105,6 +105,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :model, :string, 6
       optional :glossary_config, :message, 7, "google.cloud.translation.v3.TranslateTextGlossaryConfig"
       map :labels, :string, :string, 8
+      optional :customized_attribution, :string, 10
+      optional :is_translate_native_pdf_only, :bool, 11
+      optional :enable_shadow_removal_native_pdf, :bool, 12
     end
     add_message "google.cloud.translation.v3.DocumentTranslation" do
       repeated :byte_stream_outputs, :bytes, 1
@@ -160,6 +163,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :entry_count, :int32, 6
       optional :submit_time, :message, 7, "google.protobuf.Timestamp"
       optional :end_time, :message, 8, "google.protobuf.Timestamp"
+      optional :display_name, :string, 9
       oneof :languages do
         optional :language_pair, :message, 3, "google.cloud.translation.v3.Glossary.LanguageCodePair"
         optional :language_codes_set, :message, 4, "google.cloud.translation.v3.Glossary.LanguageCodesSet"
@@ -232,6 +236,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       map :models, :string, :string, 6
       map :glossaries, :string, :message, 7, "google.cloud.translation.v3.TranslateTextGlossaryConfig"
       map :format_conversions, :string, :string, 8
+      optional :customized_attribution, :string, 10
     end
     add_message "google.cloud.translation.v3.BatchDocumentInputConfig" do
       oneof :source do

data/lib/google/cloud/translate/v3/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Translate
       module V3
-        VERSION = "0.5.2"
+        VERSION = "0.6.0"
       end
     end
   end

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

@@ -30,6 +30,11 @@ module Google
       #     require "google/cloud/translate/v3"
       #     client = ::Google::Cloud::Translate::V3::TranslationService::Client.new
       #
+      # @example Load this package, including all its services, and instantiate a REST client
+      #
+      #     require "google/cloud/translate/v3"
+      #     client = ::Google::Cloud::Translate::V3::TranslationService::Rest::Client.new
+      #
       module V3
       end
     end

data/proto_docs/google/cloud/translate/v3/translation_service.rb

@@ -27,14 +27,14 @@ module Google
         #   @return [::String]
         #     Required. The `glossary` to be applied for this translation.
         #
-        #     The format depends on glossary:
+        #     The format depends on the glossary:
         #
-        #     - User provided custom glossary:
+        #     - User-provided custom glossary:
         #       `projects/{project-number-or-id}/locations/{location-id}/glossaries/{glossary-id}`
         # @!attribute [rw] ignore_case
         #   @return [::Boolean]
-        #     Optional. Indicates match is case-insensitive.
-        #     Default value is false if missing.
+        #     Optional. Indicates match is case insensitive. The default value is `false`
+        #     if missing.
         class TranslateTextGlossaryConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -44,23 +44,22 @@ module Google
         # @!attribute [rw] contents
         #   @return [::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.
         # @!attribute [rw] mime_type
         #   @return [::String]
         #     Optional. The format of the source text, for example, "text/html",
         #      "text/plain". If left blank, the MIME type defaults to "text/html".
         # @!attribute [rw] source_language_code
         #   @return [::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.
         # @!attribute [rw] target_language_code
         #   @return [::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.
         # @!attribute [rw] parent
         #   @return [::String]
@@ -161,7 +160,7 @@ module Google
         #     `projects/{project-number}/locations/{location-id}/models/general/nmt`.
         # @!attribute [rw] detected_language_code
         #   @return [::String]
-        #     The BCP-47 language code of source text in the initial request, detected
+        #     The ISO-639 language code of source text in the initial request, detected
         #     automatically, if no source language was passed within the initial
         #     request. If the source language was passed, auto-detection of the language
         #     does not occur and this field is empty.
@@ -233,7 +232,7 @@ module Google
         # The response message for language detection.
         # @!attribute [rw] language_code
         #   @return [::String]
-        #     The BCP-47 language code of source content in the request, detected
+        #     The ISO-639 language code of the source content in the request, detected
         #     automatically.
         # @!attribute [rw] confidence
         #   @return [::Float]
@@ -309,19 +308,19 @@ module Google
         # @!attribute [rw] language_code
         #   @return [::String]
         #     Supported language code, generally consisting of its ISO 639-1
-        #     identifier, for example, 'en', 'ja'. In certain cases, BCP-47 codes
+        #     identifier, for example, 'en', 'ja'. In certain cases, ISO-639 codes
         #     including language and region identifiers are returned (for example,
-        #     'zh-TW' and 'zh-CN')
+        #     'zh-TW' and 'zh-CN').
         # @!attribute [rw] display_name
         #   @return [::String]
-        #     Human readable name of the language localized in the display language
+        #     Human-readable name of the language localized in the display language
         #     specified in the request.
         # @!attribute [rw] support_source
         #   @return [::Boolean]
-        #     Can be used as source language.
+        #     Can be used as a source language.
         # @!attribute [rw] support_target
         #   @return [::Boolean]
-        #     Can be used as target language.
+        #     Can be used as a target language.
         class SupportedLanguage
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -419,7 +418,7 @@ module Google
         #     Since index.csv will be keeping updated during the process, please make
         #     sure there is no custom retention policy applied on the output bucket
         #     that may avoid file updating.
-        #     (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy)
+        #     (https://cloud.google.com/storage/docs/bucket-lock#retention-policy)
         #
         #     The format of translations_file (for target language code 'trg') is:
         #     `gs://translation_test/a_b_c_'trg'_translations.[extension]`
@@ -564,7 +563,7 @@ module Google
         #     location-id), otherwise an INVALID_ARGUMENT (400) error is returned.
         # @!attribute [rw] source_language_code
         #   @return [::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
@@ -572,7 +571,7 @@ module Google
         #     request contains a glossary or a custom model.
         # @!attribute [rw] target_language_code
         #   @return [::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.
         # @!attribute [rw] document_input_config
         #   @return [::Google::Cloud::Translate::V3::DocumentInputConfig]
@@ -615,6 +614,22 @@ module Google
         #
         #     See https://cloud.google.com/translate/docs/advanced/labels for more
         #     information.
+        # @!attribute [rw] customized_attribution
+        #   @return [::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
+        # @!attribute [rw] is_translate_native_pdf_only
+        #   @return [::Boolean]
+        #     Optional. If true, the page limit of online native pdf translation is 300
+        #     and only native pdf pages will be translated.
+        # @!attribute [rw] enable_shadow_removal_native_pdf
+        #   @return [::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
         class TranslateDocumentRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -856,10 +871,10 @@ module Google
         #
         #     For unidirectional glossaries:
         #
-        #     - TSV/CSV (`.tsv`/`.csv`): 2 column file, tab- or comma-separated.
+        #     - TSV/CSV (`.tsv`/`.csv`): Two column file, tab- or comma-separated.
         #       The first column is source text. The second column is target text.
-        #       The file must not contain headers. That is, the first row is data, not
-        #       column names.
+        #       No headers in this file. The first row contains data and not column
+        #       names.
         #
         #     - TMX (`.tmx`): TMX file with parallel data defining source/target term
         #     pairs.
@@ -874,7 +889,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Represents a glossary built from user provided data.
+        # Represents a glossary built from user-provided data.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the glossary. Glossary names have the form
@@ -898,6 +913,9 @@ module Google
         # @!attribute [r] end_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. When the glossary creation was finished.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Optional. The display name of the glossary.
         class Glossary
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -905,11 +923,11 @@ module Google
           # Used with unidirectional glossaries.
           # @!attribute [rw] source_language_code
           #   @return [::String]
-          #     Required. The BCP-47 language code of the input text, for example,
+          #     Required. The ISO-639 language code of the input text, for example,
           #     "en-US". Expected to be an exact match for GlossaryTerm.language_code.
           # @!attribute [rw] target_language_code
           #   @return [::String]
-          #     Required. The BCP-47 language code for translation output, for example,
+          #     Required. The ISO-639 language code for translation output, for example,
           #     "zh-CN". Expected to be an exact match for GlossaryTerm.language_code.
           class LanguageCodePair
             include ::Google::Protobuf::MessageExts
@@ -919,7 +937,7 @@ module Google
           # Used with equivalent term set glossaries.
           # @!attribute [rw] language_codes
           #   @return [::Array<::String>]
-          #     The BCP-47 language code(s) for terms defined in the glossary.
+          #     The ISO-639 language code(s) for terms defined in the glossary.
           #     All entries are unique. The list contains at least two entries.
           #     Expected to be an exact match for GlossaryTerm.language_code.
           class LanguageCodesSet
@@ -1120,12 +1138,12 @@ module Google
         #     error is returned.
         # @!attribute [rw] source_language_code
         #   @return [::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).
         # @!attribute [rw] target_language_codes
         #   @return [::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.
         # @!attribute [rw] input_configs
         #   @return [::Array<::Google::Cloud::Translate::V3::BatchDocumentInputConfig>]
@@ -1170,6 +1188,12 @@ module Google
         #
         #     If nothing specified, output files will be in the same format as the
         #     original file.
+        # @!attribute [rw] customized_attribution
+        #   @return [::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
         class BatchTranslateDocumentRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1263,7 +1287,7 @@ module Google
         #     Since index.csv will be keeping updated during the process, please make
         #     sure there is no custom retention policy applied on the output bucket
         #     that may avoid file updating.
-        #     (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy)
+        #     (https://cloud.google.com/storage/docs/bucket-lock#retention-policy)
         #
         #     The naming format of translation output files follows (for target
         #     language code [trg]): `translation_output`:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-translate-v3
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-17 00:00:00.000000000 Z
+date: 2023-02-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -172,11 +172,16 @@ files:
 - README.md
 - lib/google-cloud-translate-v3.rb
 - lib/google/cloud/translate/v3.rb
+- lib/google/cloud/translate/v3/rest.rb
 - lib/google/cloud/translate/v3/translation_service.rb
 - lib/google/cloud/translate/v3/translation_service/client.rb
 - lib/google/cloud/translate/v3/translation_service/credentials.rb
 - lib/google/cloud/translate/v3/translation_service/operations.rb
 - lib/google/cloud/translate/v3/translation_service/paths.rb
+- lib/google/cloud/translate/v3/translation_service/rest.rb
+- lib/google/cloud/translate/v3/translation_service/rest/client.rb
+- lib/google/cloud/translate/v3/translation_service/rest/operations.rb
+- lib/google/cloud/translate/v3/translation_service/rest/service_stub.rb
 - lib/google/cloud/translate/v3/translation_service_pb.rb
 - lib/google/cloud/translate/v3/translation_service_services_pb.rb
 - lib/google/cloud/translate/v3/version.rb