google-apps-chat-v1 0.5.1 → 0.7.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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
@@ -0,0 +1,88 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2024 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # Rich semantic information of an API field beyond basic typing.
23
+ # @!attribute [rw] format
24
+ # @return [::Google::Api::FieldInfo::Format]
25
+ # The standard format of a field value. This does not explicitly configure
26
+ # any API consumer, just documents the API's format for the field it is
27
+ # applied to.
28
+ # @!attribute [rw] referenced_types
29
+ # @return [::Array<::Google::Api::TypeReference>]
30
+ # The type(s) that the annotated, generic field may represent.
31
+ #
32
+ # Currently, this must only be used on fields of type `google.protobuf.Any`.
33
+ # Supporting other generic types may be considered in the future.
34
+ class FieldInfo
35
+ include ::Google::Protobuf::MessageExts
36
+ extend ::Google::Protobuf::MessageExts::ClassMethods
37
+
38
+ # The standard format of a field value. The supported formats are all backed
39
+ # by either an RFC defined by the IETF or a Google-defined AIP.
40
+ module Format
41
+ # Default, unspecified value.
42
+ FORMAT_UNSPECIFIED = 0
43
+
44
+ # Universally Unique Identifier, version 4, value as defined by
45
+ # https://datatracker.ietf.org/doc/html/rfc4122. The value may be
46
+ # normalized to entirely lowercase letters. For example, the value
47
+ # `F47AC10B-58CC-0372-8567-0E02B2C3D479` would be normalized to
48
+ # `f47ac10b-58cc-0372-8567-0e02b2c3d479`.
49
+ UUID4 = 1
50
+
51
+ # Internet Protocol v4 value as defined by [RFC
52
+ # 791](https://datatracker.ietf.org/doc/html/rfc791). The value may be
53
+ # condensed, with leading zeros in each octet stripped. For example,
54
+ # `001.022.233.040` would be condensed to `1.22.233.40`.
55
+ IPV4 = 2
56
+
57
+ # Internet Protocol v6 value as defined by [RFC
58
+ # 2460](https://datatracker.ietf.org/doc/html/rfc2460). The value may be
59
+ # normalized to entirely lowercase letters with zeros compressed, following
60
+ # [RFC 5952](https://datatracker.ietf.org/doc/html/rfc5952). For example,
61
+ # the value `2001:0DB8:0::0` would be normalized to `2001:db8::`.
62
+ IPV6 = 3
63
+
64
+ # An IP address in either v4 or v6 format as described by the individual
65
+ # values defined herein. See the comments on the IPV4 and IPV6 types for
66
+ # allowed normalizations of each.
67
+ IPV4_OR_IPV6 = 4
68
+ end
69
+ end
70
+
71
+ # A reference to a message type, for use in {::Google::Api::FieldInfo FieldInfo}.
72
+ # @!attribute [rw] type_name
73
+ # @return [::String]
74
+ # The name of the type that the annotated, generic field may represent.
75
+ # If the type is in the same protobuf package, the value can be the simple
76
+ # message name e.g., `"MyMessage"`. Otherwise, the value must be the
77
+ # fully-qualified message name e.g., `"google.library.v1.Book"`.
78
+ #
79
+ # If the type(s) are unknown to the service (e.g. the field accepts generic
80
+ # user input), use the wildcard `"*"` to denote this behavior.
81
+ #
82
+ # See [AIP-202](https://google.aip.dev/202#type-references) for more details.
83
+ class TypeReference
84
+ include ::Google::Protobuf::MessageExts
85
+ extend ::Google::Protobuf::MessageExts::ClassMethods
86
+ end
87
+ end
88
+ end
@@ -24,7 +24,7 @@ module Google
24
24
  # An attachment in Google Chat.
25
25
  # @!attribute [rw] name
26
26
  # @return [::String]
27
- # Resource name of the attachment, in the form
27
+ # Optional. Resource name of the attachment, in the form
28
28
  # `spaces/{space}/messages/{message}/attachments/{attachment}`.
29
29
  # @!attribute [r] content_name
30
30
  # @return [::String]
