google-cloud-channel-v1 0.22.0 → 0.23.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.
@@ -26,6 +26,9 @@ module Google
26
26
  module Rest
27
27
  # Service that implements Longrunning Operations API.
28
28
  class Operations
29
+ # @private
30
+ DEFAULT_ENDPOINT_TEMPLATE = "cloudchannel.$UNIVERSE_DOMAIN$"
31
+
29
32
  # @private
30
33
  attr_reader :operations_stub
31
34
 
@@ -60,6 +63,15 @@ module Google
60
63
  @config
61
64
  end
62
65
 
66
+ ##
67
+ # The effective universe domain
68
+ #
69
+ # @return [String]
70
+ #
71
+ def universe_domain
72
+ @operations_stub.universe_domain
73
+ end
74
+
63
75
  ##
64
76
  # Create a new Operations client object.
65
77
  #
@@ -84,8 +96,10 @@ module Google
84
96
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
85
97
 
86
98
  @operations_stub = OperationsServiceStub.new(
87
- endpoint: @config.endpoint,
88
- credentials: credentials
99
+ endpoint: @config.endpoint,
100
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
101
+ universe_domain: @config.universe_domain,
102
+ credentials: credentials
89
103
  )
90
104
 
91
105
  # Used by an LRO wrapper for some methods of this service
@@ -478,9 +492,9 @@ module Google
478
492
  # end
479
493
  #
480
494
  # @!attribute [rw] endpoint
481
- # The hostname or hostname:port of the service endpoint.
482
- # Defaults to `"cloudchannel.googleapis.com"`.
483
- # @return [::String]
495
+ # A custom service endpoint, as a hostname or hostname:port. The default is
496
+ # nil, indicating to use the default endpoint in the current universe domain.
497
+ # @return [::String,nil]
484
498
  # @!attribute [rw] credentials
485
499
  # Credentials to send with calls. You may provide any of the following types:
486
500
  # * (`String`) The path to a service account key file in JSON format
@@ -517,13 +531,20 @@ module Google
517
531
  # @!attribute [rw] quota_project
518
532
  # A separate project against which to charge quota.
519
533
  # @return [::String]
534
+ # @!attribute [rw] universe_domain
535
+ # The universe domain within which to make requests. This determines the
536
+ # default endpoint URL. The default value of nil uses the environment
537
+ # universe (usually the default "googleapis.com" universe).
538
+ # @return [::String,nil]
520
539
  #
521
540
  class Configuration
522
541
  extend ::Gapic::Config
523
542
 
543
+ # @private
544
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
524
545
  DEFAULT_ENDPOINT = "cloudchannel.googleapis.com"
525
546
 
526
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
547
+ config_attr :endpoint, nil, ::String, nil
527
548
  config_attr :credentials, nil do |value|
528
549
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
529
550
  allowed.any? { |klass| klass === value }
@@ -535,6 +556,7 @@ module Google
535
556
  config_attr :metadata, nil, ::Hash, nil
536
557
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
537
558
  config_attr :quota_project, nil, ::String, nil
559
+ config_attr :universe_domain, nil, ::String, nil
538
560
 
539
561
  # @private
540
562
  def initialize parent_config = nil
@@ -617,12 +639,15 @@ module Google
617
639
  # Service stub contains baseline method implementations
618
640
  # including transcoding, making the REST call, and deserialing the response.
619
641
  class OperationsServiceStub
620
- def initialize endpoint:, credentials:
642
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
621
643
  # These require statements are intentionally placed here to initialize
622
644
  # the REST modules only when it's required.
623
645
  require "gapic/rest"
624
646
 
625
- @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials
647
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
648
+ endpoint_template: endpoint_template,
649
+ universe_domain: universe_domain,
650
+ credentials: credentials
626
651
  end
627
652
 
628
653
  ##
@@ -29,17 +29,30 @@ module Google
29
29
  # Service stub contains baseline method implementations
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
+ # @deprecated This service is deprecated and may be removed in the next major version update.
32
33
  class ServiceStub
33
- def initialize endpoint:, credentials:
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
37
38
 
38
- @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
39
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
40
+ endpoint_template: endpoint_template,
41
+ universe_domain: universe_domain,
42
+ credentials: credentials,
39
43
  numeric_enums: true,
40
44
  raise_faraday_errors: false
41
45
  end
42
46
 
47
+ ##
48
+ # The effective universe domain
49
+ #
50
+ # @return [String]
51
+ #
52
+ def universe_domain
53
+ @client_stub.universe_domain
54
+ end
55
+
43
56
  ##
44
57
  # Baseline implementation for the run_report_job REST call
45
58
  #
@@ -36,6 +36,11 @@ module Google
36
36
  # distributors retrieve and combine a variety of data in Cloud Channel for
37
37
  # multiple products (Google Cloud, Google Voice, and Google Workspace.)
38
38
  #
