google-apps-chat-v1 0.6.0 → 0.7.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.
@@ -25,7 +25,7 @@ module Google
25
25
  # or 1:1 messages between a user and a Chat app.
26
26
  # @!attribute [rw] name
27
27
  # @return [::String]
28
- # Resource name of the space.
28
+ # Identifier. Resource name of the space.
29
29
  #
30
30
  # Format: `spaces/{space}`
31
31
  #
@@ -42,8 +42,8 @@ module Google
42
42
  # The type of a space.
43
43
  # @!attribute [rw] space_type
44
44
  # @return [::Google::Apps::Chat::V1::Space::SpaceType]
45
- # The type of space. Required when creating a space or updating the space
46
- # type of a space. Output only for other usage.
45
+ # Optional. The type of space. Required when creating a space or updating the
46
+ # space type of a space. Output only for other usage.
47
47
  # @!attribute [rw] single_user_bot_dm
48
48
  # @return [::Boolean]
49
49
  # Optional. Whether the space is a DM between a Chat app and a single
@@ -55,7 +55,7 @@ module Google
55
55
  # Whether messages are threaded in this space.
56
56
  # @!attribute [rw] display_name
57
57
  # @return [::String]
58
- # The space's display name. Required when [creating a
58
+ # Optional. The space's display name. Required when [creating a
59
59
  # space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create)
60
60
  # with a `spaceType` of `SPACE`. If you receive the error message
61
61
  # `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a
@@ -67,9 +67,9 @@ module Google
67
67
  # Supports up to 128 characters.
68
68
  # @!attribute [rw] external_user_allowed
69
69
  # @return [::Boolean]
70
- # Immutable. Whether this space permits any Google Chat user as a member.
71
- # Input when creating a space in a Google Workspace organization. Omit this
72
- # field when creating spaces in the following conditions:
70
+ # Optional. Immutable. Whether this space permits any Google Chat user as a
71
+ # member. Input when creating a space in a Google Workspace organization.
72
+ # Omit this field when creating spaces in the following conditions:
73
73
  #
74
74
  # * The authenticated user uses a consumer account (unmanaged user
75
75
  # account). By default, a space created by a consumer account permits any
@@ -81,15 +81,18 @@ module Google
81
81
  # Output only. The threading state in the Chat space.
82
82
  # @!attribute [rw] space_details
83
83
  # @return [::Google::Apps::Chat::V1::Space::SpaceDetails]
84
- # Details about the space including description and rules.
84
+ # Optional. Details about the space including description and rules.
85
85
  # @!attribute [rw] space_history_state
86
86
  # @return [::Google::Apps::Chat::V1::HistoryState]
87
- # The message history state for messages and threads in this space.
87
+ # Optional. The message history state for messages and threads in this space.
88
88
  # @!attribute [rw] import_mode
89
89
  # @return [::Boolean]
90
90
  # Optional. Whether this space is created in `Import Mode` as part of a data
91
91
  # migration into Google Workspace. While spaces are being imported, they
92
92
  # aren't visible to users until the import is complete.
93
+ #
94
+ # Creating a space in `Import Mode`requires [user
95
+ # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
93
96
  # @!attribute [rw] create_time
94
97
  # @return [::Google::Protobuf::Timestamp]
95
98
  # Optional. Immutable. For spaces created in Chat, the time the space was
@@ -166,13 +169,13 @@ module Google
166
169
  end
167
170
 
168
171
  # Represents the count of memberships of a space, grouped into categories.
169
- # @!attribute [rw] joined_direct_human_user_count
172
+ # @!attribute [r] joined_direct_human_user_count
170
173
  # @return [::Integer]
171
- # Count of human users that have directly joined the space, not counting
172
- # users joined by having membership in a joined group.
173
- # @!attribute [rw] joined_group_count
174
+ # Output only. Count of human users that have directly joined the space,
175
+ # not counting users joined by having membership in a joined group.
176
+ # @!attribute [r] joined_group_count
174
177
  # @return [::Integer]
175
- # Count of all groups that have directly joined the space.
178
+ # Output only. Count of all groups that have directly joined the space.
176
179
  class MembershipCount
177
180
  include ::Google::Protobuf::MessageExts
178
181
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -198,8 +201,23 @@ module Google
198
201
  # To use the default target audience for the Google Workspace organization,
199
202
  # set to `audiences/default`.
200
203
  #
204
+ # Reading the target audience supports:
205
+ #
206
+ # - [User
207
+ # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
208
+ #
209
+ # - [App
210
+ # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
211
+ # with [administrator
212
+ # approval](https://support.google.com/a?p=chat-app-auth)
213
+ # with the `chat.app.spaces` scope in [Developer
214
+ # Preview](https://developers.google.com/workspace/preview).
215
+ #
201
216
  # This field is not populated when using the `chat.bot` scope with [app
202
217
  # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
218
+ #
219
+ # Setting the target audience requires [user
220
+ # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
203
221
  class AccessSettings
204
222
  include ::Google::Protobuf::MessageExts
205
223
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -219,6 +237,9 @@ module Google
219
237
  # invited to the space can also discover and access the space. To learn
220
238
  # more, see [Make a space discoverable to specific
221
239
  # users](https://developers.google.com/workspace/chat/space-target-audience).
240
+ #
241
+ # Creating discoverable spaces requires [user
242
+ # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
222
243
  DISCOVERABLE = 2
223
244
  end
224
245
  end
@@ -230,28 +251,29 @@ module Google
230
251
  # `PredefinedPermissionSettings` field in your request.
231
252
  # @!attribute [rw] manage_members_and_groups
232
253
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
233
- # Setting for managing members and groups in a space.
254
+ # Optional. Setting for managing members and groups in a space.
234
255
  # @!attribute [rw] modify_space_details