@@ -34,8 +34,9 @@ module Google
34
34
  # Output only. The content type (MIME type) of the file.
35
35
  # @!attribute [rw] attachment_data_ref
36
36
  # @return [::Google::Apps::Chat::V1::AttachmentDataRef]
37
- # A reference to the attachment data. This field is used with the media API
38
- # to download the attachment data.
37
+ # Optional. A reference to the attachment data. This field is used to
38
+ # create or update messages with attachments, or with the media API to
39
+ # download the attachment data.
39
40
  # @!attribute [r] drive_data_ref
40
41
  # @return [::Google::Apps::Chat::V1::DriveDataRef]
41
42
  # Output only. A reference to the Google Drive attachment. This field is
@@ -82,13 +83,13 @@ module Google
82
83
  # A reference to the attachment data.
83
84
  # @!attribute [rw] resource_name
84
85
  # @return [::String]
85
- # The resource name of the attachment data. This field is used with the media
86
- # API to download the attachment data.
86
+ # Optional. The resource name of the attachment data. This field is used with
87
+ # the media API to download the attachment data.
87
88
  # @!attribute [rw] attachment_upload_token
88
89
  # @return [::String]
89
- # Opaque token containing a reference to an uploaded attachment. Treated by
90
- # clients as an opaque string and used to create or update Chat messages with
91
- # attachments.
90
+ # Optional. Opaque token containing a reference to an uploaded attachment.
91
+ # Treated by clients as an opaque string and used to create or update Chat
92
+ # messages with attachments.
92
93
  class AttachmentDataRef
93
94
  include ::Google::Protobuf::MessageExts
94
95
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -30,7 +30,8 @@ module Google
30
30
  include ::Google::Protobuf::MessageExts
31
31
  extend ::Google::Protobuf::MessageExts::ClassMethods
32
32
 
33
- # Who deleted the message and how it was deleted.
33
+ # Who deleted the message and how it was deleted. More values may be added in
34
+ # the future.
34
35
  module DeletionType
35
36
  # This value is unused.
36
37
  DELETION_TYPE_UNSPECIFIED = 0
@@ -25,7 +25,7 @@ module Google
25
25
  # Chat app is invited to, part of, or absent from a space.
26
26
  # @!attribute [rw] name
27
27
  # @return [::String]
28
- # Resource name of the membership, assigned by the server.
28
+ # Identifier. Resource name of the membership, assigned by the server.
29
29
  #
30
30
  # Format: `spaces/{space}/members/{member}`
31
31
  # @!attribute [r] state
@@ -39,7 +39,7 @@ module Google
39
39
  # This field can only be used as input in `UpdateMembership`.
40
40
  # @!attribute [rw] member
41
41
  # @return [::Google::Apps::Chat::V1::User]
42
- # The Google Chat user or app the membership corresponds to.
42
+ # Optional. The Google Chat user or app the membership corresponds to.
43
43
  # If your Chat app [authenticates as a
44
44
  # user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
45
45
  # the output populates the
@@ -47,7 +47,10 @@ module Google
47
47
  # `name` and `type`.
48
48
  # @!attribute [rw] group_member
49
49
  # @return [::Google::Apps::Chat::V1::Group]
50
- # The Google Group the membership corresponds to.
50
+ # Optional. The Google Group the membership corresponds to.
51
+ #
52
+ # Reading or mutating memberships for Google Groups requires [user
53
+ # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
51
54
  # @!attribute [rw] create_time
52
55
  # @return [::Google::Protobuf::Timestamp]
53
56
  # Optional. Immutable. The creation time of the membership, such as when a
@@ -111,24 +114,45 @@ module Google
111
114
  # @!attribute [rw] membership
112
115
  # @return [::Google::Apps::Chat::V1::Membership]
113
116
  # Required. The membership relation to create.
117
+ #
114
118
  # The `memberType` field must contain a user with the `user.name` and
115
119
  # `user.type` fields populated. The server will assign a resource name
116
120
  # and overwrite anything specified.
121
+ #
117
122
  # When a Chat app creates a membership relation for a human user, it must use
