google-cloud-billing-v1 0.7.1 → 0.7.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: fc6e79dbf6159f5b068027b663112a9759c5ffa00d990a17a74a2090a57d1fdc
4
- data.tar.gz: cadfec57ec85a9da0a0d38650d084a7fd7fe1c3eec349fd9c0c80fa75d78812f
3
+ metadata.gz: 3141988d3e4254aa2ec504d2430a3d8fe992f63be99d4df94e584fd411c70ccf
4
+ data.tar.gz: 93fd74bce6189b7578575a49f375f663d70e752b23eecf8fe399340455da885d
5
5
  SHA512:
6
- metadata.gz: d401d8a6afa659519d8e701ce0113bc61243c1644cb4085ccbe21dda426820250fbcaf4d13d5a941ff8c1d413a12c33a8b81c6b8c3396095e97fa177bc5d75f8
7
- data.tar.gz: d427dc976f129b446e3282e1c760143030a239713f3772b5159cec96f8345b5a6c8804236e472a2dcf9506e37305c306a71d110244d22bf0a75cab020ca31a1c
6
+ metadata.gz: 55beef44252c1d7642f757a1428a03a77cdbcde8d609de3cbb17f527453d6b924a5f7e90e1b9b1582b84023f2233aea3adb22a8eb54c40f88f880836236a81c7
7
+ data.tar.gz: 952684b6b8d8b3a3c53533272368b2060b97cc6fc7339a506b9fce02686137b5c9f1da78f0ee646ef1d75d9c10d9a30819c4d5622c73acee7cbc78449b9698ef
data/.yardopts CHANGED
@@ -1,5 +1,5 @@
1
1
  --no-private
2
- --title=Billing V1 API
2
+ --title="Billing V1 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-billing-v1
66
66
  checks for credentials are configured on the service Credentials class (such as
67
67
  {::Google::Cloud::Billing::V1::CloudBilling::Credentials}):
68
68
 
69
- 1. `BILLING_CREDENTIALS` - Path to JSON file, or JSON contents
70
- 2. `BILLING_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
+ * `BILLING_CREDENTIALS` - Path to JSON file, or JSON contents
70
+ * `BILLING_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/billing/v1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::Billing::V1::CloudBilling::Client.new
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/billing/v1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::Billing::V1::CloudBilling::Client.new do |config|
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/billing/v1"
@@ -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
@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
33
33
  require "google/cloud/billing/v1"
34
34
 
35
35
  client = ::Google::Cloud::Billing::V1::CloudBilling::Client.new
36
- request = my_create_request
36
+ request = ::Google::Cloud::Billing::V1::GetBillingAccountRequest.new # (request fields as keyword arguments...)
37
37
  response = client.get_billing_account request