235
256
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
236
- # Setting for updating space name, avatar, description and guidelines.
257
+ # Optional. Setting for updating space name, avatar, description and
258
+ # guidelines.
237
259
  # @!attribute [rw] toggle_history
238
260
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
239
- # Setting for toggling space history on and off.
261
+ # Optional. Setting for toggling space history on and off.
240
262
  # @!attribute [rw] use_at_mention_all
241
263
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
242
- # Setting for using @all in a space.
264
+ # Optional. Setting for using @all in a space.
243
265
  # @!attribute [rw] manage_apps
244
266
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
245
- # Setting for managing apps in a space.
267
+ # Optional. Setting for managing apps in a space.
246
268
  # @!attribute [rw] manage_webhooks
247
269
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
248
- # Setting for managing webhooks in a space.
270
+ # Optional. Setting for managing webhooks in a space.
249
271
  # @!attribute [r] post_messages
250
272
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
251
273
  # Output only. Setting for posting messages in a space.
252
274
  # @!attribute [rw] reply_messages
253
275
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
254
- # Setting for replying to messages in a space.
276
+ # Optional. Setting for replying to messages in a space.
255
277
  class PermissionSettings
256
278
  include ::Google::Protobuf::MessageExts
257
279
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -260,10 +282,10 @@ module Google
260
282
  # Represents a space permission setting.
261
283
  # @!attribute [rw] managers_allowed
262
284
  # @return [::Boolean]
263
- # Whether spaces managers have this permission.
285
+ # Optional. Whether spaces managers have this permission.
264
286
  # @!attribute [rw] members_allowed
265
287
  # @return [::Boolean]
266
- # Whether non-manager members have this permission.
288
+ # Optional. Whether non-manager members have this permission.
267
289
  class PermissionSetting
268
290
  include ::Google::Protobuf::MessageExts
269
291
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -341,15 +363,13 @@ module Google
341
363
  # @!attribute [rw] space
342
364
  # @return [::Google::Apps::Chat::V1::Space]
343
365
  # Required. The `displayName` and `spaceType` fields must be populated. Only
344
- # `SpaceType.SPACE` is supported.
366
+ # `SpaceType.SPACE` and `SpaceType.GROUP_CHAT` are supported.
367
+ # `SpaceType.GROUP_CHAT` can only be used if `importMode` is set to true.
345
368
  #
346
369
  # If you receive the error message `ALREADY_EXISTS`,
347
370
  # try a different `displayName`. An existing space within the Google
348
371
  # Workspace organization might already use this display name.
349
372
  #
350
- # If you're a member of the [Developer Preview
351
- # program](https://developers.google.com/workspace/preview),
352
- # `SpaceType.GROUP_CHAT` can be used if `importMode` is set to true.
353
373
  #
354
374
  # The space `name` is assigned on the server so anything specified in this
355
375
  # field will be ignored.
@@ -434,7 +454,7 @@ module Google
434
454
  # Format: `spaces/{space}`
435
455
  # @!attribute [rw] use_admin_access
436
456
  # @return [::Boolean]
437
- # When `true`, the method runs using the user's Google Workspace
457
+ # Optional. When `true`, the method runs using the user's Google Workspace
438
458
  # administrator privileges.
439
459
  #
440
460
  # The calling user must be a Google Workspace administrator with the
@@ -540,7 +560,7 @@ module Google
540
560
  # - `permission_settings.replyMessages`
541
561
  # @!attribute [rw] use_admin_access
542
562
  # @return [::Boolean]
543
- # When `true`, the method runs using the user's Google Workspace
563
+ # Optional. When `true`, the method runs using the user's Google Workspace
544
564
  # administrator privileges.
545
565
  #
546
566
  # The calling user must be a Google Workspace administrator with the
@@ -716,7 +736,7 @@ module Google
716
736
  # Format: `spaces/{space}`
717
737
  # @!attribute [rw] use_admin_access
718
738
  # @return [::Boolean]
719
- # When `true`, the method runs using the user's Google Workspace
739
+ # Optional. When `true`, the method runs using the user's Google Workspace
720
740
  # administrator privileges.
721
741
  #
722
742
  # The calling user must be a Google Workspace administrator with the
@@ -202,8 +202,8 @@ module Google
202
202
  # Negative values return an `INVALID_ARGUMENT` error.
203
203
  # @!attribute [rw] page_token
204
204
  # @return [::String]
205
- # A page token, received from a previous list space events call. Provide this
206
- # to retrieve the subsequent page.
205
+ # Optional. A page token, received from a previous list space events call.
206
+ # Provide this to retrieve the subsequent page.
207
207
  #
208
208
  # When paginating, all other parameters provided to list space events must
209
209
  # match the call that provided the page token. Passing different values to
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apps-chat-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.6.0
4
+ version: 0.7.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-12-04 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
@@ -114,6 +114,7 @@ files:
114
114
  - proto_docs/README.md
115
115
  - proto_docs/google/api/client.rb
116
116
  - proto_docs/google/api/field_behavior.rb
117
+ - proto_docs/google/api/field_info.rb
117
118
  - proto_docs/google/api/launch_stage.rb
118
119
  - proto_docs/google/api/resource.rb
119
120
  - proto_docs/google/apps/card/v1/card.rb
@@ -163,7 +164,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
163
164
  - !ruby/object:Gem::Version
164
165
  version: '0'
165
166
  requirements: []
166
- rubygems_version: 3.5.22
167
+ rubygems_version: 3.5.23
167
168
  signing_key:
168
169
  specification_version: 4
169
170
  summary: The Google Chat API lets you build Chat apps to integrate your services with