Method: customEmojis.list

Wyświetla niestandardowe emotikony widoczne dla uwierzytelnionego użytkownika.

Emotikony niestandardowe są dostępne tylko na kontach Google Workspace, a administrator musi włączyć je w organizacji. Więcej informacji znajdziesz w artykułach Więcej informacji o niestandardowych emotikonach w Google Chat i Zarządzanie uprawnieniami do niestandardowych emotikonów.

Wymaga uwierzytelniania użytkownika za pomocą jednego z tych zakresów autoryzacji:

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie. Maksymalna liczba zwracanych niestandardowych emotikonów. Usługa może zwrócić mniej emotikonów niż ta wartość. Jeśli nie określisz wartości, stosowana jest wartość domyślna (25). Maksymalna wartość to 200; wartości powyżej 200 są zmieniane na 200.
pageToken

string

Opcjonalnie. (jeśli wznawiasz działanie po poprzednim zapytaniu).

Token strony otrzymany z poprzedniego wywołania listy niestandardowych emotikonów. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wartość filtra powinna być zgodna z wywołaniem, które dostarczyło token strony. Podanie innej wartości może prowadzić do nieoczekiwanych wyników.
filter

string

Opcjonalnie. Filtr zapytania.

Obsługuje filtrowanie według twórcy.

Aby filtrować według twórcy, musisz podać prawidłową wartość. Obecnie do filtrowania emotikonów niestandardowych według tego, czy zostały one utworzone przez dzwoniącego użytkownika, czy nie, akceptowane są tylko wartości creator("users/me") i NOT creator("users/me").

Na przykład to zapytanie zwraca niestandardowe emotikony utworzone przez wywołującego:

creator("users/me")

Nieprawidłowe zapytania są odrzucane z błędem INVALID_ARGUMENT.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na listę niestandardowych emotikonów.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "customEmojis": [
    {
      object (CustomEmoji)
    }
  ],
  "nextPageToken": string
}
Pola
customEmojis[]

object (CustomEmoji)

Lista nieuporządkowana. Lista niestandardowych emotikonów.
nextPageToken

string

Token, który możesz wysłać jako pageToken, aby pobrać następną stronę wyników. Jeśli jest puste, nie ma kolejnych stron.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.