blob: f7bbee72ca3771cfa94a33631ab496636a1db4ca [file] [edit]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="chat_v1.html">Google Chat API</a> . <a href="chat_v1.spaces.html">spaces</a> . <a href="chat_v1.spaces.messages.html">messages</a> . <a href="chat_v1.spaces.messages.reactions.html">reactions</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a reaction and adds it to a message. For an example, see [Create a reaction](https://developers.google.com/chat/api/guides/v1/reactions/create). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages`, `chat.messages.reactions`, or `chat.messages.reactions.create` scope. Only unicode emoji are supported.</p>
<p class="toc_element">
<code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes a reaction to a message. For an example, see [Delete a reaction](https://developers.google.com/chat/api/guides/v1/reactions/delete). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages` or `chat.messages.reactions` scope.</p>
<p class="toc_element">
<code><a href="#list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists reactions to a message. For an example, see [List reactions](https://developers.google.com/chat/api/guides/v1/reactions/list). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and `chat.messages`, `chat.messages.readonly`, `chat.messages.reactions`, or `chat.messages.reactions.readonly` scope.</p>
<p class="toc_element">
<code><a href="#list_next">list_next()</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
<pre>Creates a reaction and adds it to a message. For an example, see [Create a reaction](https://developers.google.com/chat/api/guides/v1/reactions/create). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages`, `chat.messages.reactions`, or `chat.messages.reactions.create` scope. Only unicode emoji are supported.
Args:
parent: string, Required. The message where the reaction is created. Format: `spaces/{space}/messages/{message}` (required)
body: object, The request body.
The object takes the form of:
{ # A reaction to a message.
&quot;emoji&quot;: { # An emoji that is used as a reaction to a message. # The emoji used in the reaction.
&quot;customEmoji&quot;: { # Represents a custom emoji. # Output only. A custom emoji.
&quot;uid&quot;: &quot;A String&quot;, # Unique key for the custom emoji resource.
},
&quot;unicode&quot;: &quot;A String&quot;, # A basic emoji represented by a unicode string.
},
&quot;name&quot;: &quot;A String&quot;, # The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}`
&quot;user&quot;: { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/chat/api/guides/auth/users), the output for a `User` resource only populates the user&#x27;s `name` and `type`. # Output only. The user who created the reaction.
&quot;displayName&quot;: &quot;A String&quot;, # Output only. The user&#x27;s display name.
&quot;domainId&quot;: &quot;A String&quot;, # Unique identifier of the user&#x27;s Google Workspace domain.
&quot;isAnonymous&quot;: True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
&quot;name&quot;: &quot;A String&quot;, # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `{person_id`} for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API, where the Person `resource_name` is `people/{person_id}`. For example, `users/123456789` in Chat API represents the same person as `people/123456789` in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API.
&quot;type&quot;: &quot;A String&quot;, # User type.
},
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A reaction to a message.
&quot;emoji&quot;: { # An emoji that is used as a reaction to a message. # The emoji used in the reaction.
&quot;customEmoji&quot;: { # Represents a custom emoji. # Output only. A custom emoji.
&quot;uid&quot;: &quot;A String&quot;, # Unique key for the custom emoji resource.
},
&quot;unicode&quot;: &quot;A String&quot;, # A basic emoji represented by a unicode string.
},
&quot;name&quot;: &quot;A String&quot;, # The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}`
&quot;user&quot;: { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/chat/api/guides/auth/users), the output for a `User` resource only populates the user&#x27;s `name` and `type`. # Output only. The user who created the reaction.
&quot;displayName&quot;: &quot;A String&quot;, # Output only. The user&#x27;s display name.
&quot;domainId&quot;: &quot;A String&quot;, # Unique identifier of the user&#x27;s Google Workspace domain.
&quot;isAnonymous&quot;: True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
&quot;name&quot;: &quot;A String&quot;, # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `{person_id`} for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API, where the Person `resource_name` is `people/{person_id}`. For example, `users/123456789` in Chat API represents the same person as `people/123456789` in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API.
&quot;type&quot;: &quot;A String&quot;, # User type.
},
}</pre>
</div>
<div class="method">
<code class="details" id="delete">delete(name, x__xgafv=None)</code>
<pre>Deletes a reaction to a message. For an example, see [Delete a reaction](https://developers.google.com/chat/api/guides/v1/reactions/delete). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.messages` or `chat.messages.reactions` scope.
Args:
name: string, Required. Name of the reaction to delete. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}</pre>
</div>
<div class="method">
<code class="details" id="list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists reactions to a message. For an example, see [List reactions](https://developers.google.com/chat/api/guides/v1/reactions/list). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and `chat.messages`, `chat.messages.readonly`, `chat.messages.reactions`, or `chat.messages.reactions.readonly` scope.
Args:
parent: string, Required. The message users reacted to. Format: `spaces/{space}/messages/{message}` (required)
filter: string, Optional. A query filter. You can filter reactions by [emoji](https://developers.google.com/chat/api/reference/rest/v1/Emoji) (either `emoji.unicode` or `emoji.custom_emoji.uid`) and [user](https://developers.google.com/chat/api/reference/rest/v1/User) (`user.name`). To filter reactions for multiple emojis or users, join similar fields with the `OR` operator, such as `emoji.unicode = &quot;🙂&quot; OR emoji.unicode = &quot;👍&quot;` and `user.name = &quot;users/AAAAAA&quot; OR user.name = &quot;users/BBBBBB&quot;`. To filter reactions by emoji and user, use the `AND` operator, such as `emoji.unicode = &quot;🙂&quot; AND user.name = &quot;users/AAAAAA&quot;`. If your query uses both `AND` and `OR`, group them with parentheses. For example, the following queries are valid: ``` user.name = &quot;users/{user}&quot; emoji.unicode = &quot;🙂&quot; emoji.custom_emoji.uid = &quot;{uid}&quot; emoji.unicode = &quot;🙂&quot; OR emoji.unicode = &quot;👍&quot; emoji.unicode = &quot;🙂&quot; OR emoji.custom_emoji.uid = &quot;{uid}&quot; emoji.unicode = &quot;🙂&quot; AND user.name = &quot;users/{user}&quot; (emoji.unicode = &quot;🙂&quot; OR emoji.custom_emoji.uid = &quot;{uid}&quot;) AND user.name = &quot;users/{user}&quot; ``` The following queries are invalid: ``` emoji.unicode = &quot;🙂&quot; AND emoji.unicode = &quot;👍&quot; emoji.unicode = &quot;🙂&quot; AND emoji.custom_emoji.uid = &quot;{uid}&quot; emoji.unicode = &quot;🙂&quot; OR user.name = &quot;users/{user}&quot; emoji.unicode = &quot;🙂&quot; OR emoji.custom_emoji.uid = &quot;{uid}&quot; OR user.name = &quot;users/{user}&quot; emoji.unicode = &quot;🙂&quot; OR emoji.custom_emoji.uid = &quot;{uid}&quot; AND user.name = &quot;users/{user}&quot; ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.
pageSize: integer, Optional. The maximum number of reactions returned. The service can return fewer reactions than this value. If unspecified, the default value is 25. The maximum value is 200; values above 200 are changed to 200.
pageToken: string, Optional. (If resuming from a previous query.) A page token received from a previous list reactions call. Provide this to retrieve the subsequent page. When paginating, the filter value should match the call that provided the page token. Passing a different value might lead to unexpected results.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{
&quot;nextPageToken&quot;: &quot;A String&quot;, # Continuation token to retrieve the next page of results. It&#x27;s empty for the last page of results.
&quot;reactions&quot;: [ # List of reactions in the requested (or first) page.
{ # A reaction to a message.
&quot;emoji&quot;: { # An emoji that is used as a reaction to a message. # The emoji used in the reaction.
&quot;customEmoji&quot;: { # Represents a custom emoji. # Output only. A custom emoji.
&quot;uid&quot;: &quot;A String&quot;, # Unique key for the custom emoji resource.
},
&quot;unicode&quot;: &quot;A String&quot;, # A basic emoji represented by a unicode string.
},
&quot;name&quot;: &quot;A String&quot;, # The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}`
&quot;user&quot;: { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/chat/api/guides/auth/users), the output for a `User` resource only populates the user&#x27;s `name` and `type`. # Output only. The user who created the reaction.
&quot;displayName&quot;: &quot;A String&quot;, # Output only. The user&#x27;s display name.
&quot;domainId&quot;: &quot;A String&quot;, # Unique identifier of the user&#x27;s Google Workspace domain.
&quot;isAnonymous&quot;: True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
&quot;name&quot;: &quot;A String&quot;, # Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `{person_id`} for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API, where the Person `resource_name` is `people/{person_id}`. For example, `users/123456789` in Chat API represents the same person as `people/123456789` in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API.
&quot;type&quot;: &quot;A String&quot;, # User type.
},
},
],
}</pre>
</div>
<div class="method">
<code class="details" id="list_next">list_next()</code>
<pre>Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call &#x27;execute()&#x27; on to request the next
page. Returns None if there are no more items in the collection.
</pre>
</div>
</body></html>