38
38
  ```
39
39
 
@@ -41,13 +41,12 @@ module Google
41
41
  # See {::Google::Cloud::Billing::V1::CloudBilling::Client::Configuration}
42
42
  # for a description of the configuration fields.
43
43
  #
44
- # ## Example
44
+ # @example
45
45
  #
46
- # To modify the configuration for all CloudBilling clients:
47
- #
48
- # ::Google::Cloud::Billing::V1::CloudBilling::Client.configure do |config|
49
- # config.timeout = 10.0
50
- # end
46
+ # # Modify the configuration for all CloudBilling clients
47
+ # ::Google::Cloud::Billing::V1::CloudBilling::Client.configure do |config|
48
+ # config.timeout = 10.0
49
+ # end
51
50
  #
52
51
  # @yield [config] Configure the Client client.
53
52
  # @yieldparam config [Client::Configuration]
@@ -67,76 +66,49 @@ module Google
67
66
 
68
67
  default_config.rpcs.get_billing_account.timeout = 60.0
69
68
  default_config.rpcs.get_billing_account.retry_policy = {
70
- initial_delay: 0.1,
71
- max_delay: 60.0,
72
- multiplier: 1.3,
73
- retry_codes: [4, 14]
69
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
74
70
  }
75
71
 
76
72
  default_config.rpcs.list_billing_accounts.timeout = 60.0
77
73
  default_config.rpcs.list_billing_accounts.retry_policy = {
78
- initial_delay: 0.1,
79
- max_delay: 60.0,
80
- multiplier: 1.3,
81
- retry_codes: [4, 14]
74
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
82
75
  }
83
76
 
84
77
  default_config.rpcs.update_billing_account.timeout = 60.0
85
78
  default_config.rpcs.update_billing_account.retry_policy = {
86
- initial_delay: 0.1,
87
- max_delay: 60.0,
88
- multiplier: 1.3,
89
- retry_codes: [4, 14]
79
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
90
80
  }
91
81
 
92
82
  default_config.rpcs.create_billing_account.timeout = 60.0
93
83
 
94
84
  default_config.rpcs.list_project_billing_info.timeout = 60.0
95
85
  default_config.rpcs.list_project_billing_info.retry_policy = {
96
- initial_delay: 0.1,
97
- max_delay: 60.0,
98
- multiplier: 1.3,
99
- retry_codes: [4, 14]
86
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
100
87
  }
101
88
 
102
89
  default_config.rpcs.get_project_billing_info.timeout = 60.0
103
90
  default_config.rpcs.get_project_billing_info.retry_policy = {
104
- initial_delay: 0.1,
105
- max_delay: 60.0,
106
- multiplier: 1.3,
107
- retry_codes: [4, 14]
91
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
108
92
  }
109
93
 
110
94
  default_config.rpcs.update_project_billing_info.timeout = 60.0
111
95
  default_config.rpcs.update_project_billing_info.retry_policy = {
112
- initial_delay: 0.1,
113
- max_delay: 60.0,
114
- multiplier: 1.3,
115
- retry_codes: [4, 14]
96
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
116
97
  }
117
98
 
118
99
  default_config.rpcs.get_iam_policy.timeout = 60.0
119
100
  default_config.rpcs.get_iam_policy.retry_policy = {
120
- initial_delay: 0.1,
121
- max_delay: 60.0,
122
- multiplier: 1.3,
123
- retry_codes: [4, 14]
101
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
124
102
  }
125
103
 
126
104
  default_config.rpcs.set_iam_policy.timeout = 60.0
127
105
  default_config.rpcs.set_iam_policy.retry_policy = {
128
- initial_delay: 0.1,
129
- max_delay: 60.0,
130
- multiplier: 1.3,
131
- retry_codes: [4, 14]
106
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
132
107
  }
133
108
 
134
109
  default_config.rpcs.test_iam_permissions.timeout = 60.0
135
110
  default_config.rpcs.test_iam_permissions.retry_policy = {
136
- initial_delay: 0.1,
137
- max_delay: 60.0,
138
- multiplier: 1.3,
139
- retry_codes: [4, 14]
111
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
140
112
  }
141
113
 
142
114
  default_config
@@ -168,19 +140,15 @@ module Google
168
140
  ##
169
141
  # Create a new CloudBilling client object.
170
142
  #
171
- # ## Examples
172
- #
173
- # To create a new CloudBilling client with the default
174
- # configuration:
175
- #
176
- # client = ::Google::Cloud::Billing::V1::CloudBilling::Client.new
143
+ # @example
177
144
  #
178
- # To create a new CloudBilling client with a custom
179
- # configuration:
145
+ # # Create a client using the default configuration
146
+ # client = ::Google::Cloud::Billing::V1::CloudBilling::Client.new
180
147
  #
181
- # client = ::Google::Cloud::Billing::V1::CloudBilling::Client.new do |config|
182
- # config.timeout = 10.0
183
- # end
148
+ # # Create a client using a custom configuration
149
+ # client = ::Google::Cloud::Billing::V1::CloudBilling::Client.new do |config|
150
+ # config.timeout = 10.0
151
+ # end
184
152
  #
185
153
  # @yield [config] Configure the CloudBilling client.
186
154
  # @yieldparam config [Client::Configuration]
@@ -200,14 +168,13 @@ module Google
200
168
 
201
169
  # Create credentials
202
170
  credentials = @config.credentials
203
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
171
+ # Use self-signed JWT if the endpoint is unchanged from default,
204
172
  # but only if the default endpoint does not have a region prefix.
205
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
206
- @config.endpoint == Client.configure.endpoint &&
173
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
207
174
  !@config.endpoint.split(".").first.include?("-")
208
175
  credentials ||= Credentials.default scope: @config.scope,
209
176
  enable_self_signed_jwt: enable_self_signed_jwt
210
- if credentials.is_a?(String) || credentials.is_a?(Hash)
177
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
211
178
  credentials = Credentials.new credentials, scope: @config.scope
212
179
  end
213
180
  @quota_project_id = @config.quota_project
@@ -256,6 +223,21 @@ module Google
256
223
  #
257
224
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
258
225
  #
226
+ # @example Basic example
227
+ # require "google/cloud/billing/v1"
228
+ #
229
+ # # Create a client object. The client can be reused for multiple calls.
230
+ # client = Google::Cloud::Billing::V1::CloudBilling::Client.new
231
+ #
232
+ # # Create a request. To set request fields, pass in keyword arguments.
233
+ # request = Google::Cloud::Billing::V1::GetBillingAccountRequest.new
234
+ #
235
+ # # Call the get_billing_account method.
236
+ # result = client.get_billing_account request
237
+ #
238
+ # # The returned object is of type Google::Cloud::Billing::V1::BillingAccount.
239
+ # p result
240
+ #
259
241
  def get_billing_account request, options = nil
260
242
  raise ::ArgumentError, "request must be provided" if request.nil?
261
243
 
@@ -273,16 +255,20 @@ module Google
273
255
  gapic_version: ::Google::Cloud::Billing::V1::VERSION
274
256
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
275
257
 
276
- header_params = {
277
- "name" => request.name
278
- }
258
+ header_params = {}
259
+ if request.name
260
+ header_params["name"] = request.name
261
+ end
262
+
279
263
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
280
264
  metadata[:"x-goog-request-params"] ||= request_params_header
281
265
 
282
266
  options.apply_defaults timeout: @config.rpcs.get_billing_account.timeout,
283
267
  metadata: metadata,
284
268
  retry_policy: @config.rpcs.get_billing_account.retry_policy
285
- options.apply_defaults metadata: @config.metadata,
269
+
270
+ options.apply_defaults timeout: @config.timeout,
271
+ metadata: @config.metadata,
286
272
  retry_policy: @config.retry_policy
287
273
 
288
274
  @cloud_billing_stub.call_rpc :get_billing_account, request, options: options do |response, operation|
@@ -336,6 +322,27 @@ module Google
336
322
  #
337
323
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
338
324
  #
325
+ # @example Basic example
326
+ # require "google/cloud/billing/v1"
327
+ #
328
+ # # Create a client object. The client can be reused for multiple calls.
329
+ # client = Google::Cloud::Billing::V1::CloudBilling::Client.new
330
+ #
331
+ # # Create a request. To set request fields, pass in keyword arguments.
332
+ # request = Google::Cloud::Billing::V1::ListBillingAccountsRequest.new
333
+ #
334
+ # # Call the list_billing_accounts method.
335
+ # result = client.list_billing_accounts request
336
+ #
337
+ # # The returned object is of type Gapic::PagedEnumerable. You can
338
+ # # iterate over all elements by calling #each, and the enumerable
339
+ # # will lazily make API calls to fetch subsequent pages. Other
340
+ # # methods are also available for managing paging directly.
341
+ # result.each do |response|
342
+ # # Each element is of type ::Google::Cloud::Billing::V1::BillingAccount.
343
+ # p response
344
+ # end
345
+ #
339
346
  def list_billing_accounts request, options = nil
340
347
  raise ::ArgumentError, "request must be provided" if request.nil?
341
348
 
@@ -356,7 +363,9 @@ module Google
356
363
  options.apply_defaults timeout: @config.rpcs.list_billing_accounts.timeout,
357
364
  metadata: metadata,
358
365
  retry_policy: @config.rpcs.list_billing_accounts.retry_policy
359
- options.apply_defaults metadata: @config.metadata,
366
+
367
+ options.apply_defaults timeout: @config.timeout,
368
+ metadata: @config.metadata,
360
369
  retry_policy: @config.retry_policy
361
370
 
362
371
  @cloud_billing_stub.call_rpc :list_billing_accounts, request, options: options do |response, operation|
@@ -407,6 +416,21 @@ module Google
407
416
  #
408
417
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
409
418
  #
419
+ # @example Basic example
420
+ # require "google/cloud/billing/v1"
421
+ #
422
+ # # Create a client object. The client can be reused for multiple calls.
423
+ # client = Google::Cloud::Billing::V1::CloudBilling::Client.new
424
+ #
425
+ # # Create a request. To set request fields, pass in keyword arguments.
426
+ # request = Google::Cloud::Billing::V1::UpdateBillingAccountRequest.new
427
+ #
428
+ # # Call the update_billing_account method.
429
+ # result = client.update_billing_account request
430
+ #
431
+ # # The returned object is of type Google::Cloud::Billing::V1::BillingAccount.
432
+ # p result
433
+ #
410
434
  def update_billing_account request, options = nil
411
435
  raise ::ArgumentError, "request must be provided" if request.nil?
412
436
 
@@ -424,16 +448,20 @@ module Google
424
448
  gapic_version: ::Google::Cloud::Billing::V1::VERSION
425
449
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
426
450
 
427
- header_params = {
428
- "name" => request.name
429
- }
451
+ header_params = {}
452
+ if request.name
453
+ header_params["name"] = request.name
454
+ end
455
+
430
456
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
431
457
  metadata[:"x-goog-request-params"] ||= request_params_header
432
458
 
433
459
  options.apply_defaults timeout: @config.rpcs.update_billing_account.timeout,
434
460
  metadata: metadata,
435
461
  retry_policy: @config.rpcs.update_billing_account.retry_policy
436
- options.apply_defaults metadata: @config.metadata,
462
+
463
+ options.apply_defaults timeout: @config.timeout,
464
+ metadata: @config.metadata,
437
465
  retry_policy: @config.retry_policy
438
466
 
439
467
  @cloud_billing_stub.call_rpc :update_billing_account, request, options: options do |response, operation|
@@ -485,6 +513,21 @@ module Google
485
513
  #
486
514
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
487
515
  #
516
+ # @example Basic example
517
+ # require "google/cloud/billing/v1"
518
+ #
519
+ # # Create a client object. The client can be reused for multiple calls.
520
+ # client = Google::Cloud::Billing::V1::CloudBilling::Client.new
521
+ #
522
+ # # Create a request. To set request fields, pass in keyword arguments.
523
+ # request = Google::Cloud::Billing::V1::CreateBillingAccountRequest.new
524
+ #
525
+ # # Call the create_billing_account method.
526
+ # result = client.create_billing_account request
527
+ #
528
+ # # The returned object is of type Google::Cloud::Billing::V1::BillingAccount.
529
+ # p result
530
+ #
488
531
  def create_billing_account request, options = nil
489
532
  raise ::ArgumentError, "request must be provided" if request.nil?
490
533
 
@@ -505,7 +548,9 @@ module Google
505
548
  options.apply_defaults timeout: @config.rpcs.create_billing_account.timeout,
506
549
  metadata: metadata,
507
550
  retry_policy: @config.rpcs.create_billing_account.retry_policy
508
- options.apply_defaults metadata: @config.metadata,
551
+
552
+ options.apply_defaults timeout: @config.timeout,
553
+ metadata: @config.metadata,
509
554
  retry_policy: @config.retry_policy
510
555
 
511
556
  @cloud_billing_stub.call_rpc :create_billing_account, request, options: options do |response, operation|
@@ -556,6 +601,27 @@ module Google
556
601
  #
557
602
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
558
603
  #
604
+ # @example Basic example
605
+ # require "google/cloud/billing/v1"
606
+ #
607
+ # # Create a client object. The client can be reused for multiple calls.
608
+ # client = Google::Cloud::Billing::V1::CloudBilling::Client.new
609
+ #
610
+ # # Create a request. To set request fields, pass in keyword arguments.
611
+ # request = Google::Cloud::Billing::V1::ListProjectBillingInfoRequest.new
612
+ #
613
+ # # Call the list_project_billing_info method.
614
+ # result = client.list_project_billing_info request
615
+ #
616
+ # # The returned object is of type Gapic::PagedEnumerable. You can
617
+ # # iterate over all elements by calling #each, and the enumerable
618
+ # # will lazily make API calls to fetch subsequent pages. Other
619
+ # # methods are also available for managing paging directly.
620
+ # result.each do |response|
621
+ # # Each element is of type ::Google::Cloud::Billing::V1::ProjectBillingInfo.
622
+ # p response
623
+ # end
624
+ #
559
625
  def list_project_billing_info request, options = nil
560
626
  raise ::ArgumentError, "request must be provided" if request.nil?
561
627
 
@@ -573,16 +639,20 @@ module Google
573
639
  gapic_version: ::Google::Cloud::Billing::V1::VERSION
574
640
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
575
641
 
576
- header_params = {
577
- "name" => request.name
578
- }
642
+ header_params = {}
643
+ if request.name
644
+ header_params["name"] = request.name
645
+ end
646
+
579
647
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
580
648
  metadata[:"x-goog-request-params"] ||= request_params_header
581
649
 
582
650
  options.apply_defaults timeout: @config.rpcs.list_project_billing_info.timeout,
583
651
  metadata: metadata,
584
652
  retry_policy: @config.rpcs.list_project_billing_info.retry_policy
585
- options.apply_defaults metadata: @config.metadata,
653
+
654
+ options.apply_defaults timeout: @config.timeout,
655
+ metadata: @config.metadata,
586
656
  retry_policy: @config.retry_policy
587
657
 
588
658
  @cloud_billing_stub.call_rpc :list_project_billing_info, request, options: options do |response, operation|
@@ -627,6 +697,21 @@ module Google
627
697
  #
628
698
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
629
699
  #
700
+ # @example Basic example
701
+ # require "google/cloud/billing/v1"
702
+ #
703
+ # # Create a client object. The client can be reused for multiple calls.
704
+ # client = Google::Cloud::Billing::V1::CloudBilling::Client.new
705
+ #
706
+ # # Create a request. To set request fields, pass in keyword arguments.
707
+ # request = Google::Cloud::Billing::V1::GetProjectBillingInfoRequest.new
708
+ #
709
+ # # Call the get_project_billing_info method.
710
+ # result = client.get_project_billing_info request
711
+ #
712
+ # # The returned object is of type Google::Cloud::Billing::V1::ProjectBillingInfo.
713
+ # p result
714
+ #
630
715
  def get_project_billing_info request, options = nil
631
716
  raise ::ArgumentError, "request must be provided" if request.nil?
632
717
 
@@ -644,16 +729,20 @@ module Google
644
729
  gapic_version: ::Google::Cloud::Billing::V1::VERSION
645
730
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
646
731
 
647
- header_params = {
648
- "name" => request.name
649
- }
732
+ header_params = {}
733
+ if request.name
734
+ header_params["name"] = request.name
735
+ end
736
+
650
737
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
651
738
  metadata[:"x-goog-request-params"] ||= request_params_header
652
739
 
653
740
  options.apply_defaults timeout: @config.rpcs.get_project_billing_info.timeout,
654
741
  metadata: metadata,
655
742
  retry_policy: @config.rpcs.get_project_billing_info.retry_policy
656
- options.apply_defaults metadata: @config.metadata,
743
+
744
+ options.apply_defaults timeout: @config.timeout,
745
+ metadata: @config.metadata,
657
746
  retry_policy: @config.retry_policy
658
747
 
659
748
  @cloud_billing_stub.call_rpc :get_project_billing_info, request, options: options do |response, operation|
@@ -727,6 +816,21 @@ module Google
727
816
  #
728
817
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
729
818
  #
819
+ # @example Basic example
820
+ # require "google/cloud/billing/v1"
821
+ #
822
+ # # Create a client object. The client can be reused for multiple calls.
823
+ # client = Google::Cloud::Billing::V1::CloudBilling::Client.new
824
+ #
825
+ # # Create a request. To set request fields, pass in keyword arguments.
826
+ # request = Google::Cloud::Billing::V1::UpdateProjectBillingInfoRequest.new
827
+ #
828
+ # # Call the update_project_billing_info method.
829
+ # result = client.update_project_billing_info request
830
+ #
831
+ # # The returned object is of type Google::Cloud::Billing::V1::ProjectBillingInfo.
832
+ # p result
833
+ #
730
834
  def update_project_billing_info request, options = nil
731
835
  raise ::ArgumentError, "request must be provided" if request.nil?
732
836
 
@@ -744,16 +848,20 @@ module Google
744
848
  gapic_version: ::Google::Cloud::Billing::V1::VERSION
745
849
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
746
850
 
747
- header_params = {
748
- "name" => request.name
749
- }
851
+ header_params = {}
852
+ if request.name
853
+ header_params["name"] = request.name
854
+ end
855
+
750
856
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
751
857
  metadata[:"x-goog-request-params"] ||= request_params_header
752
858
 
753
859
  options.apply_defaults timeout: @config.rpcs.update_project_billing_info.timeout,
754
860
  metadata: metadata,
755
861
  retry_policy: @config.rpcs.update_project_billing_info.retry_policy
756
- options.apply_defaults metadata: @config.metadata,
862
+
863
+ options.apply_defaults timeout: @config.timeout,
864
+ metadata: @config.metadata,
757
865
  retry_policy: @config.retry_policy
758
866
 
759
867
  @cloud_billing_stub.call_rpc :update_project_billing_info, request, options: options do |response, operation|
@@ -800,6 +908,21 @@ module Google
800
908
  #
801
909
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
802
910
  #
911
+ # @example Basic example
912
+ # require "google/cloud/billing/v1"
913
+ #
914
+ # # Create a client object. The client can be reused for multiple calls.
915
+ # client = Google::Cloud::Billing::V1::CloudBilling::Client.new
916
+ #
917
+ # # Create a request. To set request fields, pass in keyword arguments.
918
+ # request = Google::Iam::V1::GetIamPolicyRequest.new
919
+ #
920
+ # # Call the get_iam_policy method.
921
+ # result = client.get_iam_policy request
922
+ #
923
+ # # The returned object is of type Google::Iam::V1::Policy.
924
+ # p result
925
+ #
803
926
  def get_iam_policy request, options = nil
804
927
  raise ::ArgumentError, "request must be provided" if request.nil?
805
928
 
@@ -817,16 +940,20 @@ module Google
817
940
  gapic_version: ::Google::Cloud::Billing::V1::VERSION
818
941
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
819
942
 
820
- header_params = {
821
- "resource" => request.resource
822
- }
943
+ header_params = {}
944
+ if request.resource
945
+ header_params["resource"] = request.resource
946
+ end
947
+
823
948
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
824
949
  metadata[:"x-goog-request-params"] ||= request_params_header
825
950
 
826
951
  options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
827
952
  metadata: metadata,
828
953
  retry_policy: @config.rpcs.get_iam_policy.retry_policy
829
- options.apply_defaults metadata: @config.metadata,
954
+
955
+ options.apply_defaults timeout: @config.timeout,
956
+ metadata: @config.metadata,
830
957
  retry_policy: @config.retry_policy
831
958
 
832
959
  @cloud_billing_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
@@ -876,6 +1003,21 @@ module Google
876
1003
  #
877
1004
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
878
1005
  #
1006
+ # @example Basic example
1007
+ # require "google/cloud/billing/v1"
1008
+ #
1009
+ # # Create a client object. The client can be reused for multiple calls.
1010
+ # client = Google::Cloud::Billing::V1::CloudBilling::Client.new
1011
+ #
1012
+ # # Create a request. To set request fields, pass in keyword arguments.
1013
+ # request = Google::Iam::V1::SetIamPolicyRequest.new
1014
+ #
1015
+ # # Call the set_iam_policy method.
1016
+ # result = client.set_iam_policy request
1017
+ #
1018
+ # # The returned object is of type Google::Iam::V1::Policy.
1019
+ # p result
1020
+ #
879
1021
  def set_iam_policy request, options = nil
880
1022
  raise ::ArgumentError, "request must be provided" if request.nil?
881
1023
 
@@ -893,16 +1035,20 @@ module Google
893
1035
  gapic_version: ::Google::Cloud::Billing::V1::VERSION
894
1036
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
895
1037
 
896
- header_params = {
897
- "resource" => request.resource
898
- }
1038
+ header_params = {}
1039
+ if request.resource
1040
+ header_params["resource"] = request.resource
1041
+ end
1042
+
899
1043
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
900
1044
  metadata[:"x-goog-request-params"] ||= request_params_header
901
1045
 
902
1046
  options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
903
1047
  metadata: metadata,
904
1048
  retry_policy: @config.rpcs.set_iam_policy.retry_policy
905
- options.apply_defaults metadata: @config.metadata,
1049
+
1050
+ options.apply_defaults timeout: @config.timeout,
1051
+ metadata: @config.metadata,
906
1052
  retry_policy: @config.retry_policy
907
1053
 
908
1054
  @cloud_billing_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
@@ -950,6 +1096,21 @@ module Google
950
1096
  #
951
1097
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
952
1098
  #
1099
+ # @example Basic example
1100
+ # require "google/cloud/billing/v1"
1101
+ #
1102
+ # # Create a client object. The client can be reused for multiple calls.
1103
+ # client = Google::Cloud::Billing::V1::CloudBilling::Client.new
1104
+ #
1105
+ # # Create a request. To set request fields, pass in keyword arguments.
1106
+ # request = Google::Iam::V1::TestIamPermissionsRequest.new
1107
+ #
1108
+ # # Call the test_iam_permissions method.
1109
+ # result = client.test_iam_permissions request
1110
+ #
1111
+ # # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
1112
+ # p result
1113
+ #
953
1114
  def test_iam_permissions request, options = nil
954
1115
  raise ::ArgumentError, "request must be provided" if request.nil?
955
1116
 
@@ -967,16 +1128,20 @@ module Google
967
1128
  gapic_version: ::Google::Cloud::Billing::V1::VERSION
968
1129
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
969
1130
 
970
- header_params = {
971
- "resource" => request.resource
972
- }
1131
+ header_params = {}
1132
+ if request.resource
1133
+ header_params["resource"] = request.resource
1134
+ end
1135
+
973
1136
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
974
1137
  metadata[:"x-goog-request-params"] ||= request_params_header
975
1138
 
976
1139
  options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
977
1140
  metadata: metadata,
978
1141
  retry_policy: @config.rpcs.test_iam_permissions.retry_policy
979
- options.apply_defaults metadata: @config.metadata,
1142
+
1143
+ options.apply_defaults timeout: @config.timeout,
1144
+ metadata: @config.metadata,
980
1145
  retry_policy: @config.retry_policy
981
1146
 
982
1147
  @cloud_billing_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
@@ -1000,22 +1165,21 @@ module Google
1000
1165
  # Configuration can be applied globally to all clients, or to a single client
1001
1166
  # on construction.
1002
1167
  #
1003
- # # Examples
1004
- #
1005
- # To modify the global config, setting the timeout for get_billing_account
1006
- # to 20 seconds, and all remaining timeouts to 10 seconds:
1007
- #
1008
- # ::Google::Cloud::Billing::V1::CloudBilling::Client.configure do |config|
1009
- # config.timeout = 10.0
1010
- # config.rpcs.get_billing_account.timeout = 20.0
1011
- # end
1012
- #
1013
- # To apply the above configuration only to a new client:
1014
- #
1015
- # client = ::Google::Cloud::Billing::V1::CloudBilling::Client.new do |config|
1016
- # config.timeout = 10.0
1017
- # config.rpcs.get_billing_account.timeout = 20.0
1018
- # end
1168
+ # @example
1169
+ #
1170
+ # # Modify the global config, setting the timeout for
1171
+ # # get_billing_account to 20 seconds,
1172
+ # # and all remaining timeouts to 10 seconds.
1173
+ # ::Google::Cloud::Billing::V1::CloudBilling::Client.configure do |config|
1174
+ # config.timeout = 10.0
1175
+ # config.rpcs.get_billing_account.timeout = 20.0
1176
+ # end
1177
+ #
1178
+ # # Apply the above configuration only to a new client.
1179
+ # client = ::Google::Cloud::Billing::V1::CloudBilling::Client.new do |config|
1180
+ # config.timeout = 10.0
1181
+ # config.rpcs.get_billing_account.timeout = 20.0
1182
+ # end
1019
1183
  #
1020
1184
  # @!attribute [rw] endpoint
1021
1185
  # The hostname or hostname:port of the service endpoint.
@@ -1,8 +1,6 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/billing/v1/cloud_billing.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/api/annotations_pb'
7
5
  require 'google/api/client_pb'
8
6
  require 'google/api/field_behavior_pb'
@@ -10,6 +8,8 @@ require 'google/api/resource_pb'
10
8
  require 'google/iam/v1/iam_policy_pb'
11
9
  require 'google/iam/v1/policy_pb'
12
10
  require 'google/protobuf/field_mask_pb'
11
+ require 'google/protobuf'
12
+
13
13
  Google::Protobuf::DescriptorPool.generated_pool.build do
14
14
  add_file("google/cloud/billing/v1/cloud_billing.proto", :syntax => :proto3) do
15
15
  add_message "google.cloud.billing.v1.BillingAccount" do
@@ -43,13 +43,12 @@ module Google
43
43
  # See {::Google::Cloud::Billing::V1::CloudCatalog::Client::Configuration}
44
44
  # for a description of the configuration fields.
45
45
  #
46
- # ## Example
46
+ # @example
47
47
  #
48
- # To modify the configuration for all CloudCatalog clients:
49
- #
50
- # ::Google::Cloud::Billing::V1::CloudCatalog::Client.configure do |config|
51
- # config.timeout = 10.0
52
- # end
48
+ # # Modify the configuration for all CloudCatalog clients
49
+ # ::Google::Cloud::Billing::V1::CloudCatalog::Client.configure do |config|
50
+ # config.timeout = 10.0
51
+ # end
53
52
  #
54
53
  # @yield [config] Configure the Client client.
55
54
  # @yieldparam config [Client::Configuration]
@@ -100,19 +99,15 @@ module Google
100
99
  ##
101
100
  # Create a new CloudCatalog client object.
102
101
  #
103
- # ## Examples
104
- #
105
- # To create a new CloudCatalog client with the default
106
- # configuration:
107
- #
108
- # client = ::Google::Cloud::Billing::V1::CloudCatalog::Client.new
102
+ # @example
109
103
  #
110
- # To create a new CloudCatalog client with a custom
111
- # configuration:
104
+ # # Create a client using the default configuration
105
+ # client = ::Google::Cloud::Billing::V1::CloudCatalog::Client.new
112
106
  #
113
- # client = ::Google::Cloud::Billing::V1::CloudCatalog::Client.new do |config|
114
- # config.timeout = 10.0
115
- # end
107
+ # # Create a client using a custom configuration
108
+ # client = ::Google::Cloud::Billing::V1::CloudCatalog::Client.new do |config|
109
+ # config.timeout = 10.0
110
+ # end
116
111
  #
117
112
  # @yield [config] Configure the CloudCatalog client.
118
113
  # @yieldparam config [Client::Configuration]
@@ -132,14 +127,13 @@ module Google
132
127
 
133
128
  # Create credentials
134
129
  credentials = @config.credentials
135
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
130
+ # Use self-signed JWT if the endpoint is unchanged from default,
136
131
  # but only if the default endpoint does not have a region prefix.
137
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
138
- @config.endpoint == Client.configure.endpoint &&
132
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
139
133
  !@config.endpoint.split(".").first.include?("-")
140
134
  credentials ||= Credentials.default scope: @config.scope,
141
135
  enable_self_signed_jwt: enable_self_signed_jwt
142
- if credentials.is_a?(String) || credentials.is_a?(Hash)
136
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
143
137
  credentials = Credentials.new credentials, scope: @config.scope
144
138
  end
145
139
  @quota_project_id = @config.quota_project
@@ -189,6 +183,27 @@ module Google
189
183
  #
190
184
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
191
185
  #
186
+ # @example Basic example
187
+ # require "google/cloud/billing/v1"
188
+ #
189
+ # # Create a client object. The client can be reused for multiple calls.
190
+ # client = Google::Cloud::Billing::V1::CloudCatalog::Client.new
191
+ #
192
+ # # Create a request. To set request fields, pass in keyword arguments.
193
+ # request = Google::Cloud::Billing::V1::ListServicesRequest.new
194
+ #
195
+ # # Call the list_services method.
196
+ # result = client.list_services request
197
+ #
198
+ # # The returned object is of type Gapic::PagedEnumerable. You can
199
+ # # iterate over all elements by calling #each, and the enumerable
200
+ # # will lazily make API calls to fetch subsequent pages. Other
201
+ # # methods are also available for managing paging directly.
202
+ # result.each do |response|
203
+ # # Each element is of type ::Google::Cloud::Billing::V1::Service.
204
+ # p response
205
+ # end
206
+ #
192
207
  def list_services request, options = nil
193
208
  raise ::ArgumentError, "request must be provided" if request.nil?
194
209
 
@@ -209,7 +224,9 @@ module Google
209
224
  options.apply_defaults timeout: @config.rpcs.list_services.timeout,
210
225
  metadata: metadata,
211
226
  retry_policy: @config.rpcs.list_services.retry_policy
212
- options.apply_defaults metadata: @config.metadata,
227
+
228
+ options.apply_defaults timeout: @config.timeout,
229
+ metadata: @config.metadata,
213
230
  retry_policy: @config.retry_policy
214
231
 
215
232
  @cloud_catalog_stub.call_rpc :list_services, request, options: options do |response, operation|
@@ -275,6 +292,27 @@ module Google
275
292
  #
276
293
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
277
294
  #
295
+ # @example Basic example
296
+ # require "google/cloud/billing/v1"
297
+ #
298
+ # # Create a client object. The client can be reused for multiple calls.
299
+ # client = Google::Cloud::Billing::V1::CloudCatalog::Client.new
300
+ #
301
+ # # Create a request. To set request fields, pass in keyword arguments.
302
+ # request = Google::Cloud::Billing::V1::ListSkusRequest.new
303
+ #
304
+ # # Call the list_skus method.
305
+ # result = client.list_skus request
306
+ #
307
+ # # The returned object is of type Gapic::PagedEnumerable. You can
308
+ # # iterate over all elements by calling #each, and the enumerable
309
+ # # will lazily make API calls to fetch subsequent pages. Other
310
+ # # methods are also available for managing paging directly.
311
+ # result.each do |response|
312
+ # # Each element is of type ::Google::Cloud::Billing::V1::Sku.
313
+ # p response
314
+ # end
315
+ #
278
316
  def list_skus request, options = nil
279
317
  raise ::ArgumentError, "request must be provided" if request.nil?
280
318
 
@@ -292,16 +330,20 @@ module Google
292
330
  gapic_version: ::Google::Cloud::Billing::V1::VERSION
293
331
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
294
332
 
295
- header_params = {
296
- "parent" => request.parent
297
- }
333
+ header_params = {}
334
+ if request.parent
335
+ header_params["parent"] = request.parent
336
+ end
337
+
298
338
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
299
339
  metadata[:"x-goog-request-params"] ||= request_params_header
300
340
 
301
341
  options.apply_defaults timeout: @config.rpcs.list_skus.timeout,
302
342
  metadata: metadata,
303
343
  retry_policy: @config.rpcs.list_skus.retry_policy
304
- options.apply_defaults metadata: @config.metadata,
344
+
345
+ options.apply_defaults timeout: @config.timeout,
346
+ metadata: @config.metadata,
305
347
  retry_policy: @config.retry_policy
306
348
 
307
349
  @cloud_catalog_stub.call_rpc :list_skus, request, options: options do |response, operation|
@@ -326,22 +368,21 @@ module Google
326
368
  # Configuration can be applied globally to all clients, or to a single client
327
369
  # on construction.
328
370
  #
329
- # # Examples
330
- #
331
- # To modify the global config, setting the timeout for list_services
332
- # to 20 seconds, and all remaining timeouts to 10 seconds:
333
- #
334
- # ::Google::Cloud::Billing::V1::CloudCatalog::Client.configure do |config|
335
- # config.timeout = 10.0
336
- # config.rpcs.list_services.timeout = 20.0
337
- # end
338
- #
339
- # To apply the above configuration only to a new client:
340
- #
341
- # client = ::Google::Cloud::Billing::V1::CloudCatalog::Client.new do |config|
342
- # config.timeout = 10.0
343
- # config.rpcs.list_services.timeout = 20.0
344
- # end
371
+ # @example
372
+ #
373
+ # # Modify the global config, setting the timeout for
374
+ # # list_services to 20 seconds,
375
+ # # and all remaining timeouts to 10 seconds.
376
+ # ::Google::Cloud::Billing::V1::CloudCatalog::Client.configure do |config|
377
+ # config.timeout = 10.0
378
+ # config.rpcs.list_services.timeout = 20.0
379
+ # end
380
+ #
381
+ # # Apply the above configuration only to a new client.
382
+ # client = ::Google::Cloud::Billing::V1::CloudCatalog::Client.new do |config|
383
+ # config.timeout = 10.0
384
+ # config.rpcs.list_services.timeout = 20.0
385
+ # end
345
386
  #
346
387
  # @!attribute [rw] endpoint
347
388
  # The hostname or hostname:port of the service endpoint.
@@ -1,14 +1,14 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/billing/v1/cloud_catalog.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/api/annotations_pb'
7
5
  require 'google/api/client_pb'
8
6
  require 'google/api/field_behavior_pb'
9
7
  require 'google/api/resource_pb'
10
8
  require 'google/protobuf/timestamp_pb'
11
9
  require 'google/type/money_pb'
10
+ require 'google/protobuf'
11
+
12
12
  Google::Protobuf::DescriptorPool.generated_pool.build do
13
13
  add_file("google/cloud/billing/v1/cloud_catalog.proto", :syntax => :proto3) do
14
14
  add_message "google.cloud.billing.v1.Service" do
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Billing
23
23
  module V1
24
- VERSION = "0.7.1"
24
+ VERSION = "0.7.5"
25
25
  end
26
26
  end
27
27
  end
@@ -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
@@ -19,30 +19,53 @@
19
19
 
20
20
  module Google
21
21
  module Type
22
- # Represents an expression text. Example:
22
+ # Represents a textual expression in the Common Expression Language (CEL)
23
+ # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
24
+ # are documented at https://github.com/google/cel-spec.
23
25
  #
24
- # title: "User account presence"
25
- # description: "Determines whether the request has a user account"
26
- # expression: "size(request.user) > 0"
26
+ # Example (Comparison):
27
+ #
28
+ # title: "Summary size limit"
29
+ # description: "Determines if a summary is less than 100 chars"
30
+ # expression: "document.summary.size() < 100"
31
+ #
32
+ # Example (Equality):
33
+ #
34
+ # title: "Requestor is owner"
35
+ # description: "Determines if requestor is the document owner"
36
+ # expression: "document.owner == request.auth.claims.email"
37
+ #
38
+ # Example (Logic):
39
+ #
40
+ # title: "Public documents"
41
+ # description: "Determine whether the document should be publicly visible"
42
+ # expression: "document.type != 'private' && document.type != 'internal'"
43
+ #
44
+ # Example (Data Manipulation):
45
+ #
46
+ # title: "Notification string"
47
+ # description: "Create a notification string with a timestamp."
48
+ # expression: "'New message received at ' + string(document.create_time)"
49
+ #
50
+ # The exact variables and functions that may be referenced within an expression
51
+ # are determined by the service that evaluates it. See the service
52
+ # documentation for additional information.
27
53
  # @!attribute [rw] expression
28
54
  # @return [::String]
29
- # Textual representation of an expression in
30
- # Common Expression Language syntax.
31
- #
32
- # The application context of the containing message determines which
33
- # well-known feature set of CEL is supported.
55
+ # Textual representation of an expression in Common Expression Language
56
+ # syntax.
34
57
  # @!attribute [rw] title
35
58
  # @return [::String]
36
- # An optional title for the expression, i.e. a short string describing
59
+ # Optional. Title for the expression, i.e. a short string describing
37
60
  # its purpose. This can be used e.g. in UIs which allow to enter the
38
61
  # expression.
39
62
  # @!attribute [rw] description
40
63
  # @return [::String]
41
- # An optional description of the expression. This is a longer text which
64
+ # Optional. Description of the expression. This is a longer text which
42
65
  # describes the expression, e.g. when hovered over it in a UI.
43
66
  # @!attribute [rw] location
44
67
  # @return [::String]
45
- # An optional string indicating the location of the expression for error
68
+ # Optional. String indicating the location of the expression for error
46
69
  # reporting, e.g. a file name and a position in the file.
47
70
  class Expr
48
71
  include ::Google::Protobuf::MessageExts
@@ -22,7 +22,7 @@ module Google
22
22
  # Represents an amount of money with its currency type.
23
23
  # @!attribute [rw] currency_code
24
24
  # @return [::String]
25
- # The 3-letter currency code defined in ISO 4217.
25
+ # The three-letter currency code defined in ISO 4217.
26
26
  # @!attribute [rw] units
27
27
  # @return [::Integer]
28
28
  # The whole units of the amount.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-billing-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.7.1
4
+ version: 0.7.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
@@ -235,7 +235,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
235
235
  - !ruby/object:Gem::Version
236
236
  version: '0'
237
237
  requirements: []
238
- rubygems_version: 3.2.17
238
+ rubygems_version: 3.3.4
239
239
  signing_key:
240
240
  specification_version: 4
241
241
  summary: API Client library for the Billing V1 API