google-cloud-media_translation-v1beta1 0.4.1 → 0.4.5

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 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