118
- # the `chat.memberships` scope, set `user.type` to `HUMAN`, and set
119
- # `user.name` with format `users/{user}`, where `{user}` can be the email
120
- # address for the user. For users in the same Workspace organization `{user}`
121
- # can also be the `id` of the
122
- # [person](https://developers.google.com/people/api/rest/v1/people) from the
123
- # People API, or the `id` for the user in the Directory API. For example, if
124
- # the People API Person profile ID for `user@example.com` is `123456789`, you
125
- # can add the user to the space by setting the `membership.member.name` to
126
- # `users/user@example.com` or `users/123456789`. When a Chat app creates a
127
- # membership relation for itself, it must use the `chat.memberships.app`
128
- # scope, set `user.type` to `BOT`, and set `user.name` to `users/app`.
123
+ # certain authorization scopes and set specific values for certain fields:
124
+ #
125
+ # - When [authenticating as a
126
+ # user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
127
+ # the `chat.memberships` authorization scope is required.
128
+ #
129
+ # - When [authenticating as an
130
+ # app](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app),
131
+ # the `chat.app.memberships` authorization scope is required.
132
+ # Authenticating as an app is available in [Developer
133
+ # Preview](https://developers.google.com/workspace/preview).
134
+ #
135
+ # - Set `user.type` to `HUMAN`, and set `user.name` with format
136
+ # `users/{user}`, where `{user}` can be the email address for the user. For
137
+ # users in the same Workspace organization `{user}` can also be the `id` of
138
+ # the [person](https://developers.google.com/people/api/rest/v1/people) from
139
+ # the People API, or the `id` for the user in the Directory API. For example,
140
+ # if the People API Person profile ID for `user@example.com` is `123456789`,
141
+ # you can add the user to the space by setting the `membership.member.name`
142
+ # to `users/user@example.com` or `users/123456789`.
143
+ #
144
+ # Inviting users external to the Workspace organization that owns the space
145
+ # requires [user
146
+ # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
147
+ #
148
+ # When a Chat app creates a membership relation for itself, it must
149
+ # [authenticate as a
150
+ # user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
151
+ # and use the `chat.memberships.app` scope, set `user.type` to `BOT`, and set
152
+ # `user.name` to `users/app`.
129
153
  # @!attribute [rw] use_admin_access
130
154
  # @return [::Boolean]
131
- # When `true`, the method runs using the user's Google Workspace
155
+ # Optional. When `true`, the method runs using the user's Google Workspace
132
156
  # administrator privileges.
133
157
  #
134
158
  # The calling user must be a Google Workspace administrator with the
@@ -161,7 +185,7 @@ module Google
161
185
  # - `role`
162
186
  # @!attribute [rw] use_admin_access
163
187
  # @return [::Boolean]
164
- # When `true`, the method runs using the user's Google Workspace
188
+ # Optional. When `true`, the method runs using the user's Google Workspace
165
189
  # administrator privileges.
166
190
  #
167
191
  # The calling user must be a Google Workspace administrator with the
@@ -261,7 +285,7 @@ module Google
261
285
  # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
262
286
  # @!attribute [rw] use_admin_access
263
287
  # @return [::Boolean]
264
- # When `true`, the method runs using the user's Google Workspace
288
+ # Optional. When `true`, the method runs using the user's Google Workspace
265
289
  # administrator privileges.
266
290
  #
267
291
  # The calling user must be a Google Workspace administrator with the
@@ -302,14 +326,12 @@ module Google
302
326
  #
303
327
  # Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`
304
328
  #
305
- # When [authenticated as a
306
- # user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
307
- # you can use the user's email as an alias for `{member}`. For example,
329
+ # You can use the user's email as an alias for `{member}`. For example,
308
330
  # `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the
309
331
  # email of the Google Chat user.
310
332
  # @!attribute [rw] use_admin_access
311
333
  # @return [::Boolean]
312
- # When `true`, the method runs using the user's Google Workspace
334
+ # Optional. When `true`, the method runs using the user's Google Workspace
313
335
  # administrator privileges.
314
336
  #
315
337
  # The calling user must be a Google Workspace administrator with the
