google-apps-meet-v2beta 0.3.1 → 0.4.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: '08500c600e74bbb02229ab65f10b1c441b5aac4426201932554dd2e775bae04f'
4
- data.tar.gz: cf02e170088828357efd140e501bf7569b2b4c80e9daa658de9029fa43a63fd9
3
+ metadata.gz: 2e8ff7e3f64912df1367b8771ba73ce92012a3549c3a66a685c6f2d97c329c77
4
+ data.tar.gz: 9573284ca475f198d3103711d42f3eeefc7a03f03394b09d08a9b50855655013
5
5
  SHA512:
6
- metadata.gz: 1134c7d64105835982479aa324744fc628e6a8d94d783c55004d444a7b93cdd737f4a80e5f8069284f2184970391b9e4aef5ce6dabd9c4e4627de45ec363d54b
7
- data.tar.gz: bfa499aac026a50e8de97551c10ea81b6e3f94b530b87f1f21b76ed89a0a705294945b033fa7b10457a3c6c144f5907ceb5ce5d09d436f1ab9a5816ef472841c
6
+ metadata.gz: ae2eceaad82439c0459e797cb8c59135e1e3e24cdbeea04c0495b254b24a3e6e884fea68c0b874a1fc57576f7eecd7554f1574157ec0467dec0c3d84c61f43bb
7
+ data.tar.gz: c177dfee64b7789fc5062b360bbc79d3f343033b71f20c4bad5dbce36a60e143b9cbba973b4f4b836dfbf5b4aa0a1f2f54ebbb1ce2bc2ccf3362d1b1b8285235
data/README.md CHANGED
@@ -42,33 +42,43 @@ for class and method documentation.
42
42
  See also the [Product Documentation](https://developers.google.com/meet/api/guides/overview)
43
43
  for general usage information.
44
44
 
45
- ## Enabling Logging
46
-
47
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
48
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
49
- or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
50
- 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)
51
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
52
-
53
- Configuring a Ruby stdlib logger:
45
+ ## Debug Logging
46
+
47
+ This library comes with opt-in Debug Logging that can help you troubleshoot
48
+ your application's integration with the API. When logging is activated, key
49
+ events such as requests and responses, along with data payloads and metadata
50
+ such as headers and client configuration, are logged to the standard error
51
+ stream.
52
+
53
+ **WARNING:** Client Library Debug Logging includes your data payloads in
54
+ plaintext, which could include sensitive data such as PII for yourself or your
55
+ customers, private keys, or other security data that could be compromising if
56
+ leaked. Always practice good data hygiene with your application logs, and follow
57
+ the principle of least access. Google also recommends that Client Library Debug
58
+ Logging be enabled only temporarily during active debugging, and not used
59
+ permanently in production.
60
+
61
+ To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
62
+ to the value `all`. Alternatively, you can set the value to a comma-delimited
63
+ list of client library gem names. This will select the default logging behavior,
64
+ which writes logs to the standard error stream. On a local workstation, this may
65
+ result in logs appearing on the console. When running on a Google Cloud hosting
66
+ service such as [Google Cloud Run](https://cloud.google.com/run), this generally
67
+ results in logs appearing alongside your application logs in the
68
+ [Google Cloud Logging](https://cloud.google.com/logging/) service.
69
+
70
+ You can customize logging by modifying the `logger` configuration when
71
+ constructing a client object. For example:
54
72
 
55
73
  ```ruby
74
+ require "google/apps/meet/v2beta"
56
75
  require "logger"
57
76
 
58
- module MyLogger
59
- LOGGER = Logger.new $stderr, level: Logger::WARN
60
- def logger
61
- LOGGER
62
- end
63
- end
64
-
65
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
66
- module GRPC
67
- extend MyLogger
77
+ client = ::Google::Apps::Meet::V2beta::SpacesService::Client.new do |config|
78
+ config.logger = Logger.new "my-app.log"
68
79
  end
69
80
  ```
70
81
 
71
-
72
82
  ## Google Cloud Samples
73
83
 
74
84
  To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
@@ -217,8 +217,28 @@ module Google
217
217
  universe_domain: @config.universe_domain,
218
218
  channel_args: @config.channel_args,
219
219
  interceptors: @config.interceptors,
220
- channel_pool_config: @config.channel_pool
220
+ channel_pool_config: @config.channel_pool,
221
+ logger: @config.logger
221
222
  )
223
+
224
+ @conference_records_service_stub.stub_logger&.info do |entry|
225
+ entry.set_system_name
226
+ entry.set_service
227
+ entry.message = "Created client for #{entry.service}"
228
+ entry.set_credentials_fields credentials
229
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
230
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
231
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
232
+ end
233
+ end
234
+
235
+ ##
236
+ # The logger used for request/response debug logging.
237
+ #
238
+ # @return [Logger]
239
+ #
240
+ def logger
241
+ @conference_records_service_stub.logger
222
242
  end
223
243
 
224
244
  # Service calls
@@ -304,7 +324,6 @@ module Google
304
324
 
305
325
  @conference_records_service_stub.call_rpc :get_conference_record, request, options: options do |response, operation|
306
326
  yield response, operation if block_given?
307
- return response
308
327
  end
309
328
  rescue ::GRPC::BadStatus => e
310
329
  raise ::Google::Cloud::Error.from_error(e)
@@ -403,7 +422,7 @@ module Google
403
422
  @conference_records_service_stub.call_rpc :list_conference_records, request, options: options do |response, operation|
404
423
  response = ::Gapic::PagedEnumerable.new @conference_records_service_stub, :list_conference_records, request, response, operation, options
405
424
  yield response, operation if block_given?
406
- return response
425
+ throw :response, response
407
426
  end
408
427
  rescue ::GRPC::BadStatus => e
409
428
  raise ::Google::Cloud::Error.from_error(e)
@@ -490,7 +509,6 @@ module Google
490
509
 
491
510
  @conference_records_service_stub.call_rpc :get_participant, request, options: options do |response, operation|
492
511
  yield response, operation if block_given?
493
- return response
494
512
  end
495
513
  rescue ::GRPC::BadStatus => e
496
514
  raise ::Google::Cloud::Error.from_error(e)
@@ -603,7 +621,7 @@ module Google
603
621
  @conference_records_service_stub.call_rpc :list_participants, request, options: options do |response, operation|
604
622
  response = ::Gapic::PagedEnumerable.new @conference_records_service_stub, :list_participants, request, response, operation, options
605
623
  yield response, operation if block_given?
606
- return response
624
+ throw :response, response
607
625
  end
608
626
  rescue ::GRPC::BadStatus => e
609
627
  raise ::Google::Cloud::Error.from_error(e)
@@ -690,7 +708,6 @@ module Google
690
708
 
691
709
  @conference_records_service_stub.call_rpc :get_participant_session, request, options: options do |response, operation|
692
710
  yield response, operation if block_given?
693
- return response
694
711
  end
695
712
  rescue ::GRPC::BadStatus => e
696
713
  raise ::Google::Cloud::Error.from_error(e)
@@ -803,7 +820,7 @@ module Google
803
820
  @conference_records_service_stub.call_rpc :list_participant_sessions, request, options: options do |response, operation|
804
821
  response = ::Gapic::PagedEnumerable.new @conference_records_service_stub, :list_participant_sessions, request, response, operation, options
805
822
  yield response, operation if block_given?
806
- return response
823
+ throw :response, response
807
824
  end
808
825
  rescue ::GRPC::BadStatus => e
809
826
  raise ::Google::Cloud::Error.from_error(e)
@@ -890,7 +907,6 @@ module Google
890
907
 
891
908
  @conference_records_service_stub.call_rpc :get_recording, request, options: options do |response, operation|
892
909
  yield response, operation if block_given?
893
- return response
894
910
  end
895
911
  rescue ::GRPC::BadStatus => e
896
912
  raise ::Google::Cloud::Error.from_error(e)
@@ -990,7 +1006,7 @@ module Google
990
1006
  @conference_records_service_stub.call_rpc :list_recordings, request, options: options do |response, operation|
991
1007
  response = ::Gapic::PagedEnumerable.new @conference_records_service_stub, :list_recordings, request, response, operation, options
992
1008
  yield response, operation if block_given?
993
- return response
1009
+ throw :response, response
994
1010
  end
995
1011
  rescue ::GRPC::BadStatus => e
996
1012
  raise ::Google::Cloud::Error.from_error(e)
@@ -1077,7 +1093,6 @@ module Google
1077
1093
 
1078
1094
  @conference_records_service_stub.call_rpc :get_transcript, request, options: options do |response, operation|
1079
1095
  yield response, operation if block_given?
1080
- return response
1081
1096
  end
1082
1097
  rescue ::GRPC::BadStatus => e
1083
1098
  raise ::Google::Cloud::Error.from_error(e)
@@ -1177,7 +1192,7 @@ module Google
1177
1192
  @conference_records_service_stub.call_rpc :list_transcripts, request, options: options do |response, operation|
1178
1193
  response = ::Gapic::PagedEnumerable.new @conference_records_service_stub, :list_transcripts, request, response, operation, options
1179
1194
  yield response, operation if block_given?
1180
- return response
1195
+ throw :response, response
1181
1196
  end
1182
1197
  rescue ::GRPC::BadStatus => e
1183
1198
  raise ::Google::Cloud::Error.from_error(e)
@@ -1268,7 +1283,6 @@ module Google
1268
1283
 
1269
1284
  @conference_records_service_stub.call_rpc :get_transcript_entry, request, options: options do |response, operation|
1270
1285
  yield response, operation if block_given?
1271
- return response
1272
1286
  end
1273
1287
  rescue ::GRPC::BadStatus => e
1274
1288
  raise ::Google::Cloud::Error.from_error(e)
@@ -1374,7 +1388,7 @@ module Google
1374
1388
  @conference_records_service_stub.call_rpc :list_transcript_entries, request, options: options do |response, operation|
1375
1389
  response = ::Gapic::PagedEnumerable.new @conference_records_service_stub, :list_transcript_entries, request, response, operation, options
1376
1390
  yield response, operation if block_given?
1377
- return response
1391
+ throw :response, response
1378
1392
  end
1379
1393
  rescue ::GRPC::BadStatus => e
1380
1394
  raise ::Google::Cloud::Error.from_error(e)
@@ -1463,6 +1477,11 @@ module Google
1463
1477
  # default endpoint URL. The default value of nil uses the environment
1464
1478
  # universe (usually the default "googleapis.com" universe).
1465
1479
  # @return [::String,nil]
1480
+ # @!attribute [rw] logger
1481
+ # A custom logger to use for request/response debug logging, or the value
1482
+ # `:default` (the default) to construct a default logger, or `nil` to
1483
+ # explicitly disable logging.
1484
+ # @return [::Logger,:default,nil]
1466
1485
  #
1467
1486
  class Configuration
1468
1487
  extend ::Gapic::Config
@@ -1487,6 +1506,7 @@ module Google
1487
1506
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1488
1507
  config_attr :quota_project, nil, ::String, nil
1489
1508
  config_attr :universe_domain, nil, ::String, nil
1509
+ config_attr :logger, :default, ::Logger, nil, :default
1490
1510
 
1491
1511
  # @private
1492
1512
  def initialize parent_config = nil
@@ -210,8 +210,28 @@ module Google
210
210
  endpoint: @config.endpoint,
211
211
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
212
212
  universe_domain: @config.universe_domain,
213
- credentials: credentials
213
+ credentials: credentials,
214
+ logger: @config.logger
214
215
  )
