google-cloud-channel-v1 0.14.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +2 -2
  3. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/client.rb +38 -36
  4. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/operations.rb +12 -14
  5. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/client.rb +583 -0
  6. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/operations.rb +793 -0
  7. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/service_stub.rb +227 -0
  8. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest.rb +56 -0
  9. data/lib/google/cloud/channel/v1/cloud_channel_reports_service.rb +7 -1
  10. data/lib/google/cloud/channel/v1/cloud_channel_service/client.rb +389 -327
  11. data/lib/google/cloud/channel/v1/cloud_channel_service/operations.rb +12 -14
  12. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/client.rb +4784 -0
  13. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/operations.rb +793 -0
  14. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/service_stub.rb +2771 -0
  15. data/lib/google/cloud/channel/v1/cloud_channel_service/rest.rb +72 -0
  16. data/lib/google/cloud/channel/v1/cloud_channel_service.rb +15 -8
  17. data/lib/google/cloud/channel/v1/reports_service_services_pb.rb +4 -2
  18. data/lib/google/cloud/channel/v1/repricing_pb.rb +17 -0
  19. data/lib/google/cloud/channel/v1/rest.rb +38 -0
  20. data/lib/google/cloud/channel/v1/service_services_pb.rb +155 -102
  21. data/lib/google/cloud/channel/v1/version.rb +1 -1
  22. data/lib/google/cloud/channel/v1.rb +7 -2
  23. data/proto_docs/google/api/client.rb +318 -0
  24. data/proto_docs/google/api/launch_stage.rb +71 -0
  25. data/proto_docs/google/cloud/channel/v1/channel_partner_links.rb +5 -3
  26. data/proto_docs/google/cloud/channel/v1/entitlements.rb +21 -16
  27. data/proto_docs/google/cloud/channel/v1/offers.rb +2 -2
  28. data/proto_docs/google/cloud/channel/v1/operations.rb +2 -1
  29. data/proto_docs/google/cloud/channel/v1/reports_service.rb +49 -34
  30. data/proto_docs/google/cloud/channel/v1/repricing.rb +63 -14
  31. data/proto_docs/google/cloud/channel/v1/service.rb +241 -159
  32. data/proto_docs/google/rpc/status.rb +4 -2
  33. metadata +21 -8
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e2a27761452f019abbce6e4d101c681898e68ac29282ad0b2ca7033f14498614
4
- data.tar.gz: d2ebee645190d8e393c1d0fe5ebf94b8052c7056746d978cf019e98a1bfe9520
3
+ metadata.gz: cdf3c3ad2fbdba2747db533d2b1799aa193890699bee88076ad04fd752169561
4
+ data.tar.gz: 6c491505cced7628a330142bdafaa10486aafe6400c0cba132c4ba42090f4704
5
5
  SHA512:
6
- metadata.gz: abd65416c88e4bd1502814bc8dc825a9459a0046628da1998e900b6de953583baada1e7a2a1c29d17631f6892403a5d5f34d2c2124a73f6264d11f01a3dd058c
7
- data.tar.gz: 2b4b5a08959b1ddaffc29411e997813c16ccac6cc92ffe267343a4f9dabe40b94606065e4da06044691415560d2731f5bc5db772e73df3229f9c34b95d595dfc
6
+ metadata.gz: 6225e99f7fed79535a4d1c24ce37d447cb539602a29c704c70624ec0ca6cc85239d15003cd3c1e7e9d57cd3f0482fa916823d420e1131de8a0d581f5e3932195
7
+ data.tar.gz: 431ea70d5f3b5eaeaa79be21bea9623f804372d5c923f66d0eb7828561d9fb5fff83dc757b72ba3f175926fa0b6323c63539357a4718699a46ae6cf17bf13f67
data/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Ruby Client for the Cloud Channel V1 API
2
2
 
3
- API Client library for the Cloud Channel V1 API
3
+ The Cloud Channel API enables Google Cloud partners to have a single unified resale platform and APIs across all of Google Cloud including GCP, Workspace, Maps and Chrome.
4
4
 
5
5
  You can use Channel Services to manage your relationships with your partners and your customers. Channel Services include a console and APIs to view and provision links between distributors and resellers, customers and entitlements.
6
6
 
@@ -46,7 +46,7 @@ for general usage information.
46
46
  ## Enabling Logging
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
49
+ The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
50
  or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
@@ -183,7 +183,8 @@ module Google
183
183
  # instance of {::Google::Cloud::Channel::V1::OperationMetadata OperationMetadata}.
184
184
  #
185
185
  # To get the results of report generation, call
186
- # {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client#fetch_report_results CloudChannelReportsService.FetchReportResults} with the
186
+ # {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client#fetch_report_results CloudChannelReportsService.FetchReportResults}
187
+ # with the
187
188
  # {::Google::Cloud::Channel::V1::RunReportJobResponse#report_job RunReportJobResponse.report_job}.