@@ -345,7 +367,7 @@ module Google
345
367
  # Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`.
346
368
  # @!attribute [rw] use_admin_access
347
369
  # @return [::Boolean]
348
- # When `true`, the method runs using the user's Google Workspace
370
+ # Optional. When `true`, the method runs using the user's Google Workspace
349
371
  # administrator privileges.
350
372
  #
351
373
  # The calling user must be a Google Workspace administrator with the
@@ -24,7 +24,7 @@ module Google
24
24
  # A message in a Google Chat space.
25
25
  # @!attribute [rw] name
26
26
  # @return [::String]
27
- # Resource name of the message.
27
+ # Identifier. Resource name of the message.
28
28
  #
29
29
  # Format: `spaces/{space}/messages/{message}`
30
30
  #
@@ -66,10 +66,10 @@ module Google
66
66
  # Google Chat. If the message is never deleted, this field is empty.
67
67
  # @!attribute [rw] text
68
68
  # @return [::String]
69
- # Plain-text body of the message. The first link to an image, video, or web
70
- # page generates a
71
- # [preview chip](https://developers.google.com/workspace/chat/preview-links).
72
- # You can also [@mention a Google Chat
69
+ # Optional. Plain-text body of the message. The first link to an image,
70
+ # video, or web page generates a [preview
71
+ # chip](https://developers.google.com/workspace/chat/preview-links). You can
72
+ # also [@mention a Google Chat
73
73
  # user](https://developers.google.com/workspace/chat/format-messages#messages-@mention),
74
74
  # or everyone in the space.
75
75
  #
@@ -111,7 +111,7 @@ module Google
111
111
  # `cards_v2` can have a maximum size of 32 KB.
112
112
  # @!attribute [rw] cards_v2
113
113
  # @return [::Array<::Google::Apps::Chat::V1::CardWithId>]
114
- # An array of
114
+ # Optional. An array of
115
115
  # [cards](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards).
116
116
  #
117
117
  # Only Chat apps can create cards. If your Chat app [authenticates as a
@@ -130,17 +130,17 @@ module Google
130
130
  # The thread the message belongs to. For example usage, see
131
131
  # [Start or reply to a message
132
132
  # thread](https://developers.google.com/workspace/chat/create-messages#create-message-thread).
133
- # @!attribute [rw] space
133
+ # @!attribute [r] space
134
134
  # @return [::Google::Apps::Chat::V1::Space]
135
- # If your Chat app [authenticates as a
135
+ # Output only. If your Chat app [authenticates as a
136
136
  # user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
137
- # the output populates the
137
+ # the output only populates the
138
138
  # [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)
139
139
  # `name`.
140
140
  # @!attribute [rw] fallback_text
141
141
  # @return [::String]
142
- # A plain-text description of the message's cards, used when the actual cards
143
- # can't be displayed—for example, mobile notifications.
142
+ # Optional. A plain-text description of the message's cards, used when the
143
+ # actual cards can't be displayed—for example, mobile notifications.
144
144
  # @!attribute [rw] action_response
145
145
  # @return [::Google::Apps::Chat::V1::ActionResponse]
146
146
  # Input only. Parameters that a Chat app can use to configure how its
@@ -154,7 +154,7 @@ module Google
154
154
  # Output only. Slash command information, if applicable.
155
155
  # @!attribute [rw] attachment
156
156
  # @return [::Array<::Google::Apps::Chat::V1::Attachment>]
157
- # User-uploaded attachment.
157
+ # Optional. User-uploaded attachment.
158
158
  # @!attribute [r] matched_url
159
159
  # @return [::Google::Apps::Chat::V1::MatchedUrl]
160
160
  # Output only. A URL in `spaces.messages.text` that matches a link preview
@@ -181,10 +181,10 @@ module Google
181
181
  # Output only. The list of emoji reaction summaries on the message.
182
182
  # @!attribute [rw] private_message_viewer
183
183
  # @return [::Google::Apps::Chat::V1::User]
