google-cloud-essential_contacts-v1 1.0.1 → 1.1.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: ab0393e11a591658ec840d5d771ce6a2d08e294b27041cda2044e85f857085d9
4
- data.tar.gz: 31f837db9683fc20ec0006d9f3077cd014930fd8a5dbcf76531c5f0a87f8d628
3
+ metadata.gz: '093d1ec238ae0c094b8bbfc65b7abd16e053c0f727ed2df9af2941ccadd3fe3b'
4
+ data.tar.gz: f0d347324c43e57bf3f0d8b3c362936484862ae0d277c2446adb24484f44939b
5
5
  SHA512:
6
- metadata.gz: a23d4677b86e2f4adc384807a417bbecd98e9e1afdc1f01cf47c849e895133773a414f3d146433729428f574fee5060eabb5e232af6456e179d803478a1bebd0
7
- data.tar.gz: 40ff27d9be448a2ccaecaed9c0ca1f522482b86e8004af9cc3a9b4f50cc885e1d1c9531dc401c869e1507158aecdd0e8487a709a29961d0f4f5ba21a4c18b40c
6
+ metadata.gz: 8837d15afd44072206f85da8e1a9f2fc7c7d28d29a9fb5b20c68f7e607f474c08c289d02218c927d0c0b936a81b4ab833f359dd6af41caf8ef0e0c18a59da681
7
+ data.tar.gz: 27aa25de5bc8c6d53fd39012d8bfcbfaacf5e51594c4b8aebdfe57e756c78f5a357c29bef2d0aa343af6283fb93b856f44fc91bbcb27c69cdd71ff6e821458b2
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/resource-manager/docs/managing-notification-contacts/)
44
44
  for general usage information.
45
45
 
