Class SpacesResource.MessagesResource.ListRequest
Lists messages in a space that the caller is a member of, including messages from blocked members and
spaces. If you list messages from a space with no messages, the response is an empty object. When using
a REST/HTTP interface, the response contains an empty JSON object, {}
. For an example, see List
messages. Requires user
authentication.
Inheritance
Inherited Members
Namespace: Google.Apis.HangoutsChat.v1
Assembly: Google.Apis.HangoutsChat.v1.dll
Syntax
public class SpacesResource.MessagesResource.ListRequest : HangoutsChatBaseServiceRequest<ListMessagesResponse>, IClientServiceRequest<ListMessagesResponse>, IClientServiceRequest
Constructors
ListRequest(IClientService, string)
Constructs a new List request.
Declaration
public ListRequest(IClientService service, string parent)
Parameters
Type | Name | Description |
---|---|---|
IClientService | service | |
string | parent |
Properties
Filter
Optional. A query filter. You can filter messages by date (create_time
) and thread
(thread.name
). To filter messages by the date they were created, specify the create_time
with a
timestamp in RFC-3339 format and double quotation marks.
For example, "2023-04-21T11:30:00-04:00"
. You can use the greater than operator >
to list
messages that were created after a timestamp, or the less than operator <
to list messages
that were created before a timestamp. To filter messages within a time interval, use the AND
operator between two timestamps. To filter by thread, specify the thread.name
, formatted as
spaces/{space}/threads/{thread}
. You can only specify one thread.name
per query. To filter by
both thread and date, use the AND
operator in your query. For example, the following queries are
valid:
create_time > "2012-04-21T11:30:00-04:00" create_time >
"2012-04-21T11:30:00-04:00" AND thread.name = spaces/AAAAAAAAAAA/threads/123 create_time >
"2012-04-21T11:30:00+00:00" AND create_time < "2013-01-01T00:00:00+00:00" AND thread.name =
spaces/AAAAAAAAAAA/threads/123 thread.name = spaces/AAAAAAAAAAA/threads/123
Invalid queries are
rejected by the server with an INVALID_ARGUMENT
error.
Declaration
[RequestParameter("filter", RequestParameterType.Query)]
public virtual string Filter { get; set; }
Property Value
Type | Description |
---|---|
string |
HttpMethod
Gets the HTTP method.
Declaration
public override string HttpMethod { get; }
Property Value
Type | Description |
---|---|
string |
Overrides
MethodName
Gets the method name.
Declaration
public override string MethodName { get; }
Property Value
Type | Description |
---|---|
string |
Overrides
OrderBy
Optional. How the list of messages is ordered. Specify a value to order by an ordering operation.
Valid ordering operation values are as follows: - ASC
for ascending. - DESC
for descending. The
default ordering is create_time ASC
.
Declaration
[RequestParameter("orderBy", RequestParameterType.Query)]
public virtual string OrderBy { get; set; }
Property Value
Type | Description |
---|---|
string |
PageSize
Optional. The maximum number of messages returned. The service might return fewer messages than this
value. If unspecified, at most 25 are returned. The maximum value is 1000. If you use a value more
than 1000, it's automatically changed to 1000. Negative values return an INVALID_ARGUMENT
error.
Declaration
[RequestParameter("pageSize", RequestParameterType.Query)]
public virtual int? PageSize { get; set; }
Property Value
Type | Description |
---|---|
int? |
PageToken
Optional. A page token received from a previous list messages call. Provide this parameter to retrieve the subsequent page. When paginating, all other parameters provided should match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.
Declaration
[RequestParameter("pageToken", RequestParameterType.Query)]
public virtual string PageToken { get; set; }
Property Value
Type | Description |
---|---|
string |
Parent
Required. The resource name of the space to list messages from. Format: spaces/{space}
Declaration
[RequestParameter("parent", RequestParameterType.Path)]
public virtual string Parent { get; }
Property Value
Type | Description |
---|---|
string |
RestPath
Gets the REST path.
Declaration
public override string RestPath { get; }
Property Value
Type | Description |
---|---|
string |
Overrides
ShowDeleted
Optional. Whether to include deleted messages. Deleted messages include deleted time and metadata about their deletion, but message content is unavailable.
Declaration
[RequestParameter("showDeleted", RequestParameterType.Query)]
public virtual bool? ShowDeleted { get; set; }
Property Value
Type | Description |
---|---|
bool? |
Methods
InitParameters()
Initializes List parameter list.
Declaration
protected override void InitParameters()