216
+
217
+ @conference_records_service_stub.logger(stub: true)&.info do |entry|
218
+ entry.set_system_name
219
+ entry.set_service
220
+ entry.message = "Created client for #{entry.service}"
221
+ entry.set_credentials_fields credentials
222
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
223
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
224
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
225
+ end
226
+ end
227
+
228
+ ##
229
+ # The logger used for request/response debug logging.
230
+ #
231
+ # @return [Logger]
232
+ #
233
+ def logger
234
+ @conference_records_service_stub.logger
215
235
  end
216
236
 
217
237
  # Service calls
@@ -290,7 +310,6 @@ module Google
290
310
 
291
311
  @conference_records_service_stub.get_conference_record request, options do |result, operation|
292
312
  yield result, operation if block_given?
293
- return result
294
313
  end
295
314
  rescue ::Gapic::Rest::Error => e
296
315
  raise ::Google::Cloud::Error.from_error(e)
@@ -390,7 +409,7 @@ module Google
390
409
  @conference_records_service_stub.list_conference_records request, options do |result, operation|
391
410
  result = ::Gapic::Rest::PagedEnumerable.new @conference_records_service_stub, :list_conference_records, "conference_records", request, result, options
392
411
  yield result, operation if block_given?
393
- return result
412
+ throw :response, result
394
413
  end
