Method: customEmojis.list

Répertorie les emoji personnalisés visibles par l'utilisateur authentifié.

Les emoji personnalisés ne sont disponibles que pour les comptes Google Workspace, et l'administrateur doit les activer pour l'organisation. Pour en savoir plus, consultez À propos des emoji personnalisés dans Google Chat et Gérer les autorisations pour les emoji personnalisés.

Nécessite l'authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants:

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

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal d'emoji personnalisés renvoyés. Le service peut renvoyer un nombre inférieur à cette valeur. Si elle n'est pas spécifiée, la valeur par défaut est 25. La valeur maximale est 200. Les valeurs supérieures sont remplacées par 200.
pageToken

string

Facultatif. (Si vous reprenez à partir d'une requête précédente.)

Jeton de page reçu lors d'un appel d'emoji personnalisés de liste précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, la valeur du filtre doit correspondre à l'appel ayant fourni le jeton de page. Transmettre une valeur différente peut entraîner des résultats inattendus.
filter

string

Facultatif. Filtre de requête

Prend en charge le filtrage par créateur.

Pour filtrer par créateur, vous devez spécifier une valeur valide. Pour le moment, seuls creator("users/me") et NOT creator("users/me") sont acceptés pour filtrer les emoji personnalisés selon qu'ils ont été créés par l'utilisateur appelant ou non.

Par exemple, la requête suivante renvoie les emoji personnalisés créés par l'appelant:

creator("users/me")

Les requêtes non valides sont rejetées avec une erreur INVALID_ARGUMENT.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse permettant de lister les emoji personnalisés.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "customEmojis": [
    {
      object (CustomEmoji)
    }
  ],
  "nextPageToken": string
}
Champs
customEmojis[]

object (CustomEmoji)

Liste non ordonnée. Liste des emoji personnalisés.
nextPageToken

string

Jeton que vous pouvez envoyer en tant que pageToken pour récupérer la page de résultats suivante. Si ce champ est vide, aucune page suivante n'existe.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez le guide d'autorisation.