46
- ## Enabling Logging
47
-
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/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
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
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
-
54
- Configuring a Ruby stdlib logger:
46
+ ## Debug Logging
47
+
48
+ This library comes with opt-in Debug Logging that can help you troubleshoot
49
+ your application's integration with the API. When logging is activated, key
50
+ events such as requests and responses, along with data payloads and metadata
51
+ such as headers and client configuration, are logged to the standard error
52
+ stream.
53
+
54
+ **WARNING:** Client Library Debug Logging includes your data payloads in
55
+ plaintext, which could include sensitive data such as PII for yourself or your
56
+ customers, private keys, or other security data that could be compromising if
57
+ leaked. Always practice good data hygiene with your application logs, and follow
58
+ the principle of least access. Google also recommends that Client Library Debug
59
+ Logging be enabled only temporarily during active debugging, and not used
60
+ permanently in production.
61
+
62
+ To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
63
+ to the value `all`. Alternatively, you can set the value to a comma-delimited
64
+ list of client library gem names. This will select the default logging behavior,
65
+ which writes logs to the standard error stream. On a local workstation, this may
66
+ result in logs appearing on the console. When running on a Google Cloud hosting
67
+ service such as [Google Cloud Run](https://cloud.google.com/run), this generally
68
+ results in logs appearing alongside your application logs in the
69
+ [Google Cloud Logging](https://cloud.google.com/logging/) service.
70
+
71
+ You can customize logging by modifying the `logger` configuration when
72
+ constructing a client object. For example:
55
73
 
56
74
  ```ruby
75
+ require "google/cloud/essential_contacts/v1"
57
76
  require "logger"
58
77
 
59
- module MyLogger
60
- LOGGER = Logger.new $stderr, level: Logger::WARN
61
- def logger
62
- LOGGER
63
- end
64
- end
65
-
66
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
67
- module GRPC
68
- extend MyLogger
78
+ client = ::Google::Cloud::EssentialContacts::V1::EssentialContactsService::Client.new do |config|
79
+ config.logger = Logger.new "my-app.log"
69
80
  end
70
81
  ```
71
82
 
72
-
73
83
  ## Google Cloud Samples
74
84
 
75
85
  To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
@@ -177,8 +177,28 @@ module Google
177
177
  universe_domain: @config.universe_domain,
178
178
  channel_args: @config.channel_args,
179
179
  interceptors: @config.interceptors,
180
- channel_pool_config: @config.channel_pool
180
+ channel_pool_config: @config.channel_pool,
181
+ logger: @config.logger
181
182
  )
183
+
184
+ @essential_contacts_service_stub.stub_logger&.info do |entry|
185
+ entry.set_system_name
186
+ entry.set_service
187
+ entry.message = "Created client for #{entry.service}"
188
+ entry.set_credentials_fields credentials
189
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
190
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
191
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
192
+ end
193
+ end
194
+
195
+ ##
196
+ # The logger used for request/response debug logging.
197
+ #
198
+ # @return [Logger]
199
+ #
200
+ def logger
201
+ @essential_contacts_service_stub.logger
182
202
  end
183
203
 
184
204
  # Service calls
@@ -268,7 +288,6 @@ module Google
268
288
 
269
289
  @essential_contacts_service_stub.call_rpc :create_contact, request, options: options do |response, operation|
270
290
  yield response, operation if block_given?
271
- return response
272
291
  end
273
292
  rescue ::GRPC::BadStatus => e
274
293
  raise ::Google::Cloud::Error.from_error(e)
@@ -360,7 +379,6 @@ module Google
360
379
 
361
380
  @essential_contacts_service_stub.call_rpc :update_contact, request, options: options do |response, operation|
362
381
  yield response, operation if block_given?
363
- return response
364
382
  end
365
383
  rescue ::GRPC::BadStatus => e
366
384
  raise ::Google::Cloud::Error.from_error(e)
@@ -463,7 +481,7 @@ module Google
463
481
  @essential_contacts_service_stub.call_rpc :list_contacts, request, options: options do |response, operation|
464
482
  response = ::Gapic::PagedEnumerable.new @essential_contacts_service_stub, :list_contacts, request, response, operation, options
465
483
  yield response, operation if block_given?
466
- return response
484
+ throw :response, response
467
485
  end
468
486
  rescue ::GRPC::BadStatus => e
469
487
  raise ::Google::Cloud::Error.from_error(e)
@@ -552,7 +570,6 @@ module Google
552
570
 
553
571
  @essential_contacts_service_stub.call_rpc :get_contact, request, options: options do |response, operation|
554
572
  yield response, operation if block_given?
555
- return response
556
573
  end
557
574
  rescue ::GRPC::BadStatus => e
558
575
  raise ::Google::Cloud::Error.from_error(e)
@@ -641,7 +658,6 @@ module Google
641
658
 
642
659
  @essential_contacts_service_stub.call_rpc :delete_contact, request, options: options do |response, operation|
643
660
  yield response, operation if block_given?
644
- return response
645
661
  end
646
662
  rescue ::GRPC::BadStatus => e
647
663
  raise ::Google::Cloud::Error.from_error(e)
@@ -750,7 +766,7 @@ module Google
750
766
  @essential_contacts_service_stub.call_rpc :compute_contacts, request, options: options do |response, operation|
751
767
  response = ::Gapic::PagedEnumerable.new @essential_contacts_service_stub, :compute_contacts, request, response, operation, options
752
768
  yield response, operation if block_given?
753
- return response
769
+ throw :response, response
754
770
  end
755
771
  rescue ::GRPC::BadStatus => e
756
772
  raise ::Google::Cloud::Error.from_error(e)
@@ -849,7 +865,6 @@ module Google
849
865
 
850
866
  @essential_contacts_service_stub.call_rpc :send_test_message, request, options: options do |response, operation|
851
867
  yield response, operation if block_given?
852
- return response
853
868
  end
854
869
  rescue ::GRPC::BadStatus => e
855
870
  raise ::Google::Cloud::Error.from_error(e)
@@ -938,6 +953,11 @@ module Google
938
953
  # default endpoint URL. The default value of nil uses the environment
939
954
  # universe (usually the default "googleapis.com" universe).
940
955
  # @return [::String,nil]
956
+ # @!attribute [rw] logger
957
+ # A custom logger to use for request/response debug logging, or the value
958
+ # `:default` (the default) to construct a default logger, or `nil` to
959
+ # explicitly disable logging.
960
+ # @return [::Logger,:default,nil]
941
961
  #
942
962
  class Configuration
943
963
  extend ::Gapic::Config
@@ -962,6 +982,7 @@ module Google
962
982
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
963
983
  config_attr :quota_project, nil, ::String, nil
964
984
  config_attr :universe_domain, nil, ::String, nil
985
+ config_attr :logger, :default, ::Logger, nil, :default
965
986
 
966
987
  # @private
967
988
  def initialize parent_config = nil
@@ -170,8 +170,28 @@ module Google
170
170
  endpoint: @config.endpoint,
171
171
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
172
172
  universe_domain: @config.universe_domain,
173
- credentials: credentials
173
+ credentials: credentials,
174
+ logger: @config.logger
174
175
  )
