google-cloud-translate-v3 0.1.0

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

@@ -0,0 +1,69 @@
+# 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 Cloud
+    module Translate
+      module V3
+        module TranslationService
+          # Path helper methods for the TranslationService API.
+          module Paths
+            ##
+            # Create a fully-qualified Glossary resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/glossaries/{glossary}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param glossary [String]
+            #
+            # @return [::String]
+            def glossary_path project:, location:, glossary:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/glossaries/#{glossary}"
+            end
+
+            ##
+            # Create a fully-qualified Location resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}`
+            #
+            # @param project [String]
+            # @param location [String]
+            #
+            # @return [::String]
+            def location_path project:, location:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}"
+            end
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,233 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/translate/v3/translation_service.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/longrunning/operations_pb'
+require 'google/protobuf/timestamp_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/translate/v3/translation_service.proto", :syntax => :proto3) do
+    add_message "google.cloud.translation.v3.TranslateTextGlossaryConfig" do
+      optional :glossary, :string, 1
+      optional :ignore_case, :bool, 2
+    end
+    add_message "google.cloud.translation.v3.TranslateTextRequest" do
+      repeated :contents, :string, 1
+      optional :mime_type, :string, 3
+      optional :source_language_code, :string, 4
+      optional :target_language_code, :string, 5
+      optional :parent, :string, 8
+      optional :model, :string, 6
+      optional :glossary_config, :message, 7, "google.cloud.translation.v3.TranslateTextGlossaryConfig"
+      map :labels, :string, :string, 10
+    end
+    add_message "google.cloud.translation.v3.TranslateTextResponse" do
+      repeated :translations, :message, 1, "google.cloud.translation.v3.Translation"
+      repeated :glossary_translations, :message, 3, "google.cloud.translation.v3.Translation"
+    end
+    add_message "google.cloud.translation.v3.Translation" do
+      optional :translated_text, :string, 1
+      optional :model, :string, 2
+      optional :detected_language_code, :string, 4
+      optional :glossary_config, :message, 3, "google.cloud.translation.v3.TranslateTextGlossaryConfig"
+    end
+    add_message "google.cloud.translation.v3.DetectLanguageRequest" do
+      optional :parent, :string, 5
+      optional :model, :string, 4
+      optional :mime_type, :string, 3
+      map :labels, :string, :string, 6
+      oneof :source do
+        optional :content, :string, 1
+      end
+    end
+    add_message "google.cloud.translation.v3.DetectedLanguage" do
+      optional :language_code, :string, 1
+      optional :confidence, :float, 2
+    end
+    add_message "google.cloud.translation.v3.DetectLanguageResponse" do
+      repeated :languages, :message, 1, "google.cloud.translation.v3.DetectedLanguage"
+    end
+    add_message "google.cloud.translation.v3.GetSupportedLanguagesRequest" do
+      optional :parent, :string, 3
+      optional :display_language_code, :string, 1
+      optional :model, :string, 2
+    end
+    add_message "google.cloud.translation.v3.SupportedLanguages" do
+      repeated :languages, :message, 1, "google.cloud.translation.v3.SupportedLanguage"
+    end
+    add_message "google.cloud.translation.v3.SupportedLanguage" do
+      optional :language_code, :string, 1
+      optional :display_name, :string, 2
+      optional :support_source, :bool, 3
+      optional :support_target, :bool, 4
+    end
+    add_message "google.cloud.translation.v3.GcsSource" do
+      optional :input_uri, :string, 1
+    end
+    add_message "google.cloud.translation.v3.InputConfig" do
+      optional :mime_type, :string, 1
+      oneof :source do
+        optional :gcs_source, :message, 2, "google.cloud.translation.v3.GcsSource"
+      end
+    end
+    add_message "google.cloud.translation.v3.GcsDestination" do
+      optional :output_uri_prefix, :string, 1
+    end
+    add_message "google.cloud.translation.v3.OutputConfig" do
+      oneof :destination do
+        optional :gcs_destination, :message, 1, "google.cloud.translation.v3.GcsDestination"
+      end
+    end
+    add_message "google.cloud.translation.v3.BatchTranslateTextRequest" do
+      optional :parent, :string, 1
+      optional :source_language_code, :string, 2
+      repeated :target_language_codes, :string, 3
+      map :models, :string, :string, 4
+      repeated :input_configs, :message, 5, "google.cloud.translation.v3.InputConfig"
+      optional :output_config, :message, 6, "google.cloud.translation.v3.OutputConfig"
+      map :glossaries, :string, :message, 7, "google.cloud.translation.v3.TranslateTextGlossaryConfig"
+      map :labels, :string, :string, 9
+    end
+    add_message "google.cloud.translation.v3.BatchTranslateMetadata" do
+      optional :state, :enum, 1, "google.cloud.translation.v3.BatchTranslateMetadata.State"
+      optional :translated_characters, :int64, 2
+      optional :failed_characters, :int64, 3
+      optional :total_characters, :int64, 4
+      optional :submit_time, :message, 5, "google.protobuf.Timestamp"
+    end
+    add_enum "google.cloud.translation.v3.BatchTranslateMetadata.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :RUNNING, 1
+      value :SUCCEEDED, 2
+      value :FAILED, 3
+      value :CANCELLING, 4
+      value :CANCELLED, 5
+    end
+    add_message "google.cloud.translation.v3.BatchTranslateResponse" do
+      optional :total_characters, :int64, 1
+      optional :translated_characters, :int64, 2
+      optional :failed_characters, :int64, 3
+      optional :submit_time, :message, 4, "google.protobuf.Timestamp"
+      optional :end_time, :message, 5, "google.protobuf.Timestamp"
+    end
+    add_message "google.cloud.translation.v3.GlossaryInputConfig" do
+      oneof :source do
+        optional :gcs_source, :message, 1, "google.cloud.translation.v3.GcsSource"
+      end
+    end
+    add_message "google.cloud.translation.v3.Glossary" do
+      optional :name, :string, 1
+      optional :input_config, :message, 5, "google.cloud.translation.v3.GlossaryInputConfig"
+      optional :entry_count, :int32, 6
+      optional :submit_time, :message, 7, "google.protobuf.Timestamp"
+      optional :end_time, :message, 8, "google.protobuf.Timestamp"
+      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"
+      end
+    end
+    add_message "google.cloud.translation.v3.Glossary.LanguageCodePair" do
+      optional :source_language_code, :string, 1
+      optional :target_language_code, :string, 2
+    end
+    add_message "google.cloud.translation.v3.Glossary.LanguageCodesSet" do
+      repeated :language_codes, :string, 1
+    end
+    add_message "google.cloud.translation.v3.CreateGlossaryRequest" do
+      optional :parent, :string, 1
+      optional :glossary, :message, 2, "google.cloud.translation.v3.Glossary"
+    end
+    add_message "google.cloud.translation.v3.GetGlossaryRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.translation.v3.DeleteGlossaryRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.translation.v3.ListGlossariesRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+      optional :filter, :string, 4
+    end
+    add_message "google.cloud.translation.v3.ListGlossariesResponse" do
+      repeated :glossaries, :message, 1, "google.cloud.translation.v3.Glossary"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.cloud.translation.v3.CreateGlossaryMetadata" do
+      optional :name, :string, 1
+      optional :state, :enum, 2, "google.cloud.translation.v3.CreateGlossaryMetadata.State"
+      optional :submit_time, :message, 3, "google.protobuf.Timestamp"
+    end
+    add_enum "google.cloud.translation.v3.CreateGlossaryMetadata.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :RUNNING, 1
+      value :SUCCEEDED, 2
+      value :FAILED, 3
+      value :CANCELLING, 4
+      value :CANCELLED, 5
+    end
+    add_message "google.cloud.translation.v3.DeleteGlossaryMetadata" do
+      optional :name, :string, 1
+      optional :state, :enum, 2, "google.cloud.translation.v3.DeleteGlossaryMetadata.State"
+      optional :submit_time, :message, 3, "google.protobuf.Timestamp"
+    end
+    add_enum "google.cloud.translation.v3.DeleteGlossaryMetadata.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :RUNNING, 1
+      value :SUCCEEDED, 2
+      value :FAILED, 3
+      value :CANCELLING, 4
+      value :CANCELLED, 5
+    end
+    add_message "google.cloud.translation.v3.DeleteGlossaryResponse" do
+      optional :name, :string, 1
+      optional :submit_time, :message, 2, "google.protobuf.Timestamp"
+      optional :end_time, :message, 3, "google.protobuf.Timestamp"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Translate
+      module V3
+        TranslateTextGlossaryConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.TranslateTextGlossaryConfig").msgclass
+        TranslateTextRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.TranslateTextRequest").msgclass
+        TranslateTextResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.TranslateTextResponse").msgclass
+        Translation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.Translation").msgclass
+        DetectLanguageRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.DetectLanguageRequest").msgclass
+        DetectedLanguage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.DetectedLanguage").msgclass
+        DetectLanguageResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.DetectLanguageResponse").msgclass
+        GetSupportedLanguagesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.GetSupportedLanguagesRequest").msgclass
+        SupportedLanguages = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.SupportedLanguages").msgclass
+        SupportedLanguage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.SupportedLanguage").msgclass
+        GcsSource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.GcsSource").msgclass
+        InputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.InputConfig").msgclass
+        GcsDestination = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.GcsDestination").msgclass
+        OutputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.OutputConfig").msgclass
+        BatchTranslateTextRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.BatchTranslateTextRequest").msgclass
+        BatchTranslateMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.BatchTranslateMetadata").msgclass
+        BatchTranslateMetadata::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.BatchTranslateMetadata.State").enummodule
+        BatchTranslateResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.BatchTranslateResponse").msgclass
+        GlossaryInputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.GlossaryInputConfig").msgclass
+        Glossary = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.Glossary").msgclass
+        Glossary::LanguageCodePair = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.Glossary.LanguageCodePair").msgclass
+        Glossary::LanguageCodesSet = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.Glossary.LanguageCodesSet").msgclass
+        CreateGlossaryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.CreateGlossaryRequest").msgclass
+        GetGlossaryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.GetGlossaryRequest").msgclass
+        DeleteGlossaryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.DeleteGlossaryRequest").msgclass
+        ListGlossariesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.ListGlossariesRequest").msgclass
+        ListGlossariesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.ListGlossariesResponse").msgclass
+        CreateGlossaryMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.CreateGlossaryMetadata").msgclass
+        CreateGlossaryMetadata::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.CreateGlossaryMetadata.State").enummodule
+        DeleteGlossaryMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.DeleteGlossaryMetadata").msgclass
+        DeleteGlossaryMetadata::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.DeleteGlossaryMetadata.State").enummodule
+        DeleteGlossaryResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.translation.v3.DeleteGlossaryResponse").msgclass
+      end
+    end
+  end
+end

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

