Method: customEmojis.list

認証されたユーザーに表示されるカスタム絵文字を一覧表示します。

ユーザー認証が必要です。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
pageSize

integer

省略可。返されるカスタム絵文字の最大数。このサービスは、この値よりも少ないカスタム絵文字を返すことができます。指定しない場合、デフォルト値は 25 です。最大値は 200 で、200 を超える値は 200 に変更されます。
pageToken

string

省略可。（前のクエリから再開する場合）。

直前のカスタム絵文字呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページ分割を行う場合、フィルタ値は、ページトークンを提供した呼び出しと一致する必要があります。別の値を渡すと、予期しない結果になる可能性があります。
filter

string

省略可。クエリフィルタ。

クリエイターによるフィルタリングがサポートされています。

クリエイター別にフィルタするには、有効な値を指定する必要があります。現在、呼び出し元のユーザーによって作成されたかどうかでカスタム絵文字をフィルタするには、creator("users/me") と NOT creator("users/me") のみが使用できます。

たとえば、次のクエリは、呼び出し元によって作成されたカスタム絵文字を返します。

creator("users/me")

無効なクエリは、サーバーによって INVALID_ARGUMENT エラーで拒否されます。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

カスタム絵文字のリストに対する返信。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "customEmojis": [
    {
      object (CustomEmoji)
    }
  ],
  "nextPageToken": string
}
フィールド
customEmojis[]

object (CustomEmoji)

順序なしリスト。リクエストされた（または最初の）ページのカスタム絵文字のリスト。
nextPageToken

string

結果の次のページを取得するために pageToken として送信できるトークン。空の場合、後続のページはありません。

認可スコープ

次の OAuth スコープのいずれかが必要です。

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

詳細については、承認ガイドをご覧ください。