google-cloud-translate-v3 0.10.0 → 0.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/AUTHENTICATION.md +72 -101
- data/lib/google/cloud/translate/v3/translation_service/client.rb +32 -8
- data/lib/google/cloud/translate/v3/translation_service/operations.rb +28 -6
- data/lib/google/cloud/translate/v3/translation_service/rest/client.rb +34 -7
- data/lib/google/cloud/translate/v3/translation_service/rest/operations.rb +33 -8
- data/lib/google/cloud/translate/v3/translation_service/rest/service_stub.rb +14 -2
- data/lib/google/cloud/translate/v3/version.rb +1 -1
- data/proto_docs/google/api/client.rb +1 -0
- metadata +4 -4
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: d2354d0df16e423e1cd61ca2c5502579cb602bd46a19d2609493afce6ceebfb4
|
|
4
|
+
data.tar.gz: 94e913a01f63f20c27a6347186a83e1558b13c2247cb41d18d467e7f01ee4367
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 19aef6caf3f96054055256e78b5ba40e9a66f58ed4a383198a701bfbc901ae205f2ef273fd863909b42e07c144d0b70c2b8d8d3679713308b95da31479297d2c
|
|
7
|
+
data.tar.gz: 935f99de9a403c0f384c3e8812eae103d77dd9e5194187fa5fcd247a3484d7729b229632dd77eea340c79570df096272200e6ae213a4d1479339d403fb88416b
|
data/AUTHENTICATION.md
CHANGED
|
@@ -1,151 +1,122 @@
|
|
|
1
1
|
# Authentication
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
[
|
|
5
|
-
|
|
6
|
-
[Google Cloud Platform environments](#google-cloud-platform-environments) the
|
|
7
|
-
credentials will be discovered automatically. When running on other
|
|
8
|
-
environments, the Service Account credentials can be specified by providing the
|
|
9
|
-
path to the
|
|
10
|
-
[JSON keyfile](https://cloud.google.com/iam/docs/managing-service-account-keys)
|
|
11
|
-
for the account (or the JSON itself) in
|
|
12
|
-
[environment variables](#environment-variables). Additionally, Cloud SDK
|
|
13
|
-
credentials can also be discovered automatically, but this is only recommended
|
|
14
|
-
during development.
|
|
3
|
+
The recommended way to authenticate to the google-cloud-translate-v3 library is to use
|
|
4
|
+
[Application Default Credentials (ADC)](https://cloud.google.com/docs/authentication/application-default-credentials).
|
|
5
|
+
To review all of your authentication options, see [Credentials lookup](#credential-lookup).
|
|
15
6
|
|
|
16
7
|
## Quickstart
|
|
17
8
|
|
|
18
|
-
|
|
19
|
-
|
|
9
|
+
The following example shows how to set up authentication for a local development
|
|
10
|
+
environment with your user credentials.
|
|
20
11
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
3. Initialize the client.
|
|
12
|
+
**NOTE:** This method is _not_ recommended for running in production. User credentials
|
|
13
|
+
should be used only during development.
|
|
26
14
|
|
|
27
|
-
|
|
28
|
-
|
|
15
|
+
1. [Download and install the Google Cloud CLI](https://cloud.google.com/sdk).
|
|
16
|
+
2. Set up a local ADC file with your user credentials:
|
|
29
17
|
|
|
30
|
-
|
|
18
|
+
```sh
|
|
19
|
+
gcloud auth application-default login
|
|
31
20
|
```
|
|
32
21
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
The google-cloud-translate-v3 library aims to make authentication
|
|
36
|
-
as simple as possible, and provides several mechanisms to configure your system
|
|
37
|
-
without requiring **Service Account Credentials** directly in code.
|
|
38
|
-
|
|
39
|
-
**Credentials** are discovered in the following order:
|
|
40
|
-
|
|
41
|
-
1. Specify credentials in method arguments
|
|
42
|
-
2. Specify credentials in configuration
|
|
43
|
-
3. Discover credentials path in environment variables
|
|
44
|
-
4. Discover credentials JSON in environment variables
|
|
45
|
-
5. Discover credentials file in the Cloud SDK's path
|
|
46
|
-
6. Discover GCP credentials
|
|
47
|
-
|
|
48
|
-
### Google Cloud Platform environments
|
|
22
|
+
3. Write code as if already authenticated.
|
|
49
23
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
Functions (GCF) and Cloud Run, **Credentials** are discovered automatically.
|
|
53
|
-
Code should be written as if already authenticated.
|
|
24
|
+
For more information about setting up authentication for a local development environment, see
|
|
25
|
+
[Set up Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-dev).
|
|
54
26
|
|
|
55
|
-
|
|
27
|
+
## Credential Lookup
|
|
56
28
|
|
|
57
|
-
The
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
**Credentials JSON** file can be stored in the environment variable, or the
|
|
62
|
-
**Credentials JSON** itself can be stored for environments such as Docker
|
|
63
|
-
containers where writing files is difficult or not encouraged.
|
|
29
|
+
The google-cloud-translate-v3 library provides several mechanisms to configure your system.
|
|
30
|
+
Generally, using Application Default Credentials to facilitate automatic
|
|
31
|
+
credentials discovery is the easist method. But if you need to explicitly specify
|
|
32
|
+
credentials, there are several methods available to you.
|
|
64
33
|
|
|
65
|
-
|
|
66
|
-
checks for credentials are configured on the service Credentials class (such as
|
|
67
|
-
{::Google::Cloud::Translate::V3::TranslationService::Credentials}):
|
|
34
|
+
Credentials are accepted in the following ways, in the following order or precedence:
|
|
68
35
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
36
|
+
1. Credentials specified in method arguments
|
|
37
|
+
2. Credentials specified in configuration
|
|
38
|
+
3. Credentials pointed to or included in environment variables
|
|
39
|
+
4. Credentials found in local ADC file
|
|
40
|
+
5. Credentials returned by the metadata server for the attached service account (GCP)
|
|
74
41
|
|
|
75
|
-
|
|
76
|
-
require "google/cloud/translate/v3"
|
|
77
|
-
|
|
78
|
-
ENV["TRANSLATE_CREDENTIALS"] = "path/to/keyfile.json"
|
|
42
|
+
### Configuration
|
|
79
43
|
|
|
80
|
-
client
|
|
81
|
-
|
|
44
|
+
You can configure a path to a JSON credentials file, either for an individual client object or
|
|
45
|
+
globally, for all client objects. The JSON file can contain credentials created for
|
|
46
|
+
[workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
|
|
47
|
+
[workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
|
|
48
|
+
[service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
|
|
82
49
|
|
|
83
|
-
|
|
50
|
+
Note: Service account keys are a security risk if not managed correctly. You should
|
|
51
|
+
[choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
|
|
52
|
+
whenever possible.
|
|
84
53
|
|
|
85
|
-
|
|
86
|
-
it in an environment variable. Either on an individual client initialization:
|
|
54
|
+
To configure a credentials file for an individual client initialization:
|
|
87
55
|
|
|
88
56
|
```ruby
|
|
89
57
|
require "google/cloud/translate/v3"
|
|
90
58
|
|
|
91
59
|
client = ::Google::Cloud::Translate::V3::TranslationService::Client.new do |config|
|
|
92
|
-
config.credentials = "path/to/
|
|
60
|
+
config.credentials = "path/to/credentialfile.json"
|
|
93
61
|
end
|
|
94
62
|
```
|
|
95
63
|
|
|
96
|
-
|
|
64
|
+
To configure a credentials file globally for all clients:
|
|
97
65
|
|
|
98
66
|
```ruby
|
|
99
67
|
require "google/cloud/translate/v3"
|
|
100
68
|
|
|
101
69
|
::Google::Cloud::Translate::V3::TranslationService::Client.configure do |config|
|
|
102
|
-
config.credentials = "path/to/
|
|
70
|
+
config.credentials = "path/to/credentialfile.json"
|
|
103
71
|
end
|
|
104
72
|
|
|
105
73
|
client = ::Google::Cloud::Translate::V3::TranslationService::Client.new
|
|
106
74
|
```
|
|
107
75
|
|
|
108
|
-
###
|
|
76
|
+
### Environment Variables
|
|
109
77
|
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
78
|
+
You can also use an environment variable to provide a JSON credentials file.
|
|
79
|
+
The environment variable can contain a path to the credentials file or, for
|
|
80
|
+
environments such as Docker containers where writing files is not encouraged,
|
|
81
|
+
you can include the credentials file itself.
|
|
113
82
|
|
|
114
|
-
|
|
83
|
+
The JSON file can contain credentials created for
|
|
84
|
+
[workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
|
|
85
|
+
[workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
|
|
86
|
+
[service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
|
|
115
87
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
88
|
+
Note: Service account keys are a security risk if not managed correctly. You should
|
|
89
|
+
[choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
|
|
90
|
+
whenever possible.
|
|
91
|
+
|
|
92
|
+
The environment variables that google-cloud-translate-v3
|
|
93
|
+
checks for credentials are:
|
|
119
94
|
|
|
120
|
-
|
|
121
|
-
*
|
|
95
|
+
* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
|
|
96
|
+
* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
|
|
122
97
|
|
|
123
|
-
|
|
98
|
+
```ruby
|
|
99
|
+
require "google/cloud/translate/v3"
|
|
124
100
|
|
|
125
|
-
|
|
126
|
-
connect to the APIs. You will use the **JSON key file** to
|
|
127
|
-
connect to most services with google-cloud-translate-v3.
|
|
101
|
+
ENV["GOOGLE_APPLICATION_CREDENTIALS"] = "path/to/credentialfile.json"
|
|
128
102
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
need a Google Developers service account.
|
|
103
|
+
client = ::Google::Cloud::Translate::V3::TranslationService::Client.new
|
|
104
|
+
```
|
|
132
105
|
|
|
133
|
-
|
|
134
|
-
2. Create a new project or click on an existing project.
|
|
135
|
-
3. Activate the menu in the upper left and select **APIs & Services**. From
|
|
136
|
-
here, you will enable the APIs that your application requires.
|
|
106
|
+
### Local ADC file
|
|
137
107
|
|
|
138
|
-
|
|
108
|
+
You can set up a local ADC file with your user credentials for authentication during
|
|
109
|
+
development. If credentials are not provided in code or in environment variables,
|
|
110
|
+
then the local ADC credentials are discovered.
|
|
139
111
|
|
|
140
|
-
|
|
112
|
+
Follow the steps in [Quickstart](#quickstart) to set up a local ADC file.
|
|
141
113
|
|
|
142
|
-
|
|
143
|
-
"Service account" to be guided through downloading a new JSON key file.
|
|
114
|
+
### Google Cloud Platform environments
|
|
144
115
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
116
|
+
When running on Google Cloud Platform (GCP), including Google Compute Engine
|
|
117
|
+
(GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud
|
|
118
|
+
Functions (GCF) and Cloud Run, credentials are retrieved from the attached
|
|
119
|
+
service account automatically. Code should be written as if already authenticated.
|
|
149
120
|
|
|
150
|
-
|
|
151
|
-
|
|
121
|
+
For more information, see
|
|
122
|
+
[Set up ADC for Google Cloud services](https://cloud.google.com/docs/authentication/provide-credentials-adc#attached-sa).
|
|
@@ -30,6 +30,9 @@ module Google
|
|
|
30
30
|
# Provides natural language translation operations.
|
|
31
31
|
#
|
|
32
32
|
class Client
|
|
33
|
+
# @private
|
|
34
|
+
DEFAULT_ENDPOINT_TEMPLATE = "translate.$UNIVERSE_DOMAIN$"
|
|
35
|
+
|
|
33
36
|
include Paths
|
|
34
37
|
|
|
35
38
|
# @private
|
|
@@ -122,6 +125,15 @@ module Google
|
|
|
122
125
|
@config
|
|
123
126
|
end
|
|
124
127
|
|
|
128
|
+
##
|
|
129
|
+
# The effective universe domain
|
|
130
|
+
#
|
|
131
|
+
# @return [String]
|
|
132
|
+
#
|
|
133
|
+
def universe_domain
|
|
134
|
+
@translation_service_stub.universe_domain
|
|
135
|
+
end
|
|
136
|
+
|
|
125
137
|
##
|
|
126
138
|
# Create a new TranslationService client object.
|
|
127
139
|
#
|
|
@@ -155,8 +167,9 @@ module Google
|
|
|
155
167
|
credentials = @config.credentials
|
|
156
168
|
# Use self-signed JWT if the endpoint is unchanged from default,
|
|
157
169
|
# but only if the default endpoint does not have a region prefix.
|
|
158
|
-
enable_self_signed_jwt = @config.endpoint
|
|
159
|
-
|
|
170
|
+
enable_self_signed_jwt = @config.endpoint.nil? ||
|
|
171
|
+
(@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
|
|
172
|
+
!@config.endpoint.split(".").first.include?("-"))
|
|
160
173
|
credentials ||= Credentials.default scope: @config.scope,
|
|
161
174
|
enable_self_signed_jwt: enable_self_signed_jwt
|
|
162
175
|
if credentials.is_a?(::String) || credentials.is_a?(::Hash)
|
|
@@ -169,12 +182,15 @@ module Google
|
|
|
169
182
|
config.credentials = credentials
|
|
170
183
|
config.quota_project = @quota_project_id
|
|
171
184
|
config.endpoint = @config.endpoint
|
|
185
|
+
config.universe_domain = @config.universe_domain
|
|
172
186
|
end
|
|
173
187
|
|
|
174
188
|
@translation_service_stub = ::Gapic::ServiceStub.new(
|
|
175
189
|
::Google::Cloud::Translate::V3::TranslationService::Stub,
|
|
176
|
-
credentials:
|
|
177
|
-
endpoint:
|
|
190
|
+
credentials: credentials,
|
|
191
|
+
endpoint: @config.endpoint,
|
|
192
|
+
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
|
193
|
+
universe_domain: @config.universe_domain,
|
|
178
194
|
channel_args: @config.channel_args,
|
|
179
195
|
interceptors: @config.interceptors,
|
|
180
196
|
channel_pool_config: @config.channel_pool
|
|
@@ -2385,9 +2401,9 @@ module Google
|
|
|
2385
2401
|
# end
|
|
2386
2402
|
#
|
|
2387
2403
|
# @!attribute [rw] endpoint
|
|
2388
|
-
#
|
|
2389
|
-
#
|
|
2390
|
-
# @return [::String]
|
|
2404
|
+
# A custom service endpoint, as a hostname or hostname:port. The default is
|
|
2405
|
+
# nil, indicating to use the default endpoint in the current universe domain.
|
|
2406
|
+
# @return [::String,nil]
|
|
2391
2407
|
# @!attribute [rw] credentials
|
|
2392
2408
|
# Credentials to send with calls. You may provide any of the following types:
|
|
2393
2409
|
# * (`String`) The path to a service account key file in JSON format
|
|
@@ -2433,13 +2449,20 @@ module Google
|
|
|
2433
2449
|
# @!attribute [rw] quota_project
|
|
2434
2450
|
# A separate project against which to charge quota.
|
|
2435
2451
|
# @return [::String]
|
|
2452
|
+
# @!attribute [rw] universe_domain
|
|
2453
|
+
# The universe domain within which to make requests. This determines the
|
|
2454
|
+
# default endpoint URL. The default value of nil uses the environment
|
|
2455
|
+
# universe (usually the default "googleapis.com" universe).
|
|
2456
|
+
# @return [::String,nil]
|
|
2436
2457
|
#
|
|
2437
2458
|
class Configuration
|
|
2438
2459
|
extend ::Gapic::Config
|
|
2439
2460
|
|
|
2461
|
+
# @private
|
|
2462
|
+
# The endpoint specific to the default "googleapis.com" universe. Deprecated.
|
|
2440
2463
|
DEFAULT_ENDPOINT = "translate.googleapis.com"
|
|
2441
2464
|
|
|
2442
|
-
config_attr :endpoint,
|
|
2465
|
+
config_attr :endpoint, nil, ::String, nil
|
|
2443
2466
|
config_attr :credentials, nil do |value|
|
|
2444
2467
|
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
|
2445
2468
|
allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
|
|
@@ -2454,6 +2477,7 @@ module Google
|
|
|
2454
2477
|
config_attr :metadata, nil, ::Hash, nil
|
|
2455
2478
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
|
2456
2479
|
config_attr :quota_project, nil, ::String, nil
|
|
2480
|
+
config_attr :universe_domain, nil, ::String, nil
|
|
2457
2481
|
|
|
2458
2482
|
# @private
|
|
2459
2483
|
def initialize parent_config = nil
|
|
@@ -26,6 +26,9 @@ module Google
|
|
|
26
26
|
module TranslationService
|
|
27
27
|
# Service that implements Longrunning Operations API.
|
|
28
28
|
class Operations
|
|
29
|
+
# @private
|
|
30
|
+
DEFAULT_ENDPOINT_TEMPLATE = "translate.$UNIVERSE_DOMAIN$"
|
|
31
|
+
|
|
29
32
|
# @private
|
|
30
33
|
attr_reader :operations_stub
|
|
31
34
|
|
|
@@ -60,6 +63,15 @@ module Google
|
|
|
60
63
|
@config
|
|
61
64
|
end
|
|
62
65
|
|
|
66
|
+
##
|
|
67
|
+
# The effective universe domain
|
|
68
|
+
#
|
|
69
|
+
# @return [String]
|
|
70
|
+
#
|
|
71
|
+
def universe_domain
|
|
72
|
+
@operations_stub.universe_domain
|
|
73
|
+
end
|
|
74
|
+
|
|
63
75
|
##
|
|
64
76
|
# Create a new Operations client object.
|
|
65
77
|
#
|
|
@@ -90,8 +102,10 @@ module Google
|
|
|
90
102
|
|
|
91
103
|
@operations_stub = ::Gapic::ServiceStub.new(
|
|
92
104
|
::Google::Longrunning::Operations::Stub,
|
|
93
|
-
credentials:
|
|
94
|
-
endpoint:
|
|
105
|
+
credentials: credentials,
|
|
106
|
+
endpoint: @config.endpoint,
|
|
107
|
+
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
|
108
|
+
universe_domain: @config.universe_domain,
|
|
95
109
|
channel_args: @config.channel_args,
|
|
96
110
|
interceptors: @config.interceptors,
|
|
97
111
|
channel_pool_config: @config.channel_pool
|
|
@@ -621,9 +635,9 @@ module Google
|
|
|
621
635
|
# end
|
|
622
636
|
#
|
|
623
637
|
# @!attribute [rw] endpoint
|
|
624
|
-
#
|
|
625
|
-
#
|
|
626
|
-
# @return [::String]
|
|
638
|
+
# A custom service endpoint, as a hostname or hostname:port. The default is
|
|
639
|
+
# nil, indicating to use the default endpoint in the current universe domain.
|
|
640
|
+
# @return [::String,nil]
|
|
627
641
|
# @!attribute [rw] credentials
|
|
628
642
|
# Credentials to send with calls. You may provide any of the following types:
|
|
629
643
|
# * (`String`) The path to a service account key file in JSON format
|
|
@@ -669,13 +683,20 @@ module Google
|
|
|
669
683
|
# @!attribute [rw] quota_project
|
|
670
684
|
# A separate project against which to charge quota.
|
|
671
685
|
# @return [::String]
|
|
686
|
+
# @!attribute [rw] universe_domain
|
|
687
|
+
# The universe domain within which to make requests. This determines the
|
|
688
|
+
# default endpoint URL. The default value of nil uses the environment
|
|
689
|
+
# universe (usually the default "googleapis.com" universe).
|
|
690
|
+
# @return [::String,nil]
|
|
672
691
|
#
|
|
673
692
|
class Configuration
|
|
674
693
|
extend ::Gapic::Config
|
|
675
694
|
|
|
695
|
+
# @private
|
|
696
|
+
# The endpoint specific to the default "googleapis.com" universe. Deprecated.
|
|
676
697
|
DEFAULT_ENDPOINT = "translate.googleapis.com"
|
|
677
698
|
|
|
678
|
-
config_attr :endpoint,
|
|
699
|
+
config_attr :endpoint, nil, ::String, nil
|
|
679
700
|
config_attr :credentials, nil do |value|
|
|
680
701
|
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
|
681
702
|
allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
|
|
@@ -690,6 +711,7 @@ module Google
|
|
|
690
711
|
config_attr :metadata, nil, ::Hash, nil
|
|
691
712
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
|
692
713
|
config_attr :quota_project, nil, ::String, nil
|
|
714
|
+
config_attr :universe_domain, nil, ::String, nil
|
|
693
715
|
|
|
694
716
|
# @private
|
|
695
717
|
def initialize parent_config = nil
|
|
@@ -32,6 +32,9 @@ module Google
|
|
|
32
32
|
# Provides natural language translation operations.
|
|
33
33
|
#
|
|
34
34
|
class Client
|
|
35
|
+
# @private
|
|
36
|
+
DEFAULT_ENDPOINT_TEMPLATE = "translate.$UNIVERSE_DOMAIN$"
|
|
37
|
+
|
|
35
38
|
include Paths
|
|
36
39
|
|
|
37
40
|
# @private
|
|
@@ -124,6 +127,15 @@ module Google
|
|
|
124
127
|
@config
|
|
125
128
|
end
|
|
126
129
|
|
|
130
|
+
##
|
|
131
|
+
# The effective universe domain
|
|
132
|
+
#
|
|
133
|
+
# @return [String]
|
|
134
|
+
#
|
|
135
|
+
def universe_domain
|
|
136
|
+
@translation_service_stub.universe_domain
|
|
137
|
+
end
|
|
138
|
+
|
|
127
139
|
##
|
|
128
140
|
# Create a new TranslationService REST client object.
|
|
129
141
|
#
|
|
@@ -151,8 +163,9 @@ module Google
|
|
|
151
163
|
credentials = @config.credentials
|
|
152
164
|
# Use self-signed JWT if the endpoint is unchanged from default,
|
|
153
165
|
# but only if the default endpoint does not have a region prefix.
|
|
154
|
-
enable_self_signed_jwt = @config.endpoint
|
|
155
|
-
|
|
166
|
+
enable_self_signed_jwt = @config.endpoint.nil? ||
|
|
167
|
+
(@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
|
|
168
|
+
!@config.endpoint.split(".").first.include?("-"))
|
|
156
169
|
credentials ||= Credentials.default scope: @config.scope,
|
|
157
170
|
enable_self_signed_jwt: enable_self_signed_jwt
|
|
158
171
|
if credentials.is_a?(::String) || credentials.is_a?(::Hash)
|
|
@@ -166,9 +179,15 @@ module Google
|
|
|
166
179
|
config.credentials = credentials
|
|
167
180
|
config.quota_project = @quota_project_id
|
|
168
181
|
config.endpoint = @config.endpoint
|
|
182
|
+
config.universe_domain = @config.universe_domain
|
|
169
183
|
end
|
|
170
184
|
|
|
171
|
-
@translation_service_stub = ::Google::Cloud::Translate::V3::TranslationService::Rest::ServiceStub.new
|
|
185
|
+
@translation_service_stub = ::Google::Cloud::Translate::V3::TranslationService::Rest::ServiceStub.new(
|
|
186
|
+
endpoint: @config.endpoint,
|
|
187
|
+
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
|
188
|
+
universe_domain: @config.universe_domain,
|
|
189
|
+
credentials: credentials
|
|
190
|
+
)
|
|
172
191
|
end
|
|
173
192
|
|
|
174
193
|
##
|
|
@@ -2235,9 +2254,9 @@ module Google
|
|
|
2235
2254
|
# end
|
|
2236
2255
|
#
|
|
2237
2256
|
# @!attribute [rw] endpoint
|
|
2238
|
-
#
|
|
2239
|
-
#
|
|
2240
|
-
# @return [::String]
|
|
2257
|
+
# A custom service endpoint, as a hostname or hostname:port. The default is
|
|
2258
|
+
# nil, indicating to use the default endpoint in the current universe domain.
|
|
2259
|
+
# @return [::String,nil]
|
|
2241
2260
|
# @!attribute [rw] credentials
|
|
2242
2261
|
# Credentials to send with calls. You may provide any of the following types:
|
|
2243
2262
|
# * (`String`) The path to a service account key file in JSON format
|
|
@@ -2274,13 +2293,20 @@ module Google
|
|
|
2274
2293
|
# @!attribute [rw] quota_project
|
|
2275
2294
|
# A separate project against which to charge quota.
|
|
2276
2295
|
# @return [::String]
|
|
2296
|
+
# @!attribute [rw] universe_domain
|
|
2297
|
+
# The universe domain within which to make requests. This determines the
|
|
2298
|
+
# default endpoint URL. The default value of nil uses the environment
|
|
2299
|
+
# universe (usually the default "googleapis.com" universe).
|
|
2300
|
+
# @return [::String,nil]
|
|
2277
2301
|
#
|
|
2278
2302
|
class Configuration
|
|
2279
2303
|
extend ::Gapic::Config
|
|
2280
2304
|
|
|
2305
|
+
# @private
|
|
2306
|
+
# The endpoint specific to the default "googleapis.com" universe. Deprecated.
|
|
2281
2307
|
DEFAULT_ENDPOINT = "translate.googleapis.com"
|
|
2282
2308
|
|
|
2283
|
-
config_attr :endpoint,
|
|
2309
|
+
config_attr :endpoint, nil, ::String, nil
|
|
2284
2310
|
config_attr :credentials, nil do |value|
|
|
2285
2311
|
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
|
2286
2312
|
allowed.any? { |klass| klass === value }
|
|
@@ -2292,6 +2318,7 @@ module Google
|
|
|
2292
2318
|
config_attr :metadata, nil, ::Hash, nil
|
|
2293
2319
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
|
2294
2320
|
config_attr :quota_project, nil, ::String, nil
|
|
2321
|
+
config_attr :universe_domain, nil, ::String, nil
|
|
2295
2322
|
|
|
2296
2323
|
# @private
|
|
2297
2324
|
def initialize parent_config = nil
|
|
@@ -26,6 +26,9 @@ module Google
|
|
|
26
26
|
module Rest
|
|
27
27
|
# Service that implements Longrunning Operations API.
|
|
28
28
|
class Operations
|
|
29
|
+
# @private
|
|
30
|
+
DEFAULT_ENDPOINT_TEMPLATE = "translate.$UNIVERSE_DOMAIN$"
|
|
31
|
+
|
|
29
32
|
# @private
|
|
30
33
|
attr_reader :operations_stub
|
|
31
34
|
|
|
@@ -60,6 +63,15 @@ module Google
|
|
|
60
63
|
@config
|
|
61
64
|
end
|
|
62
65
|
|
|
66
|
+
##
|
|
67
|
+
# The effective universe domain
|
|
68
|
+
#
|
|
69
|
+
# @return [String]
|
|
70
|
+
#
|
|
71
|
+
def universe_domain
|
|
72
|
+
@operations_stub.universe_domain
|
|
73
|
+
end
|
|
74
|
+
|
|
63
75
|
##
|
|
64
76
|
# Create a new Operations client object.
|
|
65
77
|
#
|
|
@@ -84,8 +96,10 @@ module Google
|
|
|
84
96
|
@quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
|
|
85
97
|
|
|
86
98
|
@operations_stub = OperationsServiceStub.new(
|
|
87
|
-
endpoint:
|
|
88
|
-
|
|
99
|
+
endpoint: @config.endpoint,
|
|
100
|
+
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
|
101
|
+
universe_domain: @config.universe_domain,
|
|
102
|
+
credentials: credentials
|
|
89
103
|
)
|
|
90
104
|
|
|
91
105
|
# Used by an LRO wrapper for some methods of this service
|
|
@@ -576,9 +590,9 @@ module Google
|
|
|
576
590
|
# end
|
|
577
591
|
#
|
|
578
592
|
# @!attribute [rw] endpoint
|
|
579
|
-
#
|
|
580
|
-
#
|
|
581
|
-
# @return [::String]
|
|
593
|
+
# A custom service endpoint, as a hostname or hostname:port. The default is
|
|
594
|
+
# nil, indicating to use the default endpoint in the current universe domain.
|
|
595
|
+
# @return [::String,nil]
|
|
582
596
|
# @!attribute [rw] credentials
|
|
583
597
|
# Credentials to send with calls. You may provide any of the following types:
|
|
584
598
|
# * (`String`) The path to a service account key file in JSON format
|
|
@@ -615,13 +629,20 @@ module Google
|
|
|
615
629
|
# @!attribute [rw] quota_project
|
|
616
630
|
# A separate project against which to charge quota.
|
|
617
631
|
# @return [::String]
|
|
632
|
+
# @!attribute [rw] universe_domain
|
|
633
|
+
# The universe domain within which to make requests. This determines the
|
|
634
|
+
# default endpoint URL. The default value of nil uses the environment
|
|
635
|
+
# universe (usually the default "googleapis.com" universe).
|
|
636
|
+
# @return [::String,nil]
|
|
618
637
|
#
|
|
619
638
|
class Configuration
|
|
620
639
|
extend ::Gapic::Config
|
|
621
640
|
|
|
641
|
+
# @private
|
|
642
|
+
# The endpoint specific to the default "googleapis.com" universe. Deprecated.
|
|
622
643
|
DEFAULT_ENDPOINT = "translate.googleapis.com"
|
|
623
644
|
|
|
624
|
-
config_attr :endpoint,
|
|
645
|
+
config_attr :endpoint, nil, ::String, nil
|
|
625
646
|
config_attr :credentials, nil do |value|
|
|
626
647
|
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
|
627
648
|
allowed.any? { |klass| klass === value }
|
|
@@ -633,6 +654,7 @@ module Google
|
|
|
633
654
|
config_attr :metadata, nil, ::Hash, nil
|
|
634
655
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
|
635
656
|
config_attr :quota_project, nil, ::String, nil
|
|
657
|
+
config_attr :universe_domain, nil, ::String, nil
|
|
636
658
|
|
|
637
659
|
# @private
|
|
638
660
|
def initialize parent_config = nil
|
|
@@ -722,12 +744,15 @@ module Google
|
|
|
722
744
|
# Service stub contains baseline method implementations
|
|
723
745
|
# including transcoding, making the REST call, and deserialing the response.
|
|
724
746
|
class OperationsServiceStub
|
|
725
|
-
def initialize endpoint:, credentials:
|
|
747
|
+
def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
|
|
726
748
|
# These require statements are intentionally placed here to initialize
|
|
727
749
|
# the REST modules only when it's required.
|
|
728
750
|
require "gapic/rest"
|
|
729
751
|
|
|
730
|
-
@client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
|
|
752
|
+
@client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
|
|
753
|
+
endpoint_template: endpoint_template,
|
|
754
|
+
universe_domain: universe_domain,
|
|
755
|
+
credentials: credentials
|
|
731
756
|
end
|
|
732
757
|
|
|
733
758
|
##
|
|
@@ -30,16 +30,28 @@ module Google
|
|
|
30
30
|
# including transcoding, making the REST call, and deserialing the response.
|
|
31
31
|
#
|
|
32
32
|
class ServiceStub
|
|
33
|
-
def initialize endpoint:, credentials:
|
|
33
|
+
def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
|
|
34
34
|
# These require statements are intentionally placed here to initialize
|
|
35
35
|
# the REST modules only when it's required.
|
|
36
36
|
require "gapic/rest"
|
|
37
37
|
|
|
38
|
-
@client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
|
|
38
|
+
@client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
|
|
39
|
+
endpoint_template: endpoint_template,
|
|
40
|
+
universe_domain: universe_domain,
|
|
41
|
+
credentials: credentials,
|
|
39
42
|
numeric_enums: true,
|
|
40
43
|
raise_faraday_errors: false
|
|
41
44
|
end
|
|
42
45
|
|
|
46
|
+
##
|
|
47
|
+
# The effective universe domain
|
|
48
|
+
#
|
|
49
|
+
# @return [String]
|
|
50
|
+
#
|
|
51
|
+
def universe_domain
|
|
52
|
+
@client_stub.universe_domain
|
|
53
|
+
end
|
|
54
|
+
|
|
43
55
|
##
|
|
44
56
|
# Baseline implementation for the translate_text REST call
|
|
45
57
|
#
|
|
@@ -21,6 +21,7 @@ module Google
|
|
|
21
21
|
module Api
|
|
22
22
|
# Required information for every language.
|
|
23
23
|
# @!attribute [rw] reference_docs_uri
|
|
24
|
+
# @deprecated This field is deprecated and may be removed in the next major version update.
|
|
24
25
|
# @return [::String]
|
|
25
26
|
# Link to automatically generated reference documentation. Example:
|
|
26
27
|
# https://cloud.google.com/nodejs/docs/reference/asset/latest
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: google-cloud-translate-v3
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.11.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Google LLC
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2024-01-
|
|
11
|
+
date: 2024-01-11 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: gapic-common
|
|
@@ -16,7 +16,7 @@ dependencies:
|
|
|
16
16
|
requirements:
|
|
17
17
|
- - ">="
|
|
18
18
|
- !ruby/object:Gem::Version
|
|
19
|
-
version: 0.
|
|
19
|
+
version: 0.21.1
|
|
20
20
|
- - "<"
|
|
21
21
|
- !ruby/object:Gem::Version
|
|
22
22
|
version: 2.a
|
|
@@ -26,7 +26,7 @@ dependencies:
|
|
|
26
26
|
requirements:
|
|
27
27
|
- - ">="
|
|
28
28
|
- !ruby/object:Gem::Version
|
|
29
|
-
version: 0.
|
|
29
|
+
version: 0.21.1
|
|
30
30
|
- - "<"
|
|
31
31
|
- !ruby/object:Gem::Version
|
|
32
32
|
version: 2.a
|