184
- # Immutable. Input for creating a message, otherwise output only. The user
185
- # that can view the message. When set, the message is private and only
186
- # visible to the specified user and the Chat app. To include this field in
187
- # your request, you must call the Chat API using [app
184
+ # Optional. Immutable. Input for creating a message, otherwise output only.
185
+ # The user that can view the message. When set, the message is private and
186
+ # only visible to the specified user and the Chat app. To include this field
187
+ # in your request, you must call the Chat API using [app
188
188
  # authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
189
189
  # and omit the following:
190
190
  #
@@ -207,10 +207,10 @@ module Google
207
207
  # Output only. GIF images that are attached to the message.
208
208
  # @!attribute [rw] accessory_widgets
209
209
  # @return [::Array<::Google::Apps::Chat::V1::AccessoryWidget>]
210
- # One or more interactive widgets that appear at the bottom of a message.
211
- # You can add accessory widgets to messages that contain text, cards, or both
212
- # text and cards. Not supported for messages that contain dialogs. For
213
- # details, see [Add interactive widgets at the bottom of a
210
+ # Optional. One or more interactive widgets that appear at the bottom of a
211
+ # message. You can add accessory widgets to messages that contain text,
212
+ # cards, or both text and cards. Not supported for messages that contain
213
+ # dialogs. For details, see [Add interactive widgets at the bottom of a
214
214
  # message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets).
215
215
  #
216
216
  # Creating a message with accessory widgets requires [app
@@ -254,7 +254,7 @@ module Google
254
254
  # field to determine what happens if no matching thread is found.
255
255
  # @!attribute [rw] name
256
256
  # @return [::String]
257
- # Resource name of the thread.
257
+ # Identifier. Resource name of the thread.
258
258
  #
259
259
  # Example: `spaces/{space}/threads/{thread}`
260
260
  # @!attribute [rw] thread_key
@@ -301,8 +301,8 @@ module Google
301
301
  extend ::Google::Protobuf::MessageExts::ClassMethods
302
302
  end
303
303
 
304
- # The response of the updated widget.
305
- # Used to provide autocomplete options for a widget.
304
+ # For `selectionInput` widgets, returns autocomplete suggestions for a
305
+ # multiselect menu.
306
306
  # @!attribute [rw] suggestions
307
307
  # @return [::Google::Apps::Chat::V1::ActionResponse::SelectionItems]
308
308
  # List of widget autocomplete results
@@ -384,8 +384,8 @@ module Google
384
384
  # (https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
385
385
  # @!attribute [rw] force
386
386
  # @return [::Boolean]
387
- # When `true`, deleting a message also deletes its threaded replies. When
388
- # `false`, if a message has threaded replies, deletion fails.
387
+ # Optional. When `true`, deleting a message also deletes its threaded
388
+ # replies. When `false`, if a message has threaded replies, deletion fails.
389
389
  #
390
390
  # Only applies when [authenticating as a
391
391
  # user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -458,6 +458,12 @@ module Google
458
458
  # @return [::Google::Apps::Chat::V1::CreateMessageRequest::MessageReplyOption]
459
459
  # Optional. Specifies whether a message starts a thread or replies to one.
460
460
  # Only supported in named spaces.
461
+ #
462
+ # When [responding to user
463
+ # interactions](https://developers.google.com/workspace/chat/receive-respond-interactions),
464
+ # this field is ignored. For interactions within a thread, the reply is
465
+ # created in the same thread. Otherwise, the reply is created as a new
466
+ # thread.
461
467
  # @!attribute [rw] message_id
462
468
  # @return [::String]
463
469
  # Optional. A custom ID for a message. Lets Chat apps get, update, or delete
@@ -510,8 +516,8 @@ module Google
510
516
  # Format: `spaces/{space}`
511
517
  # @!attribute [rw] page_size
512
518
  # @return [::Integer]
513
- # The maximum number of messages returned. The service might return fewer
514
- # messages than this value.
519
+ # Optional. The maximum number of messages returned. The service might return
520
+ # fewer messages than this value.
515
521
  #
516
522
  # If unspecified, at most 25 are returned.
517
523
  #
@@ -521,17 +527,15 @@ module Google
521
527
  # Negative values return an `INVALID_ARGUMENT` error.
