google-cloud-media_translation-v1beta1 0.4.1 → 0.4.5

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 108ddc7de03b0dc5d22a2ec513cca5771fbe9a8946d6f17a8e8788051e3a4429
4
- data.tar.gz: fd6d9f1b4a0615490317fa7939f0d95ce8689eb7bd2b5891c4b71b83852f1745
3
+ metadata.gz: 8721b0131b2e335cdb6a0bd9679bb4874c1b271502cd927080d97d53d79a89de
4
+ data.tar.gz: f9a2d6a6643d27c1241b5fff38b3bfca1eb24b7507fa70622b1a737902fb3b5e
5
5
  SHA512:
6
- metadata.gz: 070ec3df2cc30ae52da15b21eb3fb1eaff3ea693ba9353b624fd705ef51119145ae7e942fb9fb28d87214becf02ba6c3b133c7c95be371e466d297d75517104e
7
- data.tar.gz: d3e7a37d6350ef68c8920c2d4ca87b511960df86bfe64600f0b522b52368a28bc8b8076226e2585f28747b9660575432a3a2b542b4b20ea3702af00a45a14da5
6
+ metadata.gz: f78de1aaa1454096d23f9b615ae3171419742574e90a208282159c292421f224b562ec174f69e470dc002d04f83bc05f65ca094c6500df6e0c1c49f54d5e51b6
7
+ data.tar.gz: d6cec4b987490feb685f63f59d1a45fa4bf419a7a51bab08c6add5a5b3aa455de59f7cebf7a790a4d89000c92933e17c1555c38ea7fc7dbde74192fdc909bc34
data/.yardopts CHANGED
@@ -1,5 +1,5 @@
1
1
  --no-private
2
- --title=Media Translation V1beta1 API
2
+ --title="Media Translation V1beta1 API"
3
3
  --exclude _pb\.rb$
4
4
  --markup markdown
5
5
  --markup-provider redcarpet
data/AUTHENTICATION.md CHANGED
@@ -66,11 +66,11 @@ The environment variables that google-cloud-media_translation-v1beta1
66
66
  checks for credentials are configured on the service Credentials class (such as
67
67
  {::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Credentials}):
68
68
 
69
- 1. `MEDIA_TRANSLATION_CREDENTIALS` - Path to JSON file, or JSON contents
70
- 2. `MEDIA_TRANSLATION_KEYFILE` - Path to JSON file, or JSON contents
71
- 3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
- 4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
- 5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
69
+ * `MEDIA_TRANSLATION_CREDENTIALS` - Path to JSON file, or JSON contents
70
+ * `MEDIA_TRANSLATION_KEYFILE` - Path to JSON file, or JSON contents
71
+ * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
+ * `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
+ * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
74
74
 
75
75
  ```ruby
76
76
  require "google/cloud/media_translation/v1beta1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::C
82
82
 
83
83
  ### Configuration
84
84
 
85
- The **Credentials JSON** can be configured instead of placing them in
86
- environment variables. Either on an individual client initialization:
85
+ The path to the **Credentials JSON** file can be configured instead of storing
86
+ it in an environment variable. Either on an individual client initialization:
87
87
 
88
88
  ```ruby
89
89
  require "google/cloud/media_translation/v1beta1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::C
93
93
  end
94
94
  ```
95
95
 
96
- Or configured globally for all clients:
96
+ Or globally for all clients:
97
97
 
98
98
  ```ruby
99
99
  require "google/cloud/media_translation/v1beta1"
@@ -120,15 +120,6 @@ To configure your system for this, simply:
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
121
  *should* only be used during development.
122
122
 
123
- [gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
124
- [dev-console]: https://console.cloud.google.com/project
125
-
126
- [enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
127
-
128
- [create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
129
- [create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
130
- [reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
131
-
132
123
  ## Creating a Service Account
133
124
 
134
125
  Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
139
130
  [Google Cloud Platform environments](#google-cloud-platform-environments), you
140
131
  need a Google Developers service account.
141
132
 
142
- 1. Visit the [Google Developers Console][dev-console].
133
+ 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
143
134
  2. Create a new project or click on an existing project.
144
- 3. Activate the slide-out navigation tray and select **API Manager**. From
135
+ 3. Activate the menu in the upper left and select **APIs & Services**. From
145
136
  here, you will enable the APIs that your application requires.
146
137
 
147
- ![Enable the APIs that your application requires][enable-apis]
148
-
149
138
  *Note: You may need to enable billing in order to use these services.*
150
139
 
151
140
  4. Select **Credentials** from the side navigation.
152
141
 
153
- You should see a screen like one of the following.
154
-
155
- ![Create a new service account][create-new-service-account]
156
-
157
- ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
158
-
159
- Find the "Add credentials" drop down and select "Service account" to be
160
- guided through downloading a new JSON key file.
142
+ Find the "Create credentials" drop down near the top of the page, and select
143
+ "Service account" to be guided through downloading a new JSON key file.
161
144
 
162
145
  If you want to re-use an existing service account, you can easily generate a
163
- new key file. Just select the account you wish to re-use, and click "Generate
164
- new JSON key":
165
-
166
- ![Re-use an existing service account][reuse-service-account]
146
+ new key file. Just select the account you wish to re-use, click the pencil
147
+ tool on the right side to edit the service account, select the **Keys** tab,
148
+ and then select **Add Key**.
167
149
 
168
150
  The key file you download will be used by this library to authenticate API
169
151
  requests and should be stored in a secure location.
data/README.md CHANGED
@@ -31,10 +31,6 @@ In order to use this library, you first need to go through the following steps:
31
31
 
32
32
  ```ruby