176
+
177
+ @essential_contacts_service_stub.logger(stub: true)&.info do |entry|
178
+ entry.set_system_name
179
+ entry.set_service
180
+ entry.message = "Created client for #{entry.service}"
181
+ entry.set_credentials_fields credentials
182
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
183
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
184
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
185
+ end
186
+ end
187
+
188
+ ##
189
+ # The logger used for request/response debug logging.
190
+ #
191
+ # @return [Logger]
192
+ #
193
+ def logger
194
+ @essential_contacts_service_stub.logger
175
195
  end
176
196
 
177
197
  # Service calls
@@ -254,7 +274,6 @@ module Google
254
274
 
255
275
  @essential_contacts_service_stub.create_contact request, options do |result, operation|
256
276
  yield result, operation if block_given?
257
- return result
258
277
  end
259
278
  rescue ::Gapic::Rest::Error => e
260
279
  raise ::Google::Cloud::Error.from_error(e)
@@ -339,7 +358,6 @@ module Google
339
358
 
340
359
  @essential_contacts_service_stub.update_contact request, options do |result, operation|
341
360
  yield result, operation if block_given?
342
- return result
343
361
  end
344
362
  rescue ::Gapic::Rest::Error => e
345
363
  raise ::Google::Cloud::Error.from_error(e)
@@ -435,7 +453,7 @@ module Google
435
453
  @essential_contacts_service_stub.list_contacts request, options do |result, operation|
436
454
  result = ::Gapic::Rest::PagedEnumerable.new @essential_contacts_service_stub, :list_contacts, "contacts", request, result, options
437
455
  yield result, operation if block_given?
438
- return result
456
+ throw :response, result
439
457
  end
440
458
  rescue ::Gapic::Rest::Error => e
441
459
  raise ::Google::Cloud::Error.from_error(e)
@@ -517,7 +535,6 @@ module Google
517
535
 
518
536
  @essential_contacts_service_stub.get_contact request, options do |result, operation|
519
537
  yield result, operation if block_given?
520
- return result
521
538
  end
522
539
  rescue ::Gapic::Rest::Error => e
523
540
  raise ::Google::Cloud::Error.from_error(e)
@@ -599,7 +616,6 @@ module Google
599
616
 
600
617
  @essential_contacts_service_stub.delete_contact request, options do |result, operation|
601
618
  yield result, operation if block_given?
602
- return result
603
619
  end
604
620
  rescue ::Gapic::Rest::Error => e
605
621
  raise ::Google::Cloud::Error.from_error(e)
@@ -701,7 +717,7 @@ module Google
701
717
  @essential_contacts_service_stub.compute_contacts request, options do |result, operation|
702
718
  result = ::Gapic::Rest::PagedEnumerable.new @essential_contacts_service_stub, :compute_contacts, "contacts", request, result, options
703
719
  yield result, operation if block_given?
704
- return result
720
+ throw :response, result
705
721
  end
706
722
  rescue ::Gapic::Rest::Error => e
707
723
  raise ::Google::Cloud::Error.from_error(e)
@@ -793,7 +809,6 @@ module Google
793
809
 
794
810
  @essential_contacts_service_stub.send_test_message request, options do |result, operation|
795
811
  yield result, operation if block_given?
796
- return result
797
812
  end
798
813
  rescue ::Gapic::Rest::Error => e
799
814
  raise ::Google::Cloud::Error.from_error(e)
@@ -873,6 +888,11 @@ module Google
873
888
  # default endpoint URL. The default value of nil uses the environment
874
889
  # universe (usually the default "googleapis.com" universe).
875
890
  # @return [::String,nil]
891
+ # @!attribute [rw] logger
892
+ # A custom logger to use for request/response debug logging, or the value
893
+ # `:default` (the default) to construct a default logger, or `nil` to
894
+ # explicitly disable logging.
895
+ # @return [::Logger,:default,nil]
876
896
  #
877
897
  class Configuration
878
898
  extend ::Gapic::Config
@@ -894,6 +914,7 @@ module Google
894
914
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
895
915
  config_attr :quota_project, nil, ::String, nil
896
916
  config_attr :universe_domain, nil, ::String, nil
917
+ config_attr :logger, :default, ::Logger, nil, :default
897
918
 
898
919
  # @private
899
920
  def initialize parent_config = nil
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
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"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the create_contact REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "create_contact",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::EssentialContacts::V1::Contact.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -125,16 +139,18 @@ module Google
125
139
 