188
189
  #
189
190
  # @overload run_report_job(request, options = nil)
@@ -202,16 +203,16 @@ module Google
202
203
  # the default parameter values, pass an empty Hash as a request object (see above).
203
204
  #
204
205
  # @param name [::String]
205
- # Required. The report's resource name. Specifies the account and report used to
206
- # generate report data. The report_id identifier is a UID (for example,
206
+ # Required. The report's resource name. Specifies the account and report used
207
+ # to generate report data. The report_id identifier is a UID (for example,
207
208
  # `613bf59q`).
208
209
  # Name uses the format:
209
210
  # accounts/\\{account_id}/reports/\\{report_id}
210
211
  # @param date_range [::Google::Cloud::Channel::V1::DateRange, ::Hash]
211
212
  # Optional. The range of usage or invoice dates to include in the result.
212
213
  # @param filter [::String]
213
- # Optional. A structured string that defines conditions on dimension columns to
214
- # restrict the report output.
214
+ # Optional. A structured string that defines conditions on dimension columns
215
+ # to restrict the report output.
215
216
  #
216
217
  # Filters support logical operators (AND, OR, NOT) and conditional operators
217
218
  # (=, !=, <, >, <=, and >=) using `column_id` as keys.
@@ -246,14 +247,14 @@ module Google
246
247
  # # Call the run_report_job method.
247
248
  # result = client.run_report_job request
248
249
  #
249
- # # The returned object is of type Gapic::Operation. You can use this
250
- # # object to check the status of an operation, cancel it, or wait
251
- # # for results. Here is how to block until completion:
250
+ # # The returned object is of type Gapic::Operation. You can use it to
251
+ # # check the status of an operation, cancel it, or wait for results.
252
+ # # Here is how to wait for a response.
252
253
  # result.wait_until_done! timeout: 60
253
254
  # if result.response?
254
255
  # p result.response
255
256
  # else
256
- # puts "Error!"
257
+ # puts "No response received."
257
258
  # end
258
259
  #
259
260
  def run_report_job request, options = nil
@@ -299,7 +300,8 @@ module Google
299
300
  end
300
301
 
301
302
  ##
302
- # Retrieves data generated by {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client#run_report_job CloudChannelReportsService.RunReportJob}.
303
+ # Retrieves data generated by
304
+ # {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client#run_report_job CloudChannelReportsService.RunReportJob}.
303
305
  #
304
306
  # @overload fetch_report_results(request, options = nil)
305
307
  # Pass arguments to `fetch_report_results` via a request object, either of type
@@ -317,21 +319,24 @@ module Google
317
319
  # the default parameter values, pass an empty Hash as a request object (see above).
318
320
  #
319
321
  # @param report_job [::String]
320
- # Required. The report job created by {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client#run_report_job CloudChannelReportsService.RunReportJob}.
322
+ # Required. The report job created by
323
+ # {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client#run_report_job CloudChannelReportsService.RunReportJob}.
321
324
  # Report_job uses the format:
322
325
  # accounts/\\{account_id}/reportJobs/\\{report_job_id}
323
326
  # @param page_size [::Integer]
324
- # Optional. Requested page size of the report. The server may return fewer results than
325
- # requested. If you don't specify a page size, the server uses a sensible
326
- # default (may change over time).
327
+ # Optional. Requested page size of the report. The server may return fewer
328
+ # results than requested. If you don't specify a page size, the server uses a
329
+ # sensible default (may change over time).
327
330
  #
328
331
  # The maximum value is 30,000; the server will change larger values to
329
332
  # 30,000.
330
333
  # @param page_token [::String]
331
334
  # Optional. A token that specifies a page of results beyond the first page.
332
335
  # Obtained through
333
- # {::Google::Cloud::Channel::V1::FetchReportResultsResponse#next_page_token FetchReportResultsResponse.next_page_token} of the previous
334
- # {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client#fetch_report_results CloudChannelReportsService.FetchReportResults} call.
336
+ # {::Google::Cloud::Channel::V1::FetchReportResultsResponse#next_page_token FetchReportResultsResponse.next_page_token}
337
+ # of the previous
338
+ # {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client#fetch_report_results CloudChannelReportsService.FetchReportResults}
339
+ # call.
335
340
  #
336
341
  # @yield [response, operation] Access the result along with the RPC operation
337
342
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Channel::V1::Row>]
@@ -353,13 +358,11 @@ module Google
353
358
  # # Call the fetch_report_results method.
354
359
  # result = client.fetch_report_results request
355
360
  #
356
- # # The returned object is of type Gapic::PagedEnumerable. You can
357
- # # iterate over all elements by calling #each, and the enumerable
358
- # # will lazily make API calls to fetch subsequent pages. Other
359
- # # methods are also available for managing paging directly.
360
- # result.each do |response|
361
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
362
+ # # over elements, and API calls will be issued to fetch pages as needed.
363
+ # result.each do |item|
361
364
  # # Each element is of type ::Google::Cloud::Channel::V1::Row.