@@ -0,0 +1,73 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/translate/v3/translation_service.proto for package 'Google.Cloud.Translate.V3'
+# Original file comments:
+# Copyright 2019 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
+#
+#     http://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.
+#
+#
+
+require 'grpc'
+require 'google/cloud/translate/v3/translation_service_pb'
+
+module Google
+  module Cloud
+    module Translate
+      module V3
+        module TranslationService
+          # Proto file for the Cloud Translation API (v3 GA).
+          #
+          # Provides natural language translation operations.
+          class Service
+
+            include GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.cloud.translation.v3.TranslationService'
+
+            # Translates input text and returns translated text.
+            rpc :TranslateText, Google::Cloud::Translate::V3::TranslateTextRequest, Google::Cloud::Translate::V3::TranslateTextResponse
+            # Detects the language of text within a request.
+            rpc :DetectLanguage, Google::Cloud::Translate::V3::DetectLanguageRequest, Google::Cloud::Translate::V3::DetectLanguageResponse
+            # Returns a list of supported languages for translation.
+            rpc :GetSupportedLanguages, Google::Cloud::Translate::V3::GetSupportedLanguagesRequest, Google::Cloud::Translate::V3::SupportedLanguages
+            # Translates a large volume of text in asynchronous batch mode.
+            # This function provides real-time output as the inputs are being processed.
+            # If caller cancels a request, the partial results (for an input file, it's
+            # all or nothing) may still be available on the specified output location.
+            #
+            # This call returns immediately and you can
+            # use google.longrunning.Operation.name to poll the status of the call.
+            rpc :BatchTranslateText, Google::Cloud::Translate::V3::BatchTranslateTextRequest, Google::Longrunning::Operation
+            # Creates a glossary and returns the long-running operation. Returns
+            # NOT_FOUND, if the project doesn't exist.
+            rpc :CreateGlossary, Google::Cloud::Translate::V3::CreateGlossaryRequest, Google::Longrunning::Operation
+            # Lists glossaries in a project. Returns NOT_FOUND, if the project doesn't
+            # exist.
+            rpc :ListGlossaries, Google::Cloud::Translate::V3::ListGlossariesRequest, Google::Cloud::Translate::V3::ListGlossariesResponse
+            # Gets a glossary. Returns NOT_FOUND, if the glossary doesn't
+            # exist.
+            rpc :GetGlossary, Google::Cloud::Translate::V3::GetGlossaryRequest, Google::Cloud::Translate::V3::Glossary
+            # Deletes a glossary, or cancels glossary construction
+            # if the glossary isn't created yet.
+            # Returns NOT_FOUND, if the glossary doesn't exist.
+            rpc :DeleteGlossary, Google::Cloud::Translate::V3::DeleteGlossaryRequest, Google::Longrunning::Operation
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# 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 Cloud
+    module Translate
+      module V3
+        VERSION = "0.1.0"
+      end
+    end
+  end
+end