39
+ # Deprecated: This service is being deprecated. Please use [Export Channel
40
+ # Services data to
41
+ # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
42
+ # instead.
43
+ #
39
44
  # To load this service and instantiate a REST client:
40
45
  #
41
46
  # require "google/cloud/channel/v1/cloud_channel_reports_service/rest"
@@ -37,6 +37,13 @@ module Google
37
37
  # distributors retrieve and combine a variety of data in Cloud Channel for
38
38
  # multiple products (Google Cloud, Google Voice, and Google Workspace.)
39
39
  #
40
+ # Deprecated: This service is being deprecated. Please use [Export Channel
41
+ # Services data to
42
+ # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
43
+ # instead.
44
+ #
45
+ # @deprecated This service is deprecated and may be removed in the next major version update.
46
+ #
40
47
  # @example Load this service and instantiate a gRPC client
41
48
  #
42
49
  # require "google/cloud/channel/v1/cloud_channel_reports_service"
@@ -49,6 +49,9 @@ module Google
49
49
  # resellers in a channel.
50
50
  #
51
51
  class Client
52
+ # @private
53
+ DEFAULT_ENDPOINT_TEMPLATE = "cloudchannel.$UNIVERSE_DOMAIN$"
54
+
52
55
  include Paths
53
56
 
54
57
  # @private
@@ -136,6 +139,15 @@ module Google
136
139
  @config
137
140
  end
138
141
 
142
+ ##
143
+ # The effective universe domain
144
+ #
145
+ # @return [String]
146
+ #
147
+ def universe_domain
148
+ @cloud_channel_service_stub.universe_domain
149
+ end
150
+
139
151
  ##
140
152
  # Create a new CloudChannelService client object.
141
153
  #
@@ -169,8 +181,9 @@ module Google
169
181
  credentials = @config.credentials
170
182
  # Use self-signed JWT if the endpoint is unchanged from default,
171
183
  # but only if the default endpoint does not have a region prefix.
172
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
173
- !@config.endpoint.split(".").first.include?("-")
184
+ enable_self_signed_jwt = @config.endpoint.nil? ||
185
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
186
+ !@config.endpoint.split(".").first.include?("-"))
174
187
  credentials ||= Credentials.default scope: @config.scope,
175
188
  enable_self_signed_jwt: enable_self_signed_jwt
176
189
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -183,12 +196,15 @@ module Google
183
196
  config.credentials = credentials
184
197
  config.quota_project = @quota_project_id
185
198
  config.endpoint = @config.endpoint
199
+ config.universe_domain = @config.universe_domain
186
200
  end
187
201
 