395
414
  rescue ::Gapic::Rest::Error => e
396
415
  raise ::Google::Cloud::Error.from_error(e)
@@ -470,7 +489,6 @@ module Google
470
489
 
471
490
  @conference_records_service_stub.get_participant request, options do |result, operation|
472
491
  yield result, operation if block_given?
473
- return result
474
492
  end
475
493
  rescue ::Gapic::Rest::Error => e
476
494
  raise ::Google::Cloud::Error.from_error(e)
@@ -576,7 +594,7 @@ module Google
576
594
  @conference_records_service_stub.list_participants request, options do |result, operation|
577
595
  result = ::Gapic::Rest::PagedEnumerable.new @conference_records_service_stub, :list_participants, "participants", request, result, options
578
596
  yield result, operation if block_given?
579
- return result
597
+ throw :response, result
580
598
  end
581
599
  rescue ::Gapic::Rest::Error => e
582
600
  raise ::Google::Cloud::Error.from_error(e)
@@ -656,7 +674,6 @@ module Google
656
674
 
657
675
  @conference_records_service_stub.get_participant_session request, options do |result, operation|
658
676
  yield result, operation if block_given?
659
- return result
660
677
  end
661
678
  rescue ::Gapic::Rest::Error => e
662
679
  raise ::Google::Cloud::Error.from_error(e)
