Optional. Die maximale Anzahl der zurückgegebenen benutzerdefinierten Emojis. Der Dienst kann weniger benutzerdefinierte Emojis als dieser Wert zurückgeben. Wenn keine Angabe erfolgt, beträgt der Standardwert 25. Der Höchstwert ist 200. Werte über 200 werden in 200 geändert.
pageToken
string
Optional. (Bei Fortsetzung einer vorherigen Abfrage.)
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. Die Übergabe eines anderen Werts kann zu unerwarteten Ergebnissen führen.
filter
string
Optional. Einen Abfragefilter.
Unterstützt das Filtern nach Creator.
Wenn du nach Creator filtern möchtest, musst du einen gültigen Wert angeben. Derzeit werden nur creator("users/me") und NOT creator("users/me") akzeptiert, um benutzerdefinierte Emojis danach zu filtern, ob sie vom aufrufenden Nutzer erstellt wurden oder nicht.
Die folgende Abfrage gibt beispielsweise benutzerdefinierte Emojis zurück, die vom Aufrufer erstellt wurden:
creator("users/me")
Ungültige Anfragen werden vom Server mit dem Fehler INVALID_ARGUMENT abgelehnt.
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Antwort auf eine Liste benutzerdefinierter Emojis.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2024-11-12 (UTC)."],[[["Lists custom emojis visible to the authenticated user, requiring user authentication and specific authorization scopes."],["Allows filtering by creator to see emojis created by the calling user or others."],["Supports pagination to retrieve large lists of custom emojis, with a default page size of 25 and a maximum of 200."],["Returns a list of custom emojis and a token for retrieving subsequent pages if available."],["Requires an empty request body and provides a structured JSON response containing emoji details."]]],["This document details how to list custom emojis in Google Chat via an HTTP GET request to `https://chat.googleapis.com/v1/customEmojis`. The request requires user authentication and supports optional query parameters: `pageSize` (default 25, max 200), `pageToken` (for pagination), and `filter` (to filter by emoji creator). The request body must be empty. The response includes a list of `customEmojis` and an optional `nextPageToken` for pagination. Authorization requires either `chat.customemojis` or `chat.customemojis.readonly` scope.\n"]]