33
33
  require "google/cloud/media_translation/v1beta1"
34
-
35
- client = ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.new
36
- request = my_create_request
37
- response = client.streaming_translate_speech request
38
34
  ```
39
35
 
40
36
  View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-media_translation-v1beta1/latest)
@@ -39,13 +39,12 @@ module Google
39
39
  # See {::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client::Configuration}
40
40
  # for a description of the configuration fields.
41
41
  #
42
- # ## Example
42
+ # @example
43
43
  #
44
- # To modify the configuration for all SpeechTranslationService clients:
45
- #
46
- # ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.configure do |config|
47
- # config.timeout = 10.0
48
- # end
44
+ # # Modify the configuration for all SpeechTranslationService clients
45
+ # ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.configure do |config|
46
+ # config.timeout = 10.0
47
+ # end
49
48
  #
50
49
  # @yield [config] Configure the Client client.
51
50
  # @yieldparam config [Client::Configuration]
@@ -65,10 +64,7 @@ module Google
65
64
 
66
65
  default_config.timeout = 400.0
67
66
  default_config.retry_policy = {
68
- initial_delay: 1.0,
69
- max_delay: 60.0,
70
- multiplier: 1.3,
71
- retry_codes: [14, 2, 4]
67
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 2, 4]
72
68
  }
73
69
 
74
70
  default_config.rpcs.streaming_translate_speech.timeout = 400.0
@@ -102,19 +98,15 @@ module Google
102
98
  ##
103
99
  # Create a new SpeechTranslationService client object.
104
100
  #
105
- # ## Examples
106
- #
107
- # To create a new SpeechTranslationService client with the default
108
- # configuration:
101
+ # @example
109
102
  #
110
- # client = ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.new
103
+ # # Create a client using the default configuration
104
+ # client = ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.new
111
105
  #
112
- # To create a new SpeechTranslationService client with a custom
113
- # configuration:
114
- #
115
- # client = ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.new do |config|
116
- # config.timeout = 10.0
117
- # end
106
+ # # Create a client using a custom configuration
107
+ # client = ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.new do |config|
108
+ # config.timeout = 10.0
109
+ # end
118
110
  #
119
111
  # @yield [config] Configure the SpeechTranslationService client.
120
112
  # @yieldparam config [Client::Configuration]
@@ -134,14 +126,13 @@ module Google
134
126
 
135
127
  # Create credentials
136
128
  credentials = @config.credentials
137
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
129
+ # Use self-signed JWT if the endpoint is unchanged from default,
138
130
  # but only if the default endpoint does not have a region prefix.
139
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
140
- @config.endpoint == Client.configure.endpoint &&
131
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
141
132
  !@config.endpoint.split(".").first.include?("-")
142
133
  credentials ||= Credentials.default scope: @config.scope,
143
134
  enable_self_signed_jwt: enable_self_signed_jwt
144
- if credentials.is_a?(String) || credentials.is_a?(Hash)
135
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
145
136
  credentials = Credentials.new credentials, scope: @config.scope
146
137
  end
147
138
  @quota_project_id = @config.quota_project
@@ -175,6 +166,30 @@ module Google
175
166
  #
176
167
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
177
168
  #
169
+ # @example Basic example
170
+ # require "google/cloud/media_translation/v1beta1"
171
+ #
172
+ # # Create a client object. The client can be reused for multiple calls.
173
+ # client = Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.new
174
+ #
175
+ # # Create an input stream
176
+ # input = Gapic::StreamInput.new
177
+ #
178
+ # # Call the streaming_translate_speech method to start streaming.
179
+ # output = client.streaming_translate_speech input
180
+ #
181
+ # # Send requests on the stream. For each request, pass in keyword
182
+ # # arguments to set fields. Be sure to close the stream when done.
183
+ # input << Google::Cloud::MediaTranslation::V1beta1::StreamingTranslateSpeechRequest.new
184
+ # input << Google::Cloud::MediaTranslation::V1beta1::StreamingTranslateSpeechRequest.new
185
+ # input.close
186
+ #
187
+ # # Handle streamed responses. These may be interleaved with inputs.
188
+ # # Each response is of type ::Google::Cloud::MediaTranslation::V1beta1::StreamingTranslateSpeechResponse.
189
+ # output.each do |response|
190
+ # p response
191
+ # end
192
+ #
178
193
  def streaming_translate_speech request, options = nil
179
194
  unless request.is_a? ::Enumerable
180
195
  raise ::ArgumentError, "request must be an Enumerable" unless request.respond_to? :to_enum
@@ -200,7 +215,9 @@ module Google
200
215
  options.apply_defaults timeout: @config.rpcs.streaming_translate_speech.timeout,
201
216
  metadata: metadata,
202
217
  retry_policy: @config.rpcs.streaming_translate_speech.retry_policy
203
- options.apply_defaults metadata: @config.metadata,
218
+
219
+ options.apply_defaults timeout: @config.timeout,
220
+ metadata: @config.metadata,
204
221
  retry_policy: @config.retry_policy
205
222
 
206
223
  @speech_translation_service_stub.call_rpc :streaming_translate_speech, request, options: options do |response, operation|
@@ -224,22 +241,21 @@ module Google
224
241
  # Configuration can be applied globally to all clients, or to a single client
225
242
  # on construction.
226
243
  #
227
- # # Examples
228
- #
229
- # To modify the global config, setting the timeout for streaming_translate_speech
230
- # to 20 seconds, and all remaining timeouts to 10 seconds:
231
- #
232
- # ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.configure do |config|
233
- # config.timeout = 10.0
234
- # config.rpcs.streaming_translate_speech.timeout = 20.0
235
- # end
236
- #
237
- # To apply the above configuration only to a new client:
238
- #
239
- # client = ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.new do |config|
240
- # config.timeout = 10.0
241
- # config.rpcs.streaming_translate_speech.timeout = 20.0
242
- # end
244
+ # @example
245
+ #
246
+ # # Modify the global config, setting the timeout for
247
+ # # streaming_translate_speech to 20 seconds,
248
+ # # and all remaining timeouts to 10 seconds.
249
+ # ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.configure do |config|
250
+ # config.timeout = 10.0
251
+ # config.rpcs.streaming_translate_speech.timeout = 20.0
252
+ # end
253
+ #
254
+ # # Apply the above configuration only to a new client.
255
+ # client = ::Google::Cloud::MediaTranslation::V1beta1::SpeechTranslationService::Client.new do |config|
256
+ # config.timeout = 10.0
257
+ # config.rpcs.streaming_translate_speech.timeout = 20.0
258
+ # end
243
259
  #
244
260
  # @!attribute [rw] endpoint
245
261
  # The hostname or hostname:port of the service endpoint.
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module MediaTranslation
23
23
  module V1beta1
24
- VERSION = "0.4.1"
24
+ VERSION = "0.4.5"
25
25
  end
26
26
  end
27
27
  end
@@ -1,11 +1,11 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/mediatranslation/v1beta1/media_translation.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/api/field_behavior_pb'
7
5
  require 'google/rpc/status_pb'
8
6
  require 'google/api/client_pb'
7
+ require 'google/protobuf'
8
+
9
9
  Google::Protobuf::DescriptorPool.generated_pool.build do
10
10
  add_file("google/cloud/mediatranslation/v1beta1/media_translation.proto", :syntax => :proto3) do
11
11
  add_message "google.cloud.mediatranslation.v1beta1.TranslateSpeechConfig" do
@@ -57,9 +57,15 @@ module Google
57
57
 
58
58
  # Denotes that a (repeated) field is an unordered list.
59
59
  # This indicates that the service may provide the elements of the list
60
- # in any arbitrary order, rather than the order the user originally
60
+ # in any arbitrary order, rather than the order the user originally
61
61
  # provided. Additionally, the list's order may or may not be stable.
62
62
  UNORDERED_LIST = 6
63
+
64
+ # Denotes that this field returns a non-empty default value if not set.
65
+ # This indicates that if the user provides the empty value in a request,
66
+ # a non-empty value will be returned. The user will not be aware of what
67
+ # non-empty value to expect.
68
+ NON_EMPTY_DEFAULT = 7
63
69
  end
64
70
  end
65
71
  end
@@ -33,11 +33,7 @@ module Google
33
33
  # // For Kubernetes resources, the format is {api group}/{kind}.
34
34
  # option (google.api.resource) = {
35
35
  # type: "pubsub.googleapis.com/Topic"
36
- # name_descriptor: {
37
- # pattern: "projects/{project}/topics/{topic}"
38
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
39
- # parent_name_extractor: "projects/{project}"
40
- # }
36
+ # pattern: "projects/{project}/topics/{topic}"
41
37
  # };
42
38
  # }
43
39
  #
@@ -45,10 +41,7 @@ module Google
45
41
  #
46
42
  # resources:
47
43
  # - type: "pubsub.googleapis.com/Topic"
48
- # name_descriptor:
49
- # - pattern: "projects/{project}/topics/{topic}"
50
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
- # parent_name_extractor: "projects/{project}"
44
+ # pattern: "projects/{project}/topics/{topic}"
52
45
  #
53
46
  # Sometimes, resources have multiple patterns, typically because they can
54
47
  # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
58
51
  # message LogEntry {
59
52
  # option (google.api.resource) = {
60
53
  # type: "logging.googleapis.com/LogEntry"
61
- # name_descriptor: {
62
- # pattern: "projects/{project}/logs/{log}"
63
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
64
- # parent_name_extractor: "projects/{project}"
65
- # }
66
- # name_descriptor: {
67
- # pattern: "folders/{folder}/logs/{log}"
68
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
69
- # parent_name_extractor: "folders/{folder}"
70
- # }
71
- # name_descriptor: {
72
- # pattern: "organizations/{organization}/logs/{log}"
73
- # parent_type: "cloudresourcemanager.googleapis.com/Organization"
74
- # parent_name_extractor: "organizations/{organization}"
75
- # }
76
- # name_descriptor: {
77
- # pattern: "billingAccounts/{billing_account}/logs/{log}"
78
- # parent_type: "billing.googleapis.com/BillingAccount"
79
- # parent_name_extractor: "billingAccounts/{billing_account}"
80
- # }
54
+ # pattern: "projects/{project}/logs/{log}"
55
+ # pattern: "folders/{folder}/logs/{log}"
56
+ # pattern: "organizations/{organization}/logs/{log}"
57
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
81
58
  # };
82
59
  # }
83
60
  #
@@ -85,48 +62,10 @@ module Google
85
62
  #
86
63
  # resources:
87
64
  # - type: 'logging.googleapis.com/LogEntry'
88
- # name_descriptor:
89
- # - pattern: "projects/{project}/logs/{log}"
90
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
91
- # parent_name_extractor: "projects/{project}"
92
- # - pattern: "folders/{folder}/logs/{log}"
93
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
94
- # parent_name_extractor: "folders/{folder}"
95
- # - pattern: "organizations/{organization}/logs/{log}"
96
- # parent_type: "cloudresourcemanager.googleapis.com/Organization"
97
- # parent_name_extractor: "organizations/{organization}"
98
- # - pattern: "billingAccounts/{billing_account}/logs/{log}"
99
- # parent_type: "billing.googleapis.com/BillingAccount"
100
- # parent_name_extractor: "billingAccounts/{billing_account}"
101
- #
102
- # For flexible resources, the resource name doesn't contain parent names, but
103
- # the resource itself has parents for policy evaluation.
104
- #
105
- # Example:
106
- #
107
- # message Shelf {
108
- # option (google.api.resource) = {
109
- # type: "library.googleapis.com/Shelf"
110
- # name_descriptor: {
111
- # pattern: "shelves/{shelf}"
112
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
113
- # }
114
- # name_descriptor: {
115
- # pattern: "shelves/{shelf}"
116
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
117
- # }
118
- # };
119
- # }
120
- #
121
- # The ResourceDescriptor Yaml config will look like:
122
- #
123
- # resources:
124
- # - type: 'library.googleapis.com/Shelf'
125
- # name_descriptor:
126
- # - pattern: "shelves/{shelf}"
127
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
128
- # - pattern: "shelves/{shelf}"
129
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
65
+ # pattern: "projects/{project}/logs/{log}"
66
+ # pattern: "folders/{folder}/logs/{log}"
67
+ # pattern: "organizations/{organization}/logs/{log}"
68
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
130
69
  # @!attribute [rw] type
131
70
  # @return [::String]
132
71
  # The resource type. It must be in the format of
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-media_translation-v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.1
4
+ version: 0.4.5
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-06-17 00:00:00.000000000 Z
11
+ date: 2022-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.5'
19
+ version: '0.7'
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.5'
29
+ version: '0.7'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -207,7 +207,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
207
207
  - !ruby/object:Gem::Version
208
208
  version: '0'
209
209
  requirements: []
210
- rubygems_version: 3.2.17
210
+ rubygems_version: 3.3.4
211
211
  signing_key:
212
212
  specification_version: 4
213
213
  summary: API Client library for the Media Translation V1beta1 API