@@ -762,7 +779,7 @@ module Google
762
779
  @conference_records_service_stub.list_participant_sessions request, options do |result, operation|
763
780
  result = ::Gapic::Rest::PagedEnumerable.new @conference_records_service_stub, :list_participant_sessions, "participant_sessions", request, result, options
764
781
  yield result, operation if block_given?
765
- return result
782
+ throw :response, result
766
783
  end
767
784
  rescue ::Gapic::Rest::Error => e
768
785
  raise ::Google::Cloud::Error.from_error(e)
@@ -842,7 +859,6 @@ module Google
842
859
 
843
860
  @conference_records_service_stub.get_recording request, options do |result, operation|
844
861
  yield result, operation if block_given?
845
- return result
846
862
  end
847
863
  rescue ::Gapic::Rest::Error => e
848
864
  raise ::Google::Cloud::Error.from_error(e)
@@ -935,7 +951,7 @@ module Google
935
951
  @conference_records_service_stub.list_recordings request, options do |result, operation|
936
952
  result = ::Gapic::Rest::PagedEnumerable.new @conference_records_service_stub, :list_recordings, "recordings", request, result, options
937
953
  yield result, operation if block_given?
938
- return result
954
+ throw :response, result
939
955
  end
940
956
  rescue ::Gapic::Rest::Error => e
941
957
  raise ::Google::Cloud::Error.from_error(e)
@@ -1015,7 +1031,6 @@ module Google
1015
1031
 
1016
1032
  @conference_records_service_stub.get_transcript request, options do |result, operation|
1017
1033
  yield result, operation if block_given?
1018
- return result
1019
1034
  end
1020
1035
  rescue ::Gapic::Rest::Error => e
1021
1036
  raise ::Google::Cloud::Error.from_error(e)
@@ -1108,7 +1123,7 @@ module Google
1108
1123
  @conference_records_service_stub.list_transcripts request, options do |result, operation|
1109
1124
  result = ::Gapic::Rest::PagedEnumerable.new @conference_records_service_stub, :list_transcripts, "transcripts", request, result, options
1110
1125
  yield result, operation if block_given?
