正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

GraphQLでカスタム絵文字を使用する

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

コメントや説明でカスタム絵文字を使用するには、GraphQL APIを使用してトップレベルグループに追加します。

カスタム絵文字を作成する

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

グループにカスタム絵文字を追加すると、メンバーはコメントで他の絵文字と同じように使用できます。

属性

このクエリは、次の属性を受け入れます:

属性型必須説明
group_path整数または文字列はいトップレベルグループのまたはURLエンコードされたパス。
name文字列はいカスタム絵文字の名前。
file文字列はいカスタム絵文字画像のURL。

GraphiQLを使用する

GraphiQLを使用して、グループの絵文字をクエリできます。

  1. GraphiQLを開きます:

    • GitLab.comの場合は、https://gitlab.com/-/graphql-explorerを使用します。
    • GitLab Self-Managedの場合は、https://gitlab.example.com/-/graphql-explorerを使用します。

  2. 次のテキストをコピーして、左側のウィンドウに貼り付けます。このクエリでは、gitlab-orgはグループパスです。

        query GetCustomEmoji {
      group(fullPath: "gitlab-org") {
        id
        customEmoji {
          nodes {
            name,
            url
          }
        }
      }
    }

  3. 再生を選択します。