google-cloud-translate 3.7.3 → 3.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 23688139762ed002d6ea1689cfa724a963b0f98c8cad36fe721b40c4fff39e63
-  data.tar.gz: 599281e0a0f27d01dfcf9e46c21b52290572e0211ca268cbc18e87e5c29f10f8
+  metadata.gz: f8cf7a32f30be7ebe4466d97398218d0a0b5844af24f2b3dbc44bef1d5edd6f7
+  data.tar.gz: d9032461d1e52515cce444ca2e407721b53ffb02d4ad8349e82b0b0640214c7b
 SHA512:
-  metadata.gz: 54a8550e86f0263ef5e01194aea6247dc3fdc1c41d0c5532040ba4e266aaaa5f3117a92b15cdc1ab7e4f5f5195bad87adc687c0450c3b2d282341172ba48e231
-  data.tar.gz: c93e11a8fe4b0c497a97ab96494211b7cf2b85dea94a8508814fa1a1311eed78e039b652ef59a4c9c2f3db752c33fbdf993931ca563fb265637a4bea00a74d0c
+  metadata.gz: f835ce290535e817714c4b07a746f7e0bdb0bdef5bc379debac16062541cdc25f1100139952183ab36915f7bc9135f37037f638eec6895fed959d4ec0b9df342
+  data.tar.gz: 97ef3148b0fbe8a5a7172c7dfd8e3ad8394ac58be1f8cee02d234675827484ec8dab9b51e86307d33b048ea7144681718145b0e516f82988a5718f6b9c1e7e60

data/AUTHENTICATION.md

@@ -33,6 +33,12 @@ credentials, there are several methods available to you.
 
 Credentials are accepted in the following ways, in the following order or precedence:
 
+> [!WARNING]
+> If you accept a credential configuration (JSON file or Hash) from an
+> external source for authentication to Google Cloud, you must validate it before
+> providing it to a Google API client library. Providing an unvalidated credential
+> configuration to Google APIs can compromise the security of your systems and data.
+
 1. Credentials specified in method arguments
 2. Credentials specified in configuration
 3. Credentials pointed to or included in environment variables
@@ -54,20 +60,30 @@ whenever possible.
 To configure a credentials file for an individual client initialization:
 
 ```ruby
+require "googleauth"
 require "google/cloud/translate"
 
+credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
+  json_key_io: ::File.open("/path/to/keyfile.json")
+)
+
 client = Google::Cloud::Translate.translation_service do |config|
-  config.credentials = "path/to/credentialfile.json"
+  config.credentials = credentials
 end
 ```
 
 To configure a credentials file globally for all clients:
 
 ```ruby
+require "googleauth"
 require "google/cloud/translate"
 
+credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
+  json_key_io: ::File.open("/path/to/keyfile.json")
+)
+
 Google::Cloud::Translate.configure do |config|
-  config.credentials = "path/to/credentialfile.json"
+  config.credentials = credentials
 end
 
 client = Google::Cloud::Translate.translation_service

data/MIGRATING.md

@@ -88,11 +88,18 @@ client = Google::Cloud::Translate.new version: :v2,
 ```
 
 New (V3):
-```
+```ruby
+require "googleauth"
+require "google/cloud/translate"
+
+credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
+  json_key_io: ::File.open("/path/to/keyfile.json")
+)
+
 # Call the translation_service method to create a V3 client,
 # and pass a block to configure the client.
 client = Google::Cloud::Translate.translation_service do |config|
-  config.credentials = "/path/to/credentials.json"
+  config.credentials = credentials
 end
 
 # You can omit the block if you're keeping the default configuration

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

@@ -29,8 +29,11 @@ module Google
       #
       # @param [String] project_id Project identifier for the Cloud Translation service you are connecting to. If not
       #   present, the default project for the credentials is used.
-      # @param [String, Hash, Google::Auth::Credentials] credentials The path to the keyfile as a String, the contents
-      #   of the keyfile as a Hash, or a Google::Auth::Credentials object.
+      # @param [Google::Auth::Credentials] credentials A Google::Auth::Credentials
+      #   object.
+      #   @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
+      #     is deprecated. Providing an unvalidated credential configuration to
+      #     Google APIs can compromise the security of your systems and data.
       # @param [String] key a public API access key (not an OAuth 2.0 token)
       # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling the set of resources and operations that
       #   the connection can access. See [Using OAuth 2.0 to Access Google
@@ -48,12 +51,17 @@ module Google
       # @return [Google::Cloud::Translate::V2::Api]
       #
       # @example
+      #   require "googleauth"
       #   require "google/cloud/translate/v2"
       #
+      #   credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
+      #     json_key_io: ::File.open("/path/to/keyfile.json")
+      #   )
+      #
       #   translate = Google::Cloud::Translate::V2.new(
       #     version: :v2,
       #     project_id: "my-todo-project",
-      #     credentials: "/path/to/keyfile.json"
+      #     credentials: credentials
       #   )
       #
       #   translation = translate.translate "Hello world!", to: "la"

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

@@ -20,7 +20,7 @@
 module Google
   module Cloud
     module Translate
-      VERSION = "3.7.3"
+      VERSION = "3.7.4"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-translate
 version: !ruby/object:Gem::Version
-  version: 3.7.3
+  version: 3.7.4
 platform: ruby
 authors:
 - Google LLC