google-apps-meet-v2beta 0.3.2 → 0.4.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: c77ed68097f06b5f74fdef641cf723b403809f334433da90c1c528ffb080d9ee
4
- data.tar.gz: baf1ddc568d5b49ad97c41ab53bd484b8a3fab3806fd6436af99b2fb623bd375
3
+ metadata.gz: 2e8ff7e3f64912df1367b8771ba73ce92012a3549c3a66a685c6f2d97c329c77
4
+ data.tar.gz: 9573284ca475f198d3103711d42f3eeefc7a03f03394b09d08a9b50855655013
5
5
  SHA512:
6
- metadata.gz: 7ba8c0654afa11c737052c42788311db6f6c4128acafd9d023eaf8ccba91454fe2d85a7ed2a8e822d3a07b334051bc58a6e877e3445257d5c773271e84d8c2ed
7
- data.tar.gz: 913ba078d8ea52050a01ef2708f0cb617ee32c71e97df7c70f43b8cacf990fe0ab29cc1b98239326d7a62bc427212b226f815feb24635d06657f9b10dc8f4723
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.2"
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
@@ -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
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.2
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-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
@@ -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.