Content last updated 2026-05-26

カテゴリ

Zendesk のカテゴリに関するドキュメント

このガイドでは、GitLab における Zendesk カテゴリの作成・編集・管理方法について説明します。管理者は管理者タスクのセクションを確認してください。

技術詳細

デプロイタイプ: Standard
同期リポジトリ
- Zendesk Global
- Zendesk US Government
CustSuppOps Zendesk Test Suite Generator を有効化

カテゴリを理解する

カテゴリとは

Zendesk によると:

Categories are the top-level organizing containers of the help center. Categories contain sections. The help center must have at least one category. If you have only one category in your help center, then the category itself is hidden to end users, and they see only the sections in your help center.

ナレッジセンターは 3 階層の構造を使用します:

カテゴリ (最上位) - 主要なトピック領域を整理。本ページでドキュメント化
セクション (中間レベル) - カテゴリを関連グループに細分化。セクションページでドキュメント化
記事 (コンテンツレベル) - 個々のヘルプ記事。記事ページでドキュメント化

カテゴリの管理方法

Zendesk は UI からカテゴリをフルに管理する方法を提供していますが、私たちはよりバージョン管理されたメソドロジーを採用しています。これによって、定型化されたレビュープロセスや、必要に応じたロールバック等が可能になります。

そのため、私たちは同期リポジトリを利用しています。

現在使用中のカテゴリ

Zendesk Global
- About GitLab Support
- Knowledge articles
Zendesk US Government
- About GitLab Support
- Knowledge articles

非管理者としてカテゴリを作成する

カテゴリを作成するには、Feature Request issue を作成してください (Customer Support Operations チームによる手動対応が必要なため)。

非管理者としてカテゴリを編集する

カテゴリを変更するには、Feature Request issue を作成してください (Customer Support Operations チームによる手動対応が必要なため)。

非管理者としてカテゴリを削除する

カテゴリの非アクティブ化を要求するには、Feature Request issue を作成してください (Customer Support Operations チームによる手動対応が必要なため)。

管理者タスク

注意

このセクションのすべての項目は Zendesk への Administrator レベルのアクセスを必要とします。

Zendesk でカテゴリを表示する

Zendesk の現在のカテゴリを見るには:

Zendesk インスタンスのナレッジセンターダッシュボードに移動します
- プライマリブランドの場合:
- 内部ブランドの場合:
左側の Arrange content アイコンをクリックします
- プライマリブランドの場合:
- 内部ブランドの場合:

カテゴリを作成する

警告

対応するリクエスト Issue (Feature Request、Administrative、Bug 等) が存在する場合のみ実施してください。存在しない場合は、まず Issue を作成し、標準プロセスを通してから着手してください。
SEO への影響: カテゴリは URL 構造、検索インデックス、記事の発見可能性に影響します。カテゴリ名や構造を変更すると、既存のリンクが壊れたり、検索エンジンのランキングに影響したりする可能性があります。
カテゴリを変更する場合は注意してください。

カテゴリを作成するには、同期リポジトリでマージリクエストを作成する必要があります。具体的な変更内容はリクエスト次第です。利用できる開始テンプレートは以下です:

---
name: 'Your category name here'
previous_name: 'Your category name here'
description: 'Your description here'
locale: 'en-us' # This should always be used
position: 0 # Integer representing category display order
source_locale: 'en-us' # This should always be used

ピアがレビューしてマージリクエストを承認した後、マージリクエストをマージできます。次のデプロイが行われると、Zendesk に同期されます。

カテゴリを編集する

警告

対応するリクエスト Issue (Feature Request、Administrative、Bug 等) が存在する場合のみ実施してください。存在しない場合は、まず Issue を作成し、標準プロセスを通してから着手してください。
SEO への影響: カテゴリは URL 構造、検索インデックス、記事の発見可能性に影響します。カテゴリ名や構造を変更すると、既存のリンクが壊れたり、検索エンジンのランキングに影響したりする可能性があります。
カテゴリを変更する場合は注意してください。

カテゴリを編集するには、同期リポジトリでマージリクエストを作成する必要があります。具体的な変更内容はリクエスト次第です。

ピアがレビューしてマージリクエストを承認した後、マージリクエストをマージできます。次のデプロイが行われると、Zendesk に同期されます。

カテゴリの名前を変更する

カテゴリの名前を変更する必要がある場合、現在の値を previous_name 属性にコピーしてから name 属性を変更します。これにより、同期処理が引き続き対象のカテゴリを特定して更新できます。

カテゴリを削除する

危険

対応するリクエスト Issue (Feature Request、Administrative、Bug 等) が存在する場合のみ実施してください。存在しない場合は、まず Issue を作成し、標準プロセスを通してから着手してください。
カテゴリを削除すると、そのカテゴリに含まれるすべてのセクションも削除され、セクションに含まれるすべての記事 (翻訳を含む) はアーカイブされます。
これを行う際は細心の注意を払ってください。

同期リポジトリは削除を行わないため、カテゴリを削除するには 2 つのアクションを行う必要があります。

まず、同期リポジトリから対応するファイルを削除する必要があります。ピアがレビューしてマージリクエストを承認した後、マージリクエストをマージできます。

それが完了したら、Zendesk 自体からも削除する必要があります。

Zendesk からカテゴリを削除するには: