google-apps-chat-v1 0.5.1 → 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
@@ -135,6 +138,15 @@ module Google
135
138
  # Optional. Space permission settings for existing spaces. Input for
136
139
  # updating exact space permission settings, where existing permission
137
140
  # settings are replaced. Output lists current permission settings.
141
+ # @!attribute [r] import_mode_expire_time
142
+ # @return [::Google::Protobuf::Timestamp]
143
+ # Output only. The time when the space will be automatically deleted by the
144
+ # system if it remains in import mode.
145
+ #
146
+ # Each space created in import mode must exit this mode before this expire
147
+ # time using `spaces.completeImport`.
148
+ #
149
+ # This field is only populated for spaces that were created with import mode.
138
150
  class Space
139
151
  include ::Google::Protobuf::MessageExts
140
152
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -157,13 +169,13 @@ module Google
157
169
  end
158
170
 
159
171
  # Represents the count of memberships of a space, grouped into categories.
160
- # @!attribute [rw] joined_direct_human_user_count
172
+ # @!attribute [r] joined_direct_human_user_count
161
173
  # @return [::Integer]
162
- # Count of human users that have directly joined the space, not counting
163
- # users joined by having membership in a joined group.
164
- # @!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
165
177
  # @return [::Integer]
166
- # Count of all groups that have directly joined the space.
178
+ # Output only. Count of all groups that have directly joined the space.
167
179
  class MembershipCount
168
180
  include ::Google::Protobuf::MessageExts
169
181
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -189,8 +201,23 @@ module Google
189
201
  # To use the default target audience for the Google Workspace organization,
190
202
  # set to `audiences/default`.
191
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
+ #
192
216
  # This field is not populated when using the `chat.bot` scope with [app
193
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).
194
221
  class AccessSettings
195
222
  include ::Google::Protobuf::MessageExts
196
223
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -210,6 +237,9 @@ module Google
210
237
  # invited to the space can also discover and access the space. To learn
211
238
  # more, see [Make a space discoverable to specific
212
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).
213
243
  DISCOVERABLE = 2
214
244
  end
215
245
  end
@@ -221,28 +251,29 @@ module Google
221
251
  # `PredefinedPermissionSettings` field in your request.
222
252
  # @!attribute [rw] manage_members_and_groups
223
253
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
224
- # Setting for managing members and groups in a space.
254
+ # Optional. Setting for managing members and groups in a space.
225
255
  # @!attribute [rw] modify_space_details
226
256
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
227
- # Setting for updating space name, avatar, description and guidelines.
257
+ # Optional. Setting for updating space name, avatar, description and
258
+ # guidelines.
228
259
  # @!attribute [rw] toggle_history
229
260
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
230
- # Setting for toggling space history on and off.
261
+ # Optional. Setting for toggling space history on and off.
231
262
  # @!attribute [rw] use_at_mention_all
232
263
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
233
- # Setting for using @all in a space.
264
+ # Optional. Setting for using @all in a space.
234
265
  # @!attribute [rw] manage_apps
235
266
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
236
- # Setting for managing apps in a space.
267
+ # Optional. Setting for managing apps in a space.
237
268
  # @!attribute [rw] manage_webhooks
238
269
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
239
- # Setting for managing webhooks in a space.
270
+ # Optional. Setting for managing webhooks in a space.
240
271
  # @!attribute [r] post_messages
241
272
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
242
273
  # Output only. Setting for posting messages in a space.
243
274
  # @!attribute [rw] reply_messages
244
275
  # @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
245
- # Setting for replying to messages in a space.
276
+ # Optional. Setting for replying to messages in a space.
246
277
  class PermissionSettings
247
278
  include ::Google::Protobuf::MessageExts
248
279
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -251,10 +282,10 @@ module Google
251
282
  # Represents a space permission setting.
252
283
  # @!attribute [rw] managers_allowed
253
284
  # @return [::Boolean]
254
- # Whether spaces managers have this permission.
285
+ # Optional. Whether spaces managers have this permission.
255
286
  # @!attribute [rw] members_allowed
256
287
  # @return [::Boolean]
257
- # Whether non-manager members have this permission.
288
+ # Optional. Whether non-manager members have this permission.
258
289
  class PermissionSetting
259
290
  include ::Google::Protobuf::MessageExts
260
291
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -332,15 +363,13 @@ module Google
332
363
  # @!attribute [rw] space
333
364
  # @return [::Google::Apps::Chat::V1::Space]
334
365
  # Required. The `displayName` and `spaceType` fields must be populated. Only
335
- # `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.
336
368
  #
337
369
  # If you receive the error message `ALREADY_EXISTS`,
338
370
  # try a different `displayName`. An existing space within the Google
339
371
  # Workspace organization might already use this display name.
340
372
  #
341
- # If you're a member of the [Developer Preview
342
- # program](https://developers.google.com/workspace/preview),
343
- # `SpaceType.GROUP_CHAT` can be used if `importMode` is set to true.
344
373
  #
345
374
  # The space `name` is assigned on the server so anything specified in this
346
375
  # field will be ignored.
@@ -425,7 +454,7 @@ module Google
425
454
  # Format: `spaces/{space}`
426
455
  # @!attribute [rw] use_admin_access
427
456
  # @return [::Boolean]
428
- # When `true`, the method runs using the user's Google Workspace
457
+ # Optional. When `true`, the method runs using the user's Google Workspace
429
458
  # administrator privileges.
430
459
  #
431
460
  # The calling user must be a Google Workspace administrator with the
@@ -531,7 +560,7 @@ module Google
531
560
  # - `permission_settings.replyMessages`
532
561
  # @!attribute [rw] use_admin_access
533
562
  # @return [::Boolean]
534
- # When `true`, the method runs using the user's Google Workspace
563
+ # Optional. When `true`, the method runs using the user's Google Workspace
535
564
  # administrator privileges.
536
565
  #
537
566
  # The calling user must be a Google Workspace administrator with the
@@ -707,7 +736,7 @@ module Google
707
736
  # Format: `spaces/{space}`
708
737
  # @!attribute [rw] use_admin_access
709
738
  # @return [::Boolean]
710
- # When `true`, the method runs using the user's Google Workspace
739
+ # Optional. When `true`, the method runs using the user's Google Workspace
711
740
  # administrator privileges.
712
741
  #
713
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.5.1
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-10-10 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.21
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