188
202
  @cloud_channel_service_stub = ::Gapic::ServiceStub.new(
189
203
  ::Google::Cloud::Channel::V1::CloudChannelService::Stub,
190
- credentials: credentials,
191
- endpoint: @config.endpoint,
204
+ credentials: credentials,
205
+ endpoint: @config.endpoint,
206
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
207
+ universe_domain: @config.universe_domain,
192
208
  channel_args: @config.channel_args,
193
209
  interceptors: @config.interceptors,
194
210
  channel_pool_config: @config.channel_pool
@@ -6025,9 +6041,9 @@ module Google
6025
6041
  # end
6026
6042
  #
6027
6043
  # @!attribute [rw] endpoint
6028
- # The hostname or hostname:port of the service endpoint.
6029
- # Defaults to `"cloudchannel.googleapis.com"`.
6030
- # @return [::String]
6044
+ # A custom service endpoint, as a hostname or hostname:port. The default is
6045
+ # nil, indicating to use the default endpoint in the current universe domain.
6046
+ # @return [::String,nil]
6031
6047
  # @!attribute [rw] credentials
6032
6048
  # Credentials to send with calls. You may provide any of the following types:
6033
6049
  # * (`String`) The path to a service account key file in JSON format
@@ -6073,13 +6089,20 @@ module Google
6073
6089
  # @!attribute [rw] quota_project
6074
6090
  # A separate project against which to charge quota.
6075
6091
  # @return [::String]
6092
+ # @!attribute [rw] universe_domain
6093
+ # The universe domain within which to make requests. This determines the
6094
+ # default endpoint URL. The default value of nil uses the environment
6095
+ # universe (usually the default "googleapis.com" universe).
6096
+ # @return [::String,nil]
6076
6097
  #
6077
6098
  class Configuration
6078
6099
  extend ::Gapic::Config
6079
6100
 
6101
+ # @private
6102
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
6080
6103
  DEFAULT_ENDPOINT = "cloudchannel.googleapis.com"
6081
6104
 
6082
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
6105
+ config_attr :endpoint, nil, ::String, nil
6083
6106
  config_attr :credentials, nil do |value|
6084
6107
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
6085
6108
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -6094,6 +6117,7 @@ module Google
6094
6117
  config_attr :metadata, nil, ::Hash, nil
6095
6118
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
6096
6119
  config_attr :quota_project, nil, ::String, nil
6120
+ config_attr :universe_domain, nil, ::String, nil
6097
6121
 
6098
6122
  # @private
6099
6123
  def initialize parent_config = nil
@@ -26,6 +26,9 @@ module Google
26
26
  module CloudChannelService
27
27
  # Service that implements Longrunning Operations API.
28
28
  class Operations
29
+ # @private
30
+ DEFAULT_ENDPOINT_TEMPLATE = "cloudchannel.$UNIVERSE_DOMAIN$"
31
+
29
32
  # @private
30
33
  attr_reader :operations_stub
31
34
 
@@ -60,6 +63,15 @@ module Google
60
63
  @config
61
64
  end
62
65
 
66
+ ##
67
+ # The effective universe domain
68
+ #
69
+ # @return [String]
70
+ #
71
+ def universe_domain
72
+ @operations_stub.universe_domain
73
+ end
74
+
63
75
  ##
64
76
  # Create a new Operations client object.
65
77
  #
@@ -90,8 +102,10 @@ module Google
90
102
 
91
103
  @operations_stub = ::Gapic::ServiceStub.new(
92
104
  ::Google::Longrunning::Operations::Stub,
93
- credentials: credentials,
94
- endpoint: @config.endpoint,
105
+ credentials: credentials,
106
+ endpoint: @config.endpoint,
107
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
108
+ universe_domain: @config.universe_domain,
95
109
  channel_args: @config.channel_args,
96
110
  interceptors: @config.interceptors,
97
111
  channel_pool_config: @config.channel_pool
@@ -613,9 +627,9 @@ module Google
613
627
  # end
614
628
  #
615
629
  # @!attribute [rw] endpoint
616
- # The hostname or hostname:port of the service endpoint.
617
- # Defaults to `"cloudchannel.googleapis.com"`.
618
- # @return [::String]
630
+ # A custom service endpoint, as a hostname or hostname:port. The default is
631
+ # nil, indicating to use the default endpoint in the current universe domain.
632
+ # @return [::String,nil]
619
633
  # @!attribute [rw] credentials
620
634
  # Credentials to send with calls. You may provide any of the following types:
621
635
  # * (`String`) The path to a service account key file in JSON format
@@ -661,13 +675,20 @@ module Google
661
675
  # @!attribute [rw] quota_project
662
676
  # A separate project against which to charge quota.
663
677
  # @return [::String]
678
+ # @!attribute [rw] universe_domain
679
+ # The universe domain within which to make requests. This determines the
680
+ # default endpoint URL. The default value of nil uses the environment
681
+ # universe (usually the default "googleapis.com" universe).
682
+ # @return [::String,nil]
664
683
  #
665
684
  class Configuration
666
685
  extend ::Gapic::Config
667
686
 
687
+ # @private
688
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
668
689
  DEFAULT_ENDPOINT = "cloudchannel.googleapis.com"
669
690
 
670
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
691
+ config_attr :endpoint, nil, ::String, nil
671
692
  config_attr :credentials, nil do |value|
672
693
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
673
694
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -682,6 +703,7 @@ module Google
682
703
  config_attr :metadata, nil, ::Hash, nil
683
704
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
684
705
  config_attr :quota_project, nil, ::String, nil
706
+ config_attr :universe_domain, nil, ::String, nil
685
707
 
686
708
  # @private
687
709
  def initialize parent_config = nil
@@ -51,6 +51,9 @@ module Google
51
51
  # resellers in a channel.
52
52
  #
53
53
  class Client
54
+ # @private
55
+ DEFAULT_ENDPOINT_TEMPLATE = "cloudchannel.$UNIVERSE_DOMAIN$"
56
+
54
57
  include Paths
55
58
 
56
59
  # @private
@@ -138,6 +141,15 @@ module Google
138
141
  @config
139
142
  end
140
143
 
144
+ ##
145
+ # The effective universe domain
146
+ #
147
+ # @return [String]
148
+ #
149
+ def universe_domain
150
+ @cloud_channel_service_stub.universe_domain
151
+ end
152
+
141
153
  ##
142
154
  # Create a new CloudChannelService REST client object.
143
155
  #
@@ -165,8 +177,9 @@ module Google
165
177
  credentials = @config.credentials
166
178
  # Use self-signed JWT if the endpoint is unchanged from default,
167
179
  # but only if the default endpoint does not have a region prefix.
168
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
169
- !@config.endpoint.split(".").first.include?("-")
180
+ enable_self_signed_jwt = @config.endpoint.nil? ||
181
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
182
+ !@config.endpoint.split(".").first.include?("-"))
170
183
  credentials ||= Credentials.default scope: @config.scope,
171
184
  enable_self_signed_jwt: enable_self_signed_jwt
172
185
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -180,9 +193,15 @@ module Google
180
193
  config.credentials = credentials
181
194
  config.quota_project = @quota_project_id
182
195
  config.endpoint = @config.endpoint
196
+ config.universe_domain = @config.universe_domain
183
197
  end
184
198
 
185
- @cloud_channel_service_stub = ::Google::Cloud::Channel::V1::CloudChannelService::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
199
+ @cloud_channel_service_stub = ::Google::Cloud::Channel::V1::CloudChannelService::Rest::ServiceStub.new(
200
+ endpoint: @config.endpoint,
201
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
202
+ universe_domain: @config.universe_domain,
203
+ credentials: credentials
204
+ )
186
205
  end
187
206
 
188
207
  ##
@@ -5681,9 +5700,9 @@ module Google
5681
5700
  # end
5682
5701
  #
5683
5702
  # @!attribute [rw] endpoint
5684
- # The hostname or hostname:port of the service endpoint.
5685
- # Defaults to `"cloudchannel.googleapis.com"`.
5686
- # @return [::String]
5703
+ # A custom service endpoint, as a hostname or hostname:port. The default is
5704
+ # nil, indicating to use the default endpoint in the current universe domain.
5705
+ # @return [::String,nil]
5687
5706
  # @!attribute [rw] credentials
5688
5707
  # Credentials to send with calls. You may provide any of the following types:
5689
5708
  # * (`String`) The path to a service account key file in JSON format
@@ -5720,13 +5739,20 @@ module Google
5720
5739
  # @!attribute [rw] quota_project
5721
5740
  # A separate project against which to charge quota.
5722
5741
  # @return [::String]
5742
+ # @!attribute [rw] universe_domain
5743
+ # The universe domain within which to make requests. This determines the
5744
+ # default endpoint URL. The default value of nil uses the environment
5745
+ # universe (usually the default "googleapis.com" universe).
5746
+ # @return [::String,nil]
5723
5747
  #
5724
5748
  class Configuration
5725
5749
  extend ::Gapic::Config
5726
5750
 
5751
+ # @private
5752
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
5727
5753
  DEFAULT_ENDPOINT = "cloudchannel.googleapis.com"
5728
5754
 
5729
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
5755
+ config_attr :endpoint, nil, ::String, nil
5730
5756
  config_attr :credentials, nil do |value|
5731
5757
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
5732
5758
  allowed.any? { |klass| klass === value }
@@ -5738,6 +5764,7 @@ module Google
5738
5764
  config_attr :metadata, nil, ::Hash, nil
5739
5765
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
5740
5766
  config_attr :quota_project, nil, ::String, nil
5767
+ config_attr :universe_domain, nil, ::String, nil
5741
5768
 
5742
5769
  # @private
5743
5770
  def initialize parent_config = nil
@@ -26,6 +26,9 @@ module Google
26
26
  module Rest
27
27
  # Service that implements Longrunning Operations API.
28
28
  class Operations
29
+ # @private
30
+ DEFAULT_ENDPOINT_TEMPLATE = "cloudchannel.$UNIVERSE_DOMAIN$"
31
+
29
32
  # @private
30
33
  attr_reader :operations_stub
31
34
 
@@ -60,6 +63,15 @@ module Google
60
63
  @config
61
64
  end
62
65
 
66
+ ##
67
+ # The effective universe domain
68
+ #
69
+ # @return [String]
70
+ #
71
+ def universe_domain
72
+ @operations_stub.universe_domain
73
+ end
74
+
63
75
  ##
64
76
  # Create a new Operations client object.
65
77
  #
@@ -84,8 +96,10 @@ module Google
84
96
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
85
97
 
86
98
  @operations_stub = OperationsServiceStub.new(
87
- endpoint: @config.endpoint,
88
- credentials: credentials
99
+ endpoint: @config.endpoint,
100
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
101
+ universe_domain: @config.universe_domain,
102
+ credentials: credentials
89
103
  )
90
104
 
91
105
  # Used by an LRO wrapper for some methods of this service
@@ -478,9 +492,9 @@ module Google
478
492
  # end
479
493
  #
480
494
  # @!attribute [rw] endpoint
481
- # The hostname or hostname:port of the service endpoint.
482
- # Defaults to `"cloudchannel.googleapis.com"`.
483
- # @return [::String]
495
+ # A custom service endpoint, as a hostname or hostname:port. The default is
496
+ # nil, indicating to use the default endpoint in the current universe domain.
497
+ # @return [::String,nil]
484
498
  # @!attribute [rw] credentials
485
499
  # Credentials to send with calls. You may provide any of the following types:
486
500
  # * (`String`) The path to a service account key file in JSON format
@@ -517,13 +531,20 @@ module Google
517
531
  # @!attribute [rw] quota_project
518
532
  # A separate project against which to charge quota.
519
533
  # @return [::String]
534
+ # @!attribute [rw] universe_domain
535
+ # The universe domain within which to make requests. This determines the
536
+ # default endpoint URL. The default value of nil uses the environment
537
+ # universe (usually the default "googleapis.com" universe).
538
+ # @return [::String,nil]
520
539
  #
521
540
  class Configuration
522
541
  extend ::Gapic::Config
523
542
 
543
+ # @private
544
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
524
545
  DEFAULT_ENDPOINT = "cloudchannel.googleapis.com"
525
546
 
526
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
547
+ config_attr :endpoint, nil, ::String, nil
527
548
  config_attr :credentials, nil do |value|
528
549
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
529
550
  allowed.any? { |klass| klass === value }
@@ -535,6 +556,7 @@ module Google
535
556
  config_attr :metadata, nil, ::Hash, nil
536
557
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
537
558
  config_attr :quota_project, nil, ::String, nil
559
+ config_attr :universe_domain, nil, ::String, nil
538
560
 
539
561
  # @private
540
562
  def initialize parent_config = nil
@@ -617,12 +639,15 @@ module Google
617
639
  # Service stub contains baseline method implementations
618
640
  # including transcoding, making the REST call, and deserialing the response.
619
641
  class OperationsServiceStub
620
- def initialize endpoint:, credentials:
642
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
621
643
  # These require statements are intentionally placed here to initialize
622
644
  # the REST modules only when it's required.
623
645
  require "gapic/rest"
624
646
 
625
- @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials
647
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
648
+ endpoint_template: endpoint_template,
649
+ universe_domain: universe_domain,
650
+ credentials: credentials
626
651
  end
627
652
 
628
653
  ##
@@ -30,16 +30,28 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, credentials:
33
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
34
  # These require statements are intentionally placed here to initialize
35
35
  # the REST modules only when it's required.
36
36
  require "gapic/rest"
37
37
 
38
- @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
38
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
39
+ endpoint_template: endpoint_template,
40
+ universe_domain: universe_domain,
41
+ credentials: credentials,
39
42
  numeric_enums: true,
40
43
  raise_faraday_errors: false
41
44
  end
42
45
 
46
+ ##
47
+ # The effective universe domain
48
+ #
49
+ # @return [String]
50
+ #
51
+ def universe_domain
52
+ @client_stub.universe_domain
53
+ end
54
+
43
55
  ##
44
56
  # Baseline implementation for the list_customers REST call
45
57
  #
@@ -17,7 +17,7 @@ require 'google/type/decimal_pb'
17
17
  require 'google/type/money_pb'
18
18
 
19
19
 
20
- descriptor_data = "\n-google/cloud/channel/v1/reports_service.proto\x12\x17google.cloud.channel.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a(google/cloud/channel/v1/operations.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x16google/type/date.proto\x1a\x1agoogle/type/datetime.proto\x1a\x19google/type/decimal.proto\x1a\x17google/type/money.proto\"\xbd\x01\n\x13RunReportJobRequest\x12\x38\n\x04name\x18\x01 \x01(\tB*\xe0\x41\x02\xfa\x41$\n\"cloudchannel.googleapis.com/Report\x12;\n\ndate_range\x18\x02 \x01(\x0b\x32\".google.cloud.channel.v1.DateRangeB\x03\xe0\x41\x01\x12\x13\n\x06\x66ilter\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x1a\n\rlanguage_code\x18\x04 \x01(\tB\x03\xe0\x41\x01\"\x97\x01\n\x14RunReportJobResponse\x12\x36\n\nreport_job\x18\x01 \x01(\x0b\x32\".google.cloud.channel.v1.ReportJob\x12G\n\x0freport_metadata\x18\x02 \x01(\x0b\x32..google.cloud.channel.v1.ReportResultsMetadata\"\xac\x01\n\x19\x46\x65tchReportResultsRequest\x12\x41\n\nreport_job\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%cloudchannel.googleapis.com/ReportJob\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x1b\n\x0epartition_keys\x18\x04 \x03(\tB\x03\xe0\x41\x01\"\xaa\x01\n\x1a\x46\x65tchReportResultsResponse\x12G\n\x0freport_metadata\x18\x01 \x01(\x0b\x32..google.cloud.channel.v1.ReportResultsMetadata\x12*\n\x04rows\x18\x02 \x03(\x0b\x32\x1c.google.cloud.channel.v1.Row\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t\"v\n\x12ListReportsRequest\x12\x13\n\x06parent\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x1a\n\rlanguage_code\x18\x04 \x01(\tB\x03\xe0\x41\x01\"`\n\x13ListReportsResponse\x12\x30\n\x07reports\x18\x01 \x03(\x0b\x32\x1f.google.cloud.channel.v1.Report\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\xb4\x01\n\tReportJob\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12<\n\rreport_status\x18\x02 \x01(\x0b\x32%.google.cloud.channel.v1.ReportStatus:V\xea\x41S\n%cloudchannel.googleapis.com/ReportJob\x12*accounts/{account}/reportJobs/{report_job}\"\xd5\x01\n\x15ReportResultsMetadata\x12/\n\x06report\x18\x01 \x01(\x0b\x32\x1f.google.cloud.channel.v1.Report\x12\x11\n\trow_count\x18\x02 \x01(\x03\x12\x36\n\ndate_range\x18\x03 \x01(\x0b\x32\".google.cloud.channel.v1.DateRange\x12@\n\x14preceding_date_range\x18\x04 \x01(\x0b\x32\".google.cloud.channel.v1.DateRange\"\xdb\x01\n\x06\x43olumn\x12\x11\n\tcolumn_id\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12;\n\tdata_type\x18\x03 \x01(\x0e\x32(.google.cloud.channel.v1.Column.DataType\"k\n\x08\x44\x61taType\x12\x19\n\x15\x44\x41TA_TYPE_UNSPECIFIED\x10\x00\x12\n\n\x06STRING\x10\x01\x12\x07\n\x03INT\x10\x02\x12\x0b\n\x07\x44\x45\x43IMAL\x10\x03\x12\t\n\x05MONEY\x10\x04\x12\x08\n\x04\x44\x41TE\x10\x05\x12\r\n\tDATE_TIME\x10\x06\"\xd1\x01\n\tDateRange\x12\x34\n\x15usage_start_date_time\x18\x01 \x01(\x0b\x32\x15.google.type.DateTime\x12\x32\n\x13usage_end_date_time\x18\x02 \x01(\x0b\x32\x15.google.type.DateTime\x12-\n\x12invoice_start_date\x18\x03 \x01(\x0b\x32\x11.google.type.Date\x12+\n\x10invoice_end_date\x18\x04 \x01(\x0b\x32\x11.google.type.Date\"R\n\x03Row\x12\x34\n\x06values\x18\x01 \x03(\x0b\x32$.google.cloud.channel.v1.ReportValue\x12\x15\n\rpartition_key\x18\x02 \x01(\t\"\xf8\x01\n\x0bReportValue\x12\x16\n\x0cstring_value\x18\x01 \x01(\tH\x00\x12\x13\n\tint_value\x18\x02 \x01(\x03H\x00\x12-\n\rdecimal_value\x18\x03 \x01(\x0b\x32\x14.google.type.DecimalH\x00\x12)\n\x0bmoney_value\x18\x04 \x01(\x0b\x32\x12.google.type.MoneyH\x00\x12\'\n\ndate_value\x18\x05 \x01(\x0b\x32\x11.google.type.DateH\x00\x12\x30\n\x0f\x64\x61te_time_value\x18\x06 \x01(\x0b\x32\x15.google.type.DateTimeH\x00\x42\x07\n\x05value\"\xfd\x01\n\x0cReportStatus\x12:\n\x05state\x18\x01 \x01(\x0e\x32+.google.cloud.channel.v1.ReportStatus.State\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"S\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07STARTED\x10\x01\x12\x0b\n\x07WRITING\x10\x02\x12\r\n\tAVAILABLE\x10\x03\x12\n\n\x06\x46\x41ILED\x10\x04\"\xc6\x01\n\x06Report\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x30\n\x07\x63olumns\x18\x03 \x03(\x0b\x32\x1f.google.cloud.channel.v1.Column\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t:L\xea\x41I\n\"cloudchannel.googleapis.com/Report\x12#accounts/{account}/reports/{report}2\xa6\x05\n\x1a\x43loudChannelReportsService\x12\xb7\x01\n\x0cRunReportJob\x12,.google.cloud.channel.v1.RunReportJobRequest\x1a\x1d.google.longrunning.Operation\"Z\x82\xd3\xe4\x93\x02(\"#/v1/{name=accounts/*/reports/*}:run:\x01*\xca\x41)\n\x14RunReportJobResponse\x12\x11OperationMetadata\x12\xd2\x01\n\x12\x46\x65tchReportResults\x12\x32.google.cloud.channel.v1.FetchReportResultsRequest\x1a\x33.google.cloud.channel.v1.FetchReportResultsResponse\"S\x82\xd3\xe4\x93\x02@\";/v1/{report_job=accounts/*/reportJobs/*}:fetchReportResults:\x01*\xda\x41\nreport_job\x12\x9a\x01\n\x0bListReports\x12+.google.cloud.channel.v1.ListReportsRequest\x1a,.google.cloud.channel.v1.ListReportsResponse\"0\x82\xd3\xe4\x93\x02!\x12\x1f/v1/{parent=accounts/*}/reports\xda\x41\x06parent\x1a\\\xca\x41\x1b\x63loudchannel.googleapis.com\xd2\x41;https://www.googleapis.com/auth/apps.reports.usage.readonlyBk\n\x1b\x63om.google.cloud.channel.v1B\x13ReportsServiceProtoP\x01Z5cloud.google.com/go/channel/apiv1/channelpb;channelpbb\x06proto3"
20
+ descriptor_data = "\n-google/cloud/channel/v1/reports_service.proto\x12\x17google.cloud.channel.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a(google/cloud/channel/v1/operations.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x16google/type/date.proto\x1a\x1agoogle/type/datetime.proto\x1a\x19google/type/decimal.proto\x1a\x17google/type/money.proto\"\xc1\x01\n\x13RunReportJobRequest\x12\x38\n\x04name\x18\x01 \x01(\tB*\xe0\x41\x02\xfa\x41$\n\"cloudchannel.googleapis.com/Report\x12;\n\ndate_range\x18\x02 \x01(\x0b\x32\".google.cloud.channel.v1.DateRangeB\x03\xe0\x41\x01\x12\x13\n\x06\x66ilter\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x1a\n\rlanguage_code\x18\x04 \x01(\tB\x03\xe0\x41\x01:\x02\x18\x01\"\x9b\x01\n\x14RunReportJobResponse\x12\x36\n\nreport_job\x18\x01 \x01(\x0b\x32\".google.cloud.channel.v1.ReportJob\x12G\n\x0freport_metadata\x18\x02 \x01(\x0b\x32..google.cloud.channel.v1.ReportResultsMetadata:\x02\x18\x01\"\xb0\x01\n\x19\x46\x65tchReportResultsRequest\x12\x41\n\nreport_job\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%cloudchannel.googleapis.com/ReportJob\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x1b\n\x0epartition_keys\x18\x04 \x03(\tB\x03\xe0\x41\x01:\x02\x18\x01\"\xae\x01\n\x1a\x46\x65tchReportResultsResponse\x12G\n\x0freport_metadata\x18\x01 \x01(\x0b\x32..google.cloud.channel.v1.ReportResultsMetadata\x12*\n\x04rows\x18\x02 \x03(\x0b\x32\x1c.google.cloud.channel.v1.Row\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t:\x02\x18\x01\"z\n\x12ListReportsRequest\x12\x13\n\x06parent\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x1a\n\rlanguage_code\x18\x04 \x01(\tB\x03\xe0\x41\x01:\x02\x18\x01\"d\n\x13ListReportsResponse\x12\x30\n\x07reports\x18\x01 \x03(\x0b\x32\x1f.google.cloud.channel.v1.Report\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t:\x02\x18\x01\"\xb6\x01\n\tReportJob\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12<\n\rreport_status\x18\x02 \x01(\x0b\x32%.google.cloud.channel.v1.ReportStatus:X\x18\x01\xea\x41S\n%cloudchannel.googleapis.com/ReportJob\x12*accounts/{account}/reportJobs/{report_job}\"\xd9\x01\n\x15ReportResultsMetadata\x12/\n\x06report\x18\x01 \x01(\x0b\x32\x1f.google.cloud.channel.v1.Report\x12\x11\n\trow_count\x18\x02 \x01(\x03\x12\x36\n\ndate_range\x18\x03 \x01(\x0b\x32\".google.cloud.channel.v1.DateRange\x12@\n\x14preceding_date_range\x18\x04 \x01(\x0b\x32\".google.cloud.channel.v1.DateRange:\x02\x18\x01\"\xdf\x01\n\x06\x43olumn\x12\x11\n\tcolumn_id\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12;\n\tdata_type\x18\x03 \x01(\x0e\x32(.google.cloud.channel.v1.Column.DataType\"k\n\x08\x44\x61taType\x12\x19\n\x15\x44\x41TA_TYPE_UNSPECIFIED\x10\x00\x12\n\n\x06STRING\x10\x01\x12\x07\n\x03INT\x10\x02\x12\x0b\n\x07\x44\x45\x43IMAL\x10\x03\x12\t\n\x05MONEY\x10\x04\x12\x08\n\x04\x44\x41TE\x10\x05\x12\r\n\tDATE_TIME\x10\x06:\x02\x18\x01\"\xd5\x01\n\tDateRange\x12\x34\n\x15usage_start_date_time\x18\x01 \x01(\x0b\x32\x15.google.type.DateTime\x12\x32\n\x13usage_end_date_time\x18\x02 \x01(\x0b\x32\x15.google.type.DateTime\x12-\n\x12invoice_start_date\x18\x03 \x01(\x0b\x32\x11.google.type.Date\x12+\n\x10invoice_end_date\x18\x04 \x01(\x0b\x32\x11.google.type.Date:\x02\x18\x01\"V\n\x03Row\x12\x34\n\x06values\x18\x01 \x03(\x0b\x32$.google.cloud.channel.v1.ReportValue\x12\x15\n\rpartition_key\x18\x02 \x01(\t:\x02\x18\x01\"\xfc\x01\n\x0bReportValue\x12\x16\n\x0cstring_value\x18\x01 \x01(\tH\x00\x12\x13\n\tint_value\x18\x02 \x01(\x03H\x00\x12-\n\rdecimal_value\x18\x03 \x01(\x0b\x32\x14.google.type.DecimalH\x00\x12)\n\x0bmoney_value\x18\x04 \x01(\x0b\x32\x12.google.type.MoneyH\x00\x12\'\n\ndate_value\x18\x05 \x01(\x0b\x32\x11.google.type.DateH\x00\x12\x30\n\x0f\x64\x61te_time_value\x18\x06 \x01(\x0b\x32\x15.google.type.DateTimeH\x00:\x02\x18\x01\x42\x07\n\x05value\"\x81\x02\n\x0cReportStatus\x12:\n\x05state\x18\x01 \x01(\x0e\x32+.google.cloud.channel.v1.ReportStatus.State\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"S\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07STARTED\x10\x01\x12\x0b\n\x07WRITING\x10\x02\x12\r\n\tAVAILABLE\x10\x03\x12\n\n\x06\x46\x41ILED\x10\x04:\x02\x18\x01\"\xc8\x01\n\x06Report\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x30\n\x07\x63olumns\x18\x03 \x03(\x0b\x32\x1f.google.cloud.channel.v1.Column\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t:N\x18\x01\xea\x41I\n\"cloudchannel.googleapis.com/Report\x12#accounts/{account}/reports/{report}2\xb2\x05\n\x1a\x43loudChannelReportsService\x12\xba\x01\n\x0cRunReportJob\x12,.google.cloud.channel.v1.RunReportJobRequest\x1a\x1d.google.longrunning.Operation\"]\x88\x02\x01\x82\xd3\xe4\x93\x02(\"#/v1/{name=accounts/*/reports/*}:run:\x01*\xca\x41)\n\x14RunReportJobResponse\x12\x11OperationMetadata\x12\xd5\x01\n\x12\x46\x65tchReportResults\x12\x32.google.cloud.channel.v1.FetchReportResultsRequest\x1a\x33.google.cloud.channel.v1.FetchReportResultsResponse\"V\x88\x02\x01\x82\xd3\xe4\x93\x02@\";/v1/{report_job=accounts/*/reportJobs/*}:fetchReportResults:\x01*\xda\x41\nreport_job\x12\x9d\x01\n\x0bListReports\x12+.google.cloud.channel.v1.ListReportsRequest\x1a,.google.cloud.channel.v1.ListReportsResponse\"3\x88\x02\x01\x82\xd3\xe4\x93\x02!\x12\x1f/v1/{parent=accounts/*}/reports\xda\x41\x06parent\x1a_\x88\x02\x01\xca\x41\x1b\x63loudchannel.googleapis.com\xd2\x41;https://www.googleapis.com/auth/apps.reports.usage.readonlyBk\n\x1b\x63om.google.cloud.channel.v1B\x13ReportsServiceProtoP\x01Z5cloud.google.com/go/channel/apiv1/channelpb;channelpbb\x06proto3"
21
21
 
22
22
  pool = Google::Protobuf::DescriptorPool.generated_pool
23
23
 
@@ -27,6 +27,11 @@ module Google
27
27
  # CloudChannelReportsService lets Google Cloud resellers and
28
28
  # distributors retrieve and combine a variety of data in Cloud Channel for
29
29
  # multiple products (Google Cloud, Google Voice, and Google Workspace.)
30
+ #
31
+ # Deprecated: This service is being deprecated. Please use [Export Channel
32
+ # Services data to
33
+ # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
34
+ # instead.
30
35
  class Service
31
36
 
32
37
  include ::GRPC::GenericService
@@ -60,12 +65,24 @@ module Google
60
65
  # [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults]
61
66
  # with the
62
67
  # [RunReportJobResponse.report_job][google.cloud.channel.v1.RunReportJobResponse.report_job].
68
+ #
69
+ # Deprecated: Please use [Export Channel Services data to
70
+ # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
71
+ # instead.
63
72
  rpc :RunReportJob, ::Google::Cloud::Channel::V1::RunReportJobRequest, ::Google::Longrunning::Operation
64
73
  # Retrieves data generated by
65
74
  # [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob].
75
+ #
76
+ # Deprecated: Please use [Export Channel Services data to
77
+ # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
78
+ # instead.
66
79
  rpc :FetchReportResults, ::Google::Cloud::Channel::V1::FetchReportResultsRequest, ::Google::Cloud::Channel::V1::FetchReportResultsResponse
67
80
  # Lists the reports that RunReportJob can run. These reports include an ID,
68
81
  # a description, and the list of columns that will be in the result.
82
+ #
83
+ # Deprecated: Please use [Export Channel Services data to
84
+ # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
85
+ # instead.
69
86
  rpc :ListReports, ::Google::Cloud::Channel::V1::ListReportsRequest, ::Google::Cloud::Channel::V1::ListReportsResponse
70
87
  end
71
88
 
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Channel
23
23
  module V1
24
- VERSION = "0.22.0"
24
+ VERSION = "0.23.0"
25
25
  end
26
26
  end
27
27
  end