Method: customEmojis.list

Lists custom emojis visible to the authenticated user.

Requires user authentication.

HTTP request

GET https://chat.googleapis.com/v1/customEmojis

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
pageSize

integer

Optional. The maximum number of custom emoji returned. The service can return fewer custom emoji 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 custom emoji 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.
filter

string

Optional. A query filter.

Supports filtering by creator.

To filter by creator, you must specify a valid value. Currently only creator("users/me") and NOT creator("users/me") are accepted to filter custom emoji by whether they were created by the calling user or not.

For example, the following query returns custom emoji created by the caller:

creator("users/me")

Invalid queries are rejected by the server with an INVALID_ARGUMENT error.

Request body

The request body must be empty.

Response body

A response to a list of custom emoji.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "customEmojis": [
    {
      object (CustomEmoji)
    }
  ],
  "nextPageToken": string
}
Fields
customEmojis[]

object (CustomEmoji)

Unordered list. List of custom emoji in the requested (or first) page.
nextPageToken

string

A token that you can send as pageToken to retrieve the next page of results. If empty, there are no subsequent pages.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

For more information, see the Authorization guide.