126
140
  response = @client_stub.make_http_request(
127
141
  verb,
128
- uri: uri,
129
- body: body || "",
130
- params: query_string_params,
142
+ uri: uri,
143
+ body: body || "",
144
+ params: query_string_params,
145
+ method_name: "update_contact",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::EssentialContacts::V1::Contact.decode_json response.body, ignore_unknown_fields: true
135
-
136
- yield result, operation if block_given?
137
- result
150
+ catch :response do
151
+ yield result, operation if block_given?
152
+ result
153
+ end
138
154
  end
139
155
 
140
156
  ##
@@ -163,16 +179,18 @@ module Google
163
179
 
164
180
  response = @client_stub.make_http_request(
165
181
  verb,
166
- uri: uri,
167
- body: body || "",
168
- params: query_string_params,
182
+ uri: uri,
183
+ body: body || "",
184
+ params: query_string_params,
185
+ method_name: "list_contacts",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Cloud::EssentialContacts::V1::ListContactsResponse.decode_json response.body, ignore_unknown_fields: true
173
-
174
- yield result, operation if block_given?
175
- result
190
+ catch :response do
191
+ yield result, operation if block_given?
192
+ result
193
+ end
176
194
  end
177
195
 
178
196
  ##
@@ -201,16 +219,18 @@ module Google
201
219
 
202
220
  response = @client_stub.make_http_request(
203
221
  verb,
204
- uri: uri,
205
- body: body || "",
206
- params: query_string_params,
222
+ uri: uri,
223
+ body: body || "",
224
+ params: query_string_params,
225
+ method_name: "get_contact",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Cloud::EssentialContacts::V1::Contact.decode_json response.body, ignore_unknown_fields: true
211
-
212
- yield result, operation if block_given?
213
- result
230
+ catch :response do
231
+ yield result, operation if block_given?
232
+ result
233
+ end
214
234
  end
215
235
 
216
236
  ##
@@ -239,16 +259,18 @@ module Google
239
259
 
240
260
  response = @client_stub.make_http_request(
241
261
  verb,
242
- uri: uri,
243
- body: body || "",
244
- params: query_string_params,
262
+ uri: uri,
263
+ body: body || "",
264
+ params: query_string_params,
265
+ method_name: "delete_contact",
245
266
  options: options
246
267
  )
247
268
  operation = ::Gapic::Rest::TransportOperation.new response
248
269
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
249
-
250
- yield result, operation if block_given?
251
- result
270
+ catch :response do
271
+ yield result, operation if block_given?
272
+ result
273
+ end
252
274
  end
253
275
 
254
276
  ##
@@ -277,16 +299,18 @@ module Google
277
299
 
278
300
  response = @client_stub.make_http_request(
279
301
  verb,
280
- uri: uri,
281
- body: body || "",
282
- params: query_string_params,
302
+ uri: uri,
303
+ body: body || "",
304
+ params: query_string_params,
305
+ method_name: "compute_contacts",
283
306
  options: options
284
307
  )
285
308
  operation = ::Gapic::Rest::TransportOperation.new response
286
309
  result = ::Google::Cloud::EssentialContacts::V1::ComputeContactsResponse.decode_json response.body, ignore_unknown_fields: true
287
-
288
- yield result, operation if block_given?
289
- result
310
+ catch :response do
311
+ yield result, operation if block_given?
312
+ result
313
+ end
290
314
  end
291
315
 
292
316
  ##
@@ -315,16 +339,18 @@ module Google
315
339
 
316
340
  response = @client_stub.make_http_request(
317
341
  verb,
318
- uri: uri,
319
- body: body || "",
320
- params: query_string_params,
342
+ uri: uri,
343
+ body: body || "",
344
+ params: query_string_params,
345
+ method_name: "send_test_message",
321
346
  options: options
322
347
  )
323
348
  operation = ::Gapic::Rest::TransportOperation.new response
324
349
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
325
-
326
- yield result, operation if block_given?
327
- result
350
+ catch :response do
351
+ yield result, operation if block_given?
352
+ result
353
+ end
328
354
  end
329
355
 
330
356
  ##
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module EssentialContacts
23
23
  module V1
24
- VERSION = "1.0.1"
24
+ VERSION = "1.1.0"
25
25
  end
26
26
  end
27
27
  end
@@ -14,7 +14,7 @@ require 'google/protobuf/field_mask_pb'
14
14
  require 'google/protobuf/timestamp_pb'
15
15
 
16
16
 
17
- descriptor_data = "\n/google/cloud/essentialcontacts/v1/service.proto\x12!google.cloud.essentialcontacts.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/essentialcontacts/v1/enums.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xe5\x03\n\x07\x43ontact\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12\x12\n\x05\x65mail\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12i\n#notification_category_subscriptions\x18\x03 \x03(\x0e\x32\x37.google.cloud.essentialcontacts.v1.NotificationCategoryB\x03\xe0\x41\x02\x12\x19\n\x0clanguage_tag\x18\x04 \x01(\tB\x03\xe0\x41\x02\x12L\n\x10validation_state\x18\x08 \x01(\x0e\x32\x32.google.cloud.essentialcontacts.v1.ValidationState\x12\x31\n\rvalidate_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp:\xab\x01\xea\x41\xa7\x01\n(essentialcontacts.googleapis.com/Contact\x12%projects/{project}/contacts/{contact}\x12#folders/{folder}/contacts/{contact}\x12/organizations/{organization}/contacts/{contact}\"\x88\x01\n\x13ListContactsRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\x12(essentialcontacts.googleapis.com/Contact\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\"m\n\x14ListContactsResponse\x12<\n\x08\x63ontacts\x18\x01 \x03(\x0b\x32*.google.cloud.essentialcontacts.v1.Contact\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"S\n\x11GetContactRequest\x12>\n\x04name\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(essentialcontacts.googleapis.com/Contact\"V\n\x14\x44\x65leteContactRequest\x12>\n\x04name\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(essentialcontacts.googleapis.com/Contact\"\x9a\x01\n\x14\x43reateContactRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\x12(essentialcontacts.googleapis.com/Contact\x12@\n\x07\x63ontact\x18\x02 \x01(\x0b\x32*.google.cloud.essentialcontacts.v1.ContactB\x03\xe0\x41\x02\"\x8e\x01\n\x14UpdateContactRequest\x12@\n\x07\x63ontact\x18\x02 \x01(\x0b\x32*.google.cloud.essentialcontacts.v1.ContactB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x01\"\xe5\x01\n\x16\x43omputeContactsRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\x12(essentialcontacts.googleapis.com/Contact\x12X\n\x17notification_categories\x18\x06 \x03(\x0e\x32\x37.google.cloud.essentialcontacts.v1.NotificationCategory\x12\x16\n\tpage_size\x18\x03 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x04 \x01(\tB\x03\xe0\x41\x01\"p\n\x17\x43omputeContactsResponse\x12<\n\x08\x63ontacts\x18\x01 \x03(\x0b\x32*.google.cloud.essentialcontacts.v1.Contact\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\xfd\x01\n\x16SendTestMessageRequest\x12\x42\n\x08\x63ontacts\x18\x01 \x03(\tB0\xe0\x41\x02\xfa\x41*\n(essentialcontacts.googleapis.com/Contact\x12\x42\n\x08resource\x18\x02 \x01(\tB0\xe0\x41\x02\xfa\x41*\x12(essentialcontacts.googleapis.com/Contact\x12[\n\x15notification_category\x18\x03 \x01(\x0e\x32\x37.google.cloud.essentialcontacts.v1.NotificationCategoryB\x03\xe0\x41\x02\x32\xcb\x0f\n\x18\x45ssentialContactsService\x12\x98\x02\n\rCreateContact\x12\x37.google.cloud.essentialcontacts.v1.CreateContactRequest\x1a*.google.cloud.essentialcontacts.v1.Contact\"\xa1\x01\xda\x41\x0eparent,contact\x82\xd3\xe4\x93\x02\x89\x01\" /v1/{parent=projects/*}/contacts:\x07\x63ontactZ*\"\x1f/v1/{parent=folders/*}/contacts:\x07\x63ontactZ0\"%/v1/{parent=organizations/*}/contacts:\x07\x63ontact\x12\xb5\x02\n\rUpdateContact\x12\x37.google.cloud.essentialcontacts.v1.UpdateContactRequest\x1a*.google.cloud.essentialcontacts.v1.Contact\"\xbe\x01\xda\x41\x13\x63ontact,update_mask\x82\xd3\xe4\x93\x02\xa1\x01\x32(/v1/{contact.name=projects/*/contacts/*}:\x07\x63ontactZ22\'/v1/{contact.name=folders/*/contacts/*}:\x07\x63ontactZ82-/v1/{contact.name=organizations/*/contacts/*}:\x07\x63ontact\x12\xfe\x01\n\x0cListContacts\x12\x36.google.cloud.essentialcontacts.v1.ListContactsRequest\x1a\x37.google.cloud.essentialcontacts.v1.ListContactsResponse\"}\xda\x41\x06parent\x82\xd3\xe4\x93\x02n\x12 /v1/{parent=projects/*}/contactsZ!\x12\x1f/v1/{parent=folders/*}/contactsZ\'\x12%/v1/{parent=organizations/*}/contacts\x12\xeb\x01\n\nGetContact\x12\x34.google.cloud.essentialcontacts.v1.GetContactRequest\x1a*.google.cloud.essentialcontacts.v1.Contact\"{\xda\x41\x04name\x82\xd3\xe4\x93\x02n\x12 /v1/{name=projects/*/contacts/*}Z!\x12\x1f/v1/{name=folders/*/contacts/*}Z\'\x12%/v1/{name=organizations/*/contacts/*}\x12\xdd\x01\n\rDeleteContact\x12\x37.google.cloud.essentialcontacts.v1.DeleteContactRequest\x1a\x16.google.protobuf.Empty\"{\xda\x41\x04name\x82\xd3\xe4\x93\x02n* /v1/{name=projects/*/contacts/*}Z!*\x1f/v1/{name=folders/*/contacts/*}Z\'*%/v1/{name=organizations/*/contacts/*}\x12\x98\x02\n\x0f\x43omputeContacts\x12\x39.google.cloud.essentialcontacts.v1.ComputeContactsRequest\x1a:.google.cloud.essentialcontacts.v1.ComputeContactsResponse\"\x8d\x01\x82\xd3\xe4\x93\x02\x86\x01\x12(/v1/{parent=projects/*}/contacts:computeZ)\x12\'/v1/{parent=folders/*}/contacts:computeZ/\x12-/v1/{parent=organizations/*}/contacts:compute\x12\x9b\x02\n\x0fSendTestMessage\x12\x39.google.cloud.essentialcontacts.v1.SendTestMessageRequest\x1a\x16.google.protobuf.Empty\"\xb4\x01\x82\xd3\xe4\x93\x02\xad\x01\"2/v1/{resource=projects/*}/contacts:sendTestMessage:\x01*Z6\"1/v1/{resource=folders/*}/contacts:sendTestMessage:\x01*Z<\"7/v1/{resource=organizations/*}/contacts:sendTestMessage:\x01*\x1aT\xca\x41 essentialcontacts.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xed\x01\n%com.google.cloud.essentialcontacts.v1P\x01ZScloud.google.com/go/essentialcontacts/apiv1/essentialcontactspb;essentialcontactspb\xaa\x02!Google.Cloud.EssentialContacts.V1\xca\x02!Google\\Cloud\\EssentialContacts\\V1\xea\x02$Google::Cloud::EssentialContacts::V1b\x06proto3"
17
+ descriptor_data = "\n/google/cloud/essentialcontacts/v1/service.proto\x12!google.cloud.essentialcontacts.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/essentialcontacts/v1/enums.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xea\x03\n\x07\x43ontact\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12\x12\n\x05\x65mail\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12i\n#notification_category_subscriptions\x18\x03 \x03(\x0e\x32\x37.google.cloud.essentialcontacts.v1.NotificationCategoryB\x03\xe0\x41\x02\x12\x19\n\x0clanguage_tag\x18\x04 \x01(\tB\x03\xe0\x41\x02\x12Q\n\x10validation_state\x18\x08 \x01(\x0e\x32\x32.google.cloud.essentialcontacts.v1.ValidationStateB\x03\xe0\x41\x03\x12\x31\n\rvalidate_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp:\xab\x01\xea\x41\xa7\x01\n(essentialcontacts.googleapis.com/Contact\x12%projects/{project}/contacts/{contact}\x12#folders/{folder}/contacts/{contact}\x12/organizations/{organization}/contacts/{contact}\"\x88\x01\n\x13ListContactsRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\x12(essentialcontacts.googleapis.com/Contact\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\"m\n\x14ListContactsResponse\x12<\n\x08\x63ontacts\x18\x01 \x03(\x0b\x32*.google.cloud.essentialcontacts.v1.Contact\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"S\n\x11GetContactRequest\x12>\n\x04name\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(essentialcontacts.googleapis.com/Contact\"V\n\x14\x44\x65leteContactRequest\x12>\n\x04name\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(essentialcontacts.googleapis.com/Contact\"\x9a\x01\n\x14\x43reateContactRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\x12(essentialcontacts.googleapis.com/Contact\x12@\n\x07\x63ontact\x18\x02 \x01(\x0b\x32*.google.cloud.essentialcontacts.v1.ContactB\x03\xe0\x41\x02\"\x8e\x01\n\x14UpdateContactRequest\x12@\n\x07\x63ontact\x18\x02 \x01(\x0b\x32*.google.cloud.essentialcontacts.v1.ContactB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x01\"\xe5\x01\n\x16\x43omputeContactsRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\x12(essentialcontacts.googleapis.com/Contact\x12X\n\x17notification_categories\x18\x06 \x03(\x0e\x32\x37.google.cloud.essentialcontacts.v1.NotificationCategory\x12\x16\n\tpage_size\x18\x03 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x04 \x01(\tB\x03\xe0\x41\x01\"p\n\x17\x43omputeContactsResponse\x12<\n\x08\x63ontacts\x18\x01 \x03(\x0b\x32*.google.cloud.essentialcontacts.v1.Contact\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\xfd\x01\n\x16SendTestMessageRequest\x12\x42\n\x08\x63ontacts\x18\x01 \x03(\tB0\xe0\x41\x02\xfa\x41*\n(essentialcontacts.googleapis.com/Contact\x12\x42\n\x08resource\x18\x02 \x01(\tB0\xe0\x41\x02\xfa\x41*\x12(essentialcontacts.googleapis.com/Contact\x12[\n\x15notification_category\x18\x03 \x01(\x0e\x32\x37.google.cloud.essentialcontacts.v1.NotificationCategoryB\x03\xe0\x41\x02\x32\xcb\x0f\n\x18\x45ssentialContactsService\x12\x98\x02\n\rCreateContact\x12\x37.google.cloud.essentialcontacts.v1.CreateContactRequest\x1a*.google.cloud.essentialcontacts.v1.Contact\"\xa1\x01\xda\x41\x0eparent,contact\x82\xd3\xe4\x93\x02\x89\x01\" /v1/{parent=projects/*}/contacts:\x07\x63ontactZ*\"\x1f/v1/{parent=folders/*}/contacts:\x07\x63ontactZ0\"%/v1/{parent=organizations/*}/contacts:\x07\x63ontact\x12\xb5\x02\n\rUpdateContact\x12\x37.google.cloud.essentialcontacts.v1.UpdateContactRequest\x1a*.google.cloud.essentialcontacts.v1.Contact\"\xbe\x01\xda\x41\x13\x63ontact,update_mask\x82\xd3\xe4\x93\x02\xa1\x01\x32(/v1/{contact.name=projects/*/contacts/*}:\x07\x63ontactZ22\'/v1/{contact.name=folders/*/contacts/*}:\x07\x63ontactZ82-/v1/{contact.name=organizations/*/contacts/*}:\x07\x63ontact\x12\xfe\x01\n\x0cListContacts\x12\x36.google.cloud.essentialcontacts.v1.ListContactsRequest\x1a\x37.google.cloud.essentialcontacts.v1.ListContactsResponse\"}\xda\x41\x06parent\x82\xd3\xe4\x93\x02n\x12 /v1/{parent=projects/*}/contactsZ!\x12\x1f/v1/{parent=folders/*}/contactsZ\'\x12%/v1/{parent=organizations/*}/contacts\x12\xeb\x01\n\nGetContact\x12\x34.google.cloud.essentialcontacts.v1.GetContactRequest\x1a*.google.cloud.essentialcontacts.v1.Contact\"{\xda\x41\x04name\x82\xd3\xe4\x93\x02n\x12 /v1/{name=projects/*/contacts/*}Z!\x12\x1f/v1/{name=folders/*/contacts/*}Z\'\x12%/v1/{name=organizations/*/contacts/*}\x12\xdd\x01\n\rDeleteContact\x12\x37.google.cloud.essentialcontacts.v1.DeleteContactRequest\x1a\x16.google.protobuf.Empty\"{\xda\x41\x04name\x82\xd3\xe4\x93\x02n* /v1/{name=projects/*/contacts/*}Z!*\x1f/v1/{name=folders/*/contacts/*}Z\'*%/v1/{name=organizations/*/contacts/*}\x12\x98\x02\n\x0f\x43omputeContacts\x12\x39.google.cloud.essentialcontacts.v1.ComputeContactsRequest\x1a:.google.cloud.essentialcontacts.v1.ComputeContactsResponse\"\x8d\x01\x82\xd3\xe4\x93\x02\x86\x01\x12(/v1/{parent=projects/*}/contacts:computeZ)\x12\'/v1/{parent=folders/*}/contacts:computeZ/\x12-/v1/{parent=organizations/*}/contacts:compute\x12\x9b\x02\n\x0fSendTestMessage\x12\x39.google.cloud.essentialcontacts.v1.SendTestMessageRequest\x1a\x16.google.protobuf.Empty\"\xb4\x01\x82\xd3\xe4\x93\x02\xad\x01\"2/v1/{resource=projects/*}/contacts:sendTestMessage:\x01*Z6\"1/v1/{resource=folders/*}/contacts:sendTestMessage:\x01*Z<\"7/v1/{resource=organizations/*}/contacts:sendTestMessage:\x01*\x1aT\xca\x41 essentialcontacts.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xed\x01\n%com.google.cloud.essentialcontacts.v1P\x01ZScloud.google.com/go/essentialcontacts/apiv1/essentialcontactspb;essentialcontactspb\xaa\x02!Google.Cloud.EssentialContacts.V1\xca\x02!Google\\Cloud\\EssentialContacts\\V1\xea\x02$Google::Cloud::EssentialContacts::V1b\x06proto3"
18
18
 
19
19
  pool = Google::Protobuf::DescriptorPool.generated_pool
20
20
 
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,6 +215,12 @@ module Google
212
215
  # enabled. By default, asynchronous REST clients will not be generated.
213
216
  # This feature will be enabled by default 1 month after launching the
214
217
  # feature in preview packages.
218
+ # @!attribute [rw] protobuf_pythonic_types_enabled
219
+ # @return [::Boolean]
220
+ # Enables generation of protobuf code using new types that are more
221
+ # Pythonic which are included in `protobuf>=5.29.x`. This feature will be
222
+ # enabled by default 1 month after launching the feature in preview
223
+ # packages.
215
224
  class ExperimentalFeatures
216
225
  include ::Google::Protobuf::MessageExts
217
226
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,9 +306,28 @@ module Google
297
306
  # @!attribute [rw] common
298
307
  # @return [::Google::Api::CommonLanguageSettings]
299
308
  # Some settings.
309
+ # @!attribute [rw] renamed_services
310
+ # @return [::Google::Protobuf::Map{::String => ::String}]
311
+ # Map of service names to renamed services. Keys are the package relative
312
+ # service names and values are the name to be used for the service client
313
+ # and call options.
314
+ #
315
+ # publishing:
316
+ # go_settings:
317
+ # renamed_services:
318
+ # Publisher: TopicAdmin
300
319
  class GoSettings
301
320
  include ::Google::Protobuf::MessageExts
302
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
322
+
323
+ # @!attribute [rw] key
324
+ # @return [::String]
325
+ # @!attribute [rw] value
326
+ # @return [::String]
327
+ class RenamedServicesEntry
328
+ include ::Google::Protobuf::MessageExts
329
+ extend ::Google::Protobuf::MessageExts::ClassMethods
330
+ end
303
331
  end
304
332
 
305
333
  # Describes the generator configuration for a method.
@@ -375,6 +403,17 @@ module Google
375
403
  end
376
404
  end
377
405
 
406
+ # This message is used to configure the generation of a subset of the RPCs in
407
+ # a service for client libraries.
408
+ # @!attribute [rw] methods
409
+ # @return [::Array<::String>]
410
+ # An allowlist of the fully qualified names of RPCs that should be included
411
+ # on public client surfaces.
412
+ class SelectiveGapicGeneration
413
+ include ::Google::Protobuf::MessageExts
414
+ extend ::Google::Protobuf::MessageExts::ClassMethods
415
+ end
416
+
378
417
  # The organization for which the client libraries are being published.
379
418
  # Affects the url where generated docs are published, etc.
380
419
  module ClientLibraryOrganization
@@ -40,10 +40,10 @@ module Google
40
40
  # code. See [Supported
41
41
  # languages](https://cloud.google.com/resource-manager/docs/managing-notification-contacts#supported-languages)
42
42
  # for a list of supported languages.
43
- # @!attribute [rw] validation_state
43
+ # @!attribute [r] validation_state
44
44
  # @return [::Google::Cloud::EssentialContacts::V1::ValidationState]
45
- # The validity of the contact. A contact is considered valid if it is the
46
- # correct recipient for notifications for a particular resource.
45
+ # Output only. The validity of the contact. A contact is considered valid if
46
+ # it is the correct recipient for notifications for a particular resource.
47
47
  # @!attribute [rw] validate_time
48
48
  # @return [::Google::Protobuf::Timestamp]
49
49
  # The last time the validation_state was updated, either manually or
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-essential_contacts-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.1
4
+ version: 1.1.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-08-30 00:00:00.000000000 Z
11
+ date: 2024-12-10 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.21.1
19
+ version: 0.24.0
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.21.1
29
+ version: 0.24.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -104,7 +104,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
104
104
  - !ruby/object:Gem::Version
105
105
  version: '0'
106
106
  requirements: []
107
- rubygems_version: 3.5.6
107
+ rubygems_version: 3.5.23
108
108
  signing_key:
109
109
  specification_version: 4
110
110
  summary: API Client library for the Essential Contacts V1 API