1111
- return result
1126
+ throw :response, result
1112
1127
  end
1113
1128
  rescue ::Gapic::Rest::Error => e
1114
1129
  raise ::Google::Cloud::Error.from_error(e)
@@ -1192,7 +1207,6 @@ module Google
1192
1207
 
1193
1208
  @conference_records_service_stub.get_transcript_entry request, options do |result, operation|
1194
1209
  yield result, operation if block_given?
1195
- return result
1196
1210
  end
1197
1211
  rescue ::Gapic::Rest::Error => e
1198
1212
  raise ::Google::Cloud::Error.from_error(e)
@@ -1291,7 +1305,7 @@ module Google
1291
1305
  @conference_records_service_stub.list_transcript_entries request, options do |result, operation|
1292
1306
  result = ::Gapic::Rest::PagedEnumerable.new @conference_records_service_stub, :list_transcript_entries, "transcript_entries", request, result, options
1293
1307
  yield result, operation if block_given?
1294
- return result
1308
+ throw :response, result
1295
1309
  end
1296
1310
  rescue ::Gapic::Rest::Error => e
1297
1311
  raise ::Google::Cloud::Error.from_error(e)
@@ -1371,6 +1385,11 @@ module Google
1371
1385
  # default endpoint URL. The default value of nil uses the environment
1372
1386
  # universe (usually the default "googleapis.com" universe).
1373
1387
  # @return [::String,nil]
1388
+ # @!attribute [rw] logger
1389
+ # A custom logger to use for request/response debug logging, or the value
1390
+ # `:default` (the default) to construct a default logger, or `nil` to
1391
+ # explicitly disable logging.
1392
+ # @return [::Logger,:default,nil]
1374
1393
  #
1375
1394
  class Configuration
1376
1395
  extend ::Gapic::Config
@@ -1392,6 +1411,7 @@ module Google
1392
1411
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1393
1412
  config_attr :quota_project, nil, ::String, nil
1394
1413
  config_attr :universe_domain, nil, ::String, nil
1414
+ config_attr :logger, :default, ::Logger, nil, :default
1395
1415
 
1396
1416
  # @private
1397
1417
  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 get_conference_record 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: "get_conference_record",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Apps::Meet::V2beta::ConferenceRecord.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: "list_conference_records",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Apps::Meet::V2beta::ListConferenceRecordsResponse.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: "get_participant",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Apps::Meet::V2beta::Participant.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: "list_participants",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Apps::Meet::V2beta::ListParticipantsResponse.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: "get_participant_session",
245
266
  options: options
246
267
  )
247
268
  operation = ::Gapic::Rest::TransportOperation.new response
248
269
  result = ::Google::Apps::Meet::V2beta::ParticipantSession.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: "list_participant_sessions",
283
306
  options: options
284
307
  )
285
308
  operation = ::Gapic::Rest::TransportOperation.new response
286
309
  result = ::Google::Apps::Meet::V2beta::ListParticipantSessionsResponse.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: "get_recording",
321
346
  options: options
322
347
  )
323
348
  operation = ::Gapic::Rest::TransportOperation.new response
324
349
  result = ::Google::Apps::Meet::V2beta::Recording.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
  ##
@@ -353,16 +379,18 @@ module Google
353
379
 
354
380
  response = @client_stub.make_http_request(
355
381
  verb,
356
- uri: uri,
357
- body: body || "",
358
- params: query_string_params,
382
+ uri: uri,
383
+ body: body || "",
384
+ params: query_string_params,
385
+ method_name: "list_recordings",
359
386
  options: options
360
387
  )
361
388
  operation = ::Gapic::Rest::TransportOperation.new response
362
389
  result = ::Google::Apps::Meet::V2beta::ListRecordingsResponse.decode_json response.body, ignore_unknown_fields: true
363
-
364
- yield result, operation if block_given?
365
- result
390
+ catch :response do
391
+ yield result, operation if block_given?
392
+ result
393
+ end
366
394
  end
367
395
 
368
396
  ##
@@ -391,16 +419,18 @@ module Google
391
419
 