data/proto_docs/README.md

@@ -0,0 +1,4 @@
+# Cloud Translation V3 Protocol Buffer Documentation
+
+These files are for the YARD documentation of the generated protobuf files.
+They are not intended to be required or loaded at runtime.

data/proto_docs/google/api/field_behavior.rb

@@ -0,0 +1,59 @@
+# 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 Api
+    # An indicator of the behavior of a given field (for example, that a field
+    # is required in requests, or given as output but ignored as input).
+    # This **does not** change the behavior in protocol buffers itself; it only
+    # denotes the behavior and may affect how API tooling handles the field.
+    #
+    # Note: This enum **may** receive new values in the future.
+    module FieldBehavior
+      # Conventional default for enums. Do not use this.
+      FIELD_BEHAVIOR_UNSPECIFIED = 0
+
+      # Specifically denotes a field as optional.
+      # While all fields in protocol buffers are optional, this may be specified
+      # for emphasis if appropriate.
+      OPTIONAL = 1
+
+      # Denotes a field as required.
+      # This indicates that the field **must** be provided as part of the request,
+      # and failure to do so will cause an error (usually `INVALID_ARGUMENT`).
+      REQUIRED = 2
+
+      # Denotes a field as output only.
+      # This indicates that the field is provided in responses, but including the
+      # field in a request does nothing (the server *must* ignore it and
+      # *must not* throw an error as a result of the field's presence).
+      OUTPUT_ONLY = 3
+
+      # Denotes a field as input only.
+      # This indicates that the field is provided in requests, and the
+      # corresponding field is not included in output.
+      INPUT_ONLY = 4
+
+      # Denotes a field as immutable.
+      # This indicates that the field may be set once in a request to create a
+      # resource, but may not be changed thereafter.
+      IMMUTABLE = 5
+    end
+  end
+end