Back to Gitlabhq

Utiliser des emoji personnalisés avec GraphQL

doc-locale/fr-fr/api/graphql/custom_emoji.md

19.1.02.7 KB
Original Source

{{< details >}}

  • Édition : Gratuite, GitLab Premium, GitLab Ultimate
  • Offre : GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

{{< history >}}

{{< /history >}}

Pour utiliser des emoji personnalisés dans les commentaires et les descriptions, vous pouvez les ajouter à un groupe principal à l'aide de l'API GraphQL.

Créer un emoji personnalisé {#create-a-custom-emoji}

graphql
mutation CreateCustomEmoji($groupPath: ID!) {
  createCustomEmoji(input: {groupPath: $groupPath, name: "party-parrot", url: "https://cultofthepartyparrot.com/parrots/hd/parrot.gif"}) {
    clientMutationId
    customEmoji {
      name
    }
    errors
  }
}

Après avoir ajouté un emoji personnalisé au groupe, les membres peuvent l'utiliser de la même manière que les autres emoji dans les commentaires.

Attributs {#attributes}

La requête accepte ces attributs :

AttributTypeObligatoireDescription
group_pathentier ou chaîneOuiID ou chemin encodé en URL du groupe principal.
namestringOuiNom de l'emoji personnalisé.
filestringOuiURL de l'image de l'emoji personnalisé.

Utiliser GraphiQL {#use-graphiql}

Vous pouvez utiliser GraphiQL pour interroger les emoji d'un groupe.

  1. Ouvrez GraphiQL :

    • Pour GitLab.com, utilisez : https://gitlab.com/-/graphql-explorer
    • Pour GitLab Self-Managed, utilisez : https://gitlab.example.com/-/graphql-explorer
  2. Copiez le texte suivant et collez-le dans la fenêtre de gauche. Dans cette requête, gitlab-org est le chemin du groupe.

    graphql
        query GetCustomEmoji {
          group(fullPath: "gitlab-org") {
            id
            customEmoji {
              nodes {
                name,
                url
              }
            }
          }
        }
    
  3. Sélectionnez Play.