392
420
  response = @client_stub.make_http_request(
393
421
  verb,
394
- uri: uri,
395
- body: body || "",
396
- params: query_string_params,
422
+ uri: uri,
423
+ body: body || "",
424
+ params: query_string_params,
425
+ method_name: "get_transcript",
397
426
  options: options
398
427
  )
399
428
  operation = ::Gapic::Rest::TransportOperation.new response
400
429
  result = ::Google::Apps::Meet::V2beta::Transcript.decode_json response.body, ignore_unknown_fields: true
401
-
402
- yield result, operation if block_given?
403
- result
430
+ catch :response do
431
+ yield result, operation if block_given?
432
+ result
433
+ end
404
434
  end
405
435
 
406
436
  ##
@@ -429,16 +459,18 @@ module Google
429
459
 
430
460
  response = @client_stub.make_http_request(
431
461
  verb,
432
- uri: uri,
433
- body: body || "",
434
- params: query_string_params,
462
+ uri: uri,
463
+ body: body || "",
464
+ params: query_string_params,
465
+ method_name: "list_transcripts",
435
466
  options: options
436
467
  )
437
468
  operation = ::Gapic::Rest::TransportOperation.new response
438
469
  result = ::Google::Apps::Meet::V2beta::ListTranscriptsResponse.decode_json response.body, ignore_unknown_fields: true
439
-
440
- yield result, operation if block_given?
441
- result
470
+ catch :response do
471
+ yield result, operation if block_given?
472
+ result
473
+ end
442
474
  end
443
475
 
444
476
  ##
@@ -467,16 +499,18 @@ module Google
467
499
 
468
500
  response = @client_stub.make_http_request(
469
501
  verb,
470
- uri: uri,
471
- body: body || "",
472
- params: query_string_params,
502
+ uri: uri,
503
+ body: body || "",
504
+ params: query_string_params,
505
+ method_name: "get_transcript_entry",
473
506
  options: options
474
507
  )
475
508
  operation = ::Gapic::Rest::TransportOperation.new response
476
509
  result = ::Google::Apps::Meet::V2beta::TranscriptEntry.decode_json response.body, ignore_unknown_fields: true
477
-
478
- yield result, operation if block_given?
479
- result
510
+ catch :response do
511
+ yield result, operation if block_given?
512
+ result
513
+ end
480
514
  end
481
515
 
482
516
  ##
@@ -505,16 +539,18 @@ module Google
505
539
 
506
540
  response = @client_stub.make_http_request(
507
541
  verb,
508
- uri: uri,
509
- body: body || "",
510
- params: query_string_params,
542
+ uri: uri,
543
+ body: body || "",
544
+ params: query_string_params,
545
+ method_name: "list_transcript_entries",
511
546
  options: options
512
547
  )
513
548
  operation = ::Gapic::Rest::TransportOperation.new response
514
549
  result = ::Google::Apps::Meet::V2beta::ListTranscriptEntriesResponse.decode_json response.body, ignore_unknown_fields: true
515
-
516
- yield result, operation if block_given?
517
- result
550
+ catch :response do
551
+ yield result, operation if block_given?
552
+ result
553
+ end
518
554
  end
519
555
 
520
556
  ##
@@ -168,8 +168,28 @@ module Google
168
168
  universe_domain: @config.universe_domain,
169
169
  channel_args: @config.channel_args,
170
170
  interceptors: @config.interceptors,
171
- channel_pool_config: @config.channel_pool
171
+ channel_pool_config: @config.channel_pool,
172
+ logger: @config.logger
172
173
  )
174
+
175
+ @spaces_service_stub.stub_logger&.info do |entry|
176
+ entry.set_system_name
177
+ entry.set_service
178
+ entry.message = "Created client for #{entry.service}"
179
+ entry.set_credentials_fields credentials
180
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
181
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
182
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
183
+ end
184
+ end
185
+
186
+ ##
187
+ # The logger used for request/response debug logging.
188
+ #
189
+ # @return [Logger]
190
+ #
191
+ def logger
192
+ @spaces_service_stub.logger
173
193
  end
174
194
 
175
195
  # Service calls
@@ -248,7 +268,6 @@ module Google
248
268
 