522
528
  # @!attribute [rw] page_token
523
529
  # @return [::String]
524
- # Optional, if resuming from a previous query.
525
- #
526
- # A page token received from a previous list messages call. Provide this
527
- # parameter to retrieve the subsequent page.
530
+ # Optional. A page token received from a previous list messages call. Provide
531
+ # this parameter to retrieve the subsequent page.
528
532
  #
529
533
  # When paginating, all other parameters provided should match the call that
530
534
  # provided the page token. Passing different values to the other parameters
531
535
  # might lead to unexpected results.
532
536
  # @!attribute [rw] filter
533
537
  # @return [::String]
534
- # A query filter.
538
+ # Optional. A query filter.
535
539
  #
536
540
  # You can filter messages by date (`create_time`) and thread (`thread.name`).
537
541
  #
@@ -570,10 +574,8 @@ module Google
570
574
  # error.
571
575
  # @!attribute [rw] order_by
572
576
  # @return [::String]
573
- # Optional, if resuming from a previous query.
574
- #
575
- # How the list of messages is ordered. Specify a value to order by an
576
- # ordering operation. Valid ordering operation values are as follows:
577
+ # Optional. How the list of messages is ordered. Specify a value to order by
578
+ # an ordering operation. Valid ordering operation values are as follows:
577
579
  #
578
580
  # - `ASC` for ascending.
579
581
  #
@@ -582,8 +584,9 @@ module Google
582
584
  # The default ordering is `create_time ASC`.
583
585
  # @!attribute [rw] show_deleted
584
586
  # @return [::Boolean]
585
- # Whether to include deleted messages. Deleted messages include deleted time
586
- # and metadata about their deletion, but message content is unavailable.
587
+ # Optional. Whether to include deleted messages. Deleted messages include
588
+ # deleted time and metadata about their deletion, but message content is
589
+ # unavailable.
587
590
  class ListMessagesRequest
588
591
  include ::Google::Protobuf::MessageExts
589
592
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -24,7 +24,7 @@ module Google
24
24
  # A reaction to a message.
25
25
  # @!attribute [rw] name
26
26
  # @return [::String]
27
- # The resource name of the reaction.
27
+ # Identifier. The resource name of the reaction.
28
28
  #
29
29
  # Format: `spaces/{space}/messages/{message}/reactions/{reaction}`
30
30
  # @!attribute [r] user
@@ -32,7 +32,7 @@ module Google
32
32
  # Output only. The user who created the reaction.
33
33
  # @!attribute [rw] emoji
34
34
  # @return [::Google::Apps::Chat::V1::Emoji]
35
- # The emoji used in the reaction.
35
+ # Required. The emoji used in the reaction.
36
36
  class Reaction
37
37
  include ::Google::Protobuf::MessageExts
38
38
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -41,7 +41,7 @@ module Google
41
41
  # An emoji that is used as a reaction to a message.
42
42
  # @!attribute [rw] unicode
43
43
  # @return [::String]
44
- # A basic emoji represented by a unicode string.
44
+ # Optional. A basic emoji represented by a unicode string.
45
45
  # @!attribute [r] custom_emoji
46
46
  # @return [::Google::Apps::Chat::V1::CustomEmoji]
47
47
  # Output only. A custom emoji.
@@ -60,12 +60,12 @@ module Google
60
60
  end
61
61
 
62
62
  # The number of people who reacted to a message with a specific emoji.
63
- # @!attribute [rw] emoji
63
+ # @!attribute [r] emoji
64
64
  # @return [::Google::Apps::Chat::V1::Emoji]
65
- # Emoji associated with the reactions.
66
- # @!attribute [rw] reaction_count
65
+ # Output only. Emoji associated with the reactions.
66
+ # @!attribute [r] reaction_count
67
67
  # @return [::Integer]
68
- # The total number of reactions using the associated emoji.
68
+ # Output only. The total number of reactions using the associated emoji.
69
69
  class EmojiReactionSummary
70
70
  include ::Google::Protobuf::MessageExts
71
71
  extend ::Google::Protobuf::MessageExts::ClassMethods