362
- # p response
365
+ # p item
363
366
  # end
364
367
  #
365
368
  def fetch_report_results request, options = nil
@@ -424,18 +427,19 @@ module Google
424
427
  # the default parameter values, pass an empty Hash as a request object (see above).
425
428
  #
426
429
  # @param parent [::String]
427
- # Required. The resource name of the partner account to list available reports for.
428
- # Parent uses the format:
429
- # accounts/\\{account_id}
430
+ # Required. The resource name of the partner account to list available
431
+ # reports for. Parent uses the format: accounts/\\{account_id}
430
432
  # @param page_size [::Integer]
431
- # Optional. Requested page size of the report. The server might return fewer results
432
- # than requested. If unspecified, returns 20 reports.
433
- # The maximum value is 100.
433
+ # Optional. Requested page size of the report. The server might return fewer
434
+ # results than requested. If unspecified, returns 20 reports. The maximum
435
+ # value is 100.
434
436
  # @param page_token [::String]
435
437
  # Optional. A token that specifies a page of results beyond the first page.
436
438
  # Obtained through
437
- # {::Google::Cloud::Channel::V1::ListReportsResponse#next_page_token ListReportsResponse.next_page_token} of the previous
438
- # {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client#list_reports CloudChannelReportsService.ListReports} call.
439
+ # {::Google::Cloud::Channel::V1::ListReportsResponse#next_page_token ListReportsResponse.next_page_token}
440
+ # of the previous
441
+ # {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client#list_reports CloudChannelReportsService.ListReports}
442
+ # call.
439
443
  # @param language_code [::String]
440
444
  # Optional. The BCP-47 language code, such as "en-US". If specified, the
441
445
  # response is localized to the corresponding language code if the
@@ -462,13 +466,11 @@ module Google
462
466
  # # Call the list_reports method.
463
467
  # result = client.list_reports request
464
468
  #
465
- # # The returned object is of type Gapic::PagedEnumerable. You can
466
- # # iterate over all elements by calling #each, and the enumerable
467
- # # will lazily make API calls to fetch subsequent pages. Other
468
- # # methods are also available for managing paging directly.
469
- # result.each do |response|
469
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
470
+ # # over elements, and API calls will be issued to fetch pages as needed.
471
+ # result.each do |item|
470
472
  # # Each element is of type ::Google::Cloud::Channel::V1::Report.
471
- # p response
473
+ # p item
472
474
  # end
473
475
  #
474
476
  def list_reports request, options = nil
@@ -158,13 +158,11 @@ module Google
158
158
  # # Call the list_operations method.
159
159
  # result = client.list_operations request
160
160
  #
161
- # # The returned object is of type Gapic::PagedEnumerable. You can
162
- # # iterate over all elements by calling #each, and the enumerable
163
- # # will lazily make API calls to fetch subsequent pages. Other
164
- # # methods are also available for managing paging directly.
165
- # result.each do |response|
161
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
162
+ # # over elements, and API calls will be issued to fetch pages as needed.
163
+ # result.each do |item|
166
164
  # # Each element is of type ::Google::Longrunning::Operation.
167
- # p response
165
+ # p item
168
166
  # end
169
167
  #
170
168
  def list_operations request, options = nil
@@ -253,14 +251,14 @@ module Google
253
251
  # # Call the get_operation method.
254
252
  # result = client.get_operation request
255
253
  #
256
- # # The returned object is of type Gapic::Operation. You can use this
257
- # # object to check the status of an operation, cancel it, or wait
258
- # # for results. Here is how to block until completion:
254
+ # # The returned object is of type Gapic::Operation. You can use it to
255
+ # # check the status of an operation, cancel it, or wait for results.
256
+ # # Here is how to wait for a response.
259
257
  # result.wait_until_done! timeout: 60
260
258
  # if result.response?
261
259
  # p result.response
262
260
  # else
263
- # puts "Error!"
261
+ # puts "No response received."
264
262
  # end
265
263
  #
266
264
  def get_operation request, options = nil
@@ -540,14 +538,14 @@ module Google
540
538
  # # Call the wait_operation method.
541
539
  # result = client.wait_operation request
542
540
  #
543
- # # The returned object is of type Gapic::Operation. You can use this
544
- # # object to check the status of an operation, cancel it, or wait
545
- # # for results. Here is how to block until completion:
541
+ # # The returned object is of type Gapic::Operation. You can use it to
542
+ # # check the status of an operation, cancel it, or wait for results.
543
+ # # Here is how to wait for a response.
546
544
  # result.wait_until_done! timeout: 60
547
545
  # if result.response?
548
546
  # p result.response
549
547
  # else
550
- # puts "Error!"
548
+ # puts "No response received."
551
549
  # end
552
550
  #
553
551
  def wait_operation request, options = nil