249
269
  @spaces_service_stub.call_rpc :create_space, request, options: options do |response, operation|
250
270
  yield response, operation if block_given?
251
- return response
252
271
  end
253
272
  rescue ::GRPC::BadStatus => e
254
273
  raise ::Google::Cloud::Error.from_error(e)
@@ -335,7 +354,6 @@ module Google
335
354
 
336
355
  @spaces_service_stub.call_rpc :get_space, request, options: options do |response, operation|
337
356
  yield response, operation if block_given?
338
- return response
339
357
  end
340
358
  rescue ::GRPC::BadStatus => e
341
359
  raise ::Google::Cloud::Error.from_error(e)
@@ -427,7 +445,6 @@ module Google
427
445
 
428
446
  @spaces_service_stub.call_rpc :update_space, request, options: options do |response, operation|
429
447
  yield response, operation if block_given?
430
- return response
431
448
  end
432
449
  rescue ::GRPC::BadStatus => e
433
450
  raise ::Google::Cloud::Error.from_error(e)
@@ -514,7 +531,6 @@ module Google
514
531
 
515
532
  @spaces_service_stub.call_rpc :end_active_conference, request, options: options do |response, operation|
516
533
  yield response, operation if block_given?
517
- return response
518
534
  end
519
535
  rescue ::GRPC::BadStatus => e
520
536
  raise ::Google::Cloud::Error.from_error(e)
@@ -603,6 +619,11 @@ module Google
603
619
  # default endpoint URL. The default value of nil uses the environment
604
620
  # universe (usually the default "googleapis.com" universe).
605
621
  # @return [::String,nil]
622
+ # @!attribute [rw] logger
623
+ # A custom logger to use for request/response debug logging, or the value
624
+ # `:default` (the default) to construct a default logger, or `nil` to
625
+ # explicitly disable logging.
626
+ # @return [::Logger,:default,nil]
606
627
  #
607
628
  class Configuration
608
629
  extend ::Gapic::Config
@@ -627,6 +648,7 @@ module Google
627
648
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
628
649
  config_attr :quota_project, nil, ::String, nil
629
650
  config_attr :universe_domain, nil, ::String, nil
651
+ config_attr :logger, :default, ::Logger, nil, :default
630
652
 
631
653
  # @private
632
654
  def initialize parent_config = nil
@@ -161,8 +161,28 @@ module Google
161
161
  endpoint: @config.endpoint,
162
162
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
163
163
  universe_domain: @config.universe_domain,
164
- credentials: credentials
164
+ credentials: credentials,
165
+ logger: @config.logger
165
166
  )
167
+
168
+ @spaces_service_stub.logger(stub: true)&.info do |entry|
169
+ entry.set_system_name
170
+ entry.set_service
171
+ entry.message = "Created client for #{entry.service}"
172
+ entry.set_credentials_fields credentials
173
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
174
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
175
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
176
+ end
177
+ end
178
+
179
+ ##
180
+ # The logger used for request/response debug logging.
181
+ #
182
+ # @return [Logger]
183
+ #
184
+ def logger
185
+ @spaces_service_stub.logger
166
186
  end
167
187
 
168
188
  # Service calls
@@ -242,7 +262,6 @@ module Google
242
262
 
243
263
  @spaces_service_stub.create_space request, options do |result, operation|
244
264
  yield result, operation if block_given?
245
- return result
246
265
  end
247
266
  rescue ::Gapic::Rest::Error => e
248
267
  raise ::Google::Cloud::Error.from_error(e)
@@ -322,7 +341,6 @@ module Google
322
341
 
323
342
  @spaces_service_stub.get_space request, options do |result, operation|
324
343
  yield result, operation if block_given?
325
- return result
326
344
  end
327
345
  rescue ::Gapic::Rest::Error => e
328
346
  raise ::Google::Cloud::Error.from_error(e)
@@ -407,7 +425,6 @@ module Google
407
425
 
408
426
  @spaces_service_stub.update_space request, options do |result, operation|
409
427
  yield result, operation if block_given?
410
- return result
411
428
  end
412
429
  rescue ::Gapic::Rest::Error => e
413
430
  raise ::Google::Cloud::Error.from_error(e)
@@ -487,7 +504,6 @@ module Google
487
504
 
488
505
  @spaces_service_stub.end_active_conference request, options do |result, operation|
489
506
  yield result, operation if block_given?
490
- return result
491
507
  end
492
508
  rescue ::Gapic::Rest::Error => e
493
509
  raise ::Google::Cloud::Error.from_error(e)
@@ -567,6 +583,11 @@ module Google
567
583
  # default endpoint URL. The default value of nil uses the environment
568
584
  # universe (usually the default "googleapis.com" universe).
569
585
  # @return [::String,nil]
586
+ # @!attribute [rw] logger
587
+ # A custom logger to use for request/response debug logging, or the value
588
+ # `:default` (the default) to construct a default logger, or `nil` to
589
+ # explicitly disable logging.
590
+ # @return [::Logger,:default,nil]
570
591
  #
571
592
  class Configuration
572
593
  extend ::Gapic::Config
@@ -588,6 +609,7 @@ module Google
588
609
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
589
610
  config_attr :quota_project, nil, ::String, nil
590
611
  config_attr :universe_domain, nil, ::String, nil
612
+ config_attr :logger, :default, ::Logger, nil, :default
591
613
 
592
614
  # @private
593
615
  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_space 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_space",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Apps::Meet::V2beta::Space.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: "get_space",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Apps::Meet::V2beta::Space.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: "update_space",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Apps::Meet::V2beta::Space.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: "end_active_conference",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Protobuf::Empty.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
  ##
@@ -21,7 +21,7 @@ module Google
21
21
  module Apps
22
22
  module Meet
23
23
  module V2beta
24
- VERSION = "0.3.1"
24
+ VERSION = "0.4.0"
25
25
  end
26
26
  end
27
27
  end
@@ -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
@@ -196,9 +199,32 @@ module Google
196
199
  # @!attribute [rw] common
197
200
  # @return [::Google::Api::CommonLanguageSettings]
198
201
  # Some settings.
202
+ # @!attribute [rw] experimental_features
203
+ # @return [::Google::Api::PythonSettings::ExperimentalFeatures]
204
+ # Experimental features to be included during client library generation.
199
205
  class PythonSettings
200
206
  include ::Google::Protobuf::MessageExts
201
207
  extend ::Google::Protobuf::MessageExts::ClassMethods
208
+
209
+ # Experimental features to be included during client library generation.
210
+ # These fields will be deprecated once the feature graduates and is enabled
211
+ # by default.
212
+ # @!attribute [rw] rest_async_io_enabled
213
+ # @return [::Boolean]
214
+ # Enables generation of asynchronous REST clients if `rest` transport is
215
+ # enabled. By default, asynchronous REST clients will not be generated.
216
+ # This feature will be enabled by default 1 month after launching the
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.
224
+ class ExperimentalFeatures
225
+ include ::Google::Protobuf::MessageExts
226
+ extend ::Google::Protobuf::MessageExts::ClassMethods
227
+ end
202
228
  end
203
229
 
204
230
  # Settings for Node client libraries.
@@ -280,9 +306,28 @@ module Google
280
306
  # @!attribute [rw] common
281
307
  # @return [::Google::Api::CommonLanguageSettings]
282
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
283
319
  class GoSettings
284
320
  include ::Google::Protobuf::MessageExts
285
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
286
331
  end
287
332
 
288
333
  # Describes the generator configuration for a method.
@@ -358,6 +403,17 @@ module Google
358
403
  end
359
404
  end
360
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
+
361
417
  # The organization for which the client libraries are being published.
362
418
  # Affects the url where generated docs are published, etc.
363
419
  module ClientLibraryOrganization
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apps-meet-v2beta
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.3.1
4
+ version: 0.4.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-09 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
@@ -107,7 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
107
107
  - !ruby/object:Gem::Version
108
108
  version: '0'
109
109
  requirements: []
110
- rubygems_version: 3.5.6
110
+ rubygems_version: 3.5.23
111
111
  signing_key:
112
112
  specification_version: 4
113
113
  summary: Create and manage meetings in Google Meet.