Method: customEmojis.list

Listet benutzerdefinierte Emojis auf, die für den authentifizierten Nutzer sichtbar sind.

Benutzerdefinierte Emojis sind nur für Google Workspace-Konten verfügbar. Der Administrator muss sie für die Organisation aktivieren. Weitere Informationen finden Sie unter Weitere Informationen zu benutzerdefinierten Emojis in Google Chat und Berechtigungen für benutzerdefinierte Emojis verwalten.

Erfordert eine Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

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

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl der zurückgegebenen benutzerdefinierten Emojis. Der Dienst kann weniger benutzerdefinierte Emojis als diesen Wert zurückgeben. Wenn keine Angabe erfolgt, beträgt der Standardwert 25. Der Maximalwert ist 200. Werte über 200 werden in 200 geändert.
pageToken

string

Optional. (Wenn die Abfrage fortgesetzt wird.)

Ein Seitentoken, das von einem vorherigen Aufruf der Liste mit benutzerdefinierten Emojis empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren muss der Filterwert mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Wenn Sie einen anderen Wert übergeben, kann das zu unerwarteten Ergebnissen führen.
filter

string

Optional. Einen Abfragefilter.

Es wird die Filterung nach Creator unterstützt.

Wenn du nach Creator filtern möchtest, musst du einen gültigen Wert angeben. Derzeit können benutzerdefinierte Emojis nur mit creator("users/me") und NOT creator("users/me") danach gefiltert werden, ob sie vom anrufenden Nutzer erstellt wurden oder nicht.

Die folgende Abfrage gibt beispielsweise benutzerdefinierte Emojis zurück, die vom Anrufer erstellt wurden:

creator("users/me")

Ungültige Abfragen werden mit dem Fehler INVALID_ARGUMENT abgelehnt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Antwort, um benutzerdefinierte Emojis aufzulisten.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "customEmojis": [
    {
      object (CustomEmoji)
    }
  ],
  "nextPageToken": string
}
Felder
customEmojis[]

object (CustomEmoji)

Unsortierte Liste. Liste der benutzerdefinierten Emojis.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Ergebnisseite abzurufen. Wenn dieses Feld leer ist, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.