Experience Cloud サイトのトピック階層を作成する | Connect REST API 開発者ガイド

例 1: 管理トピックによる階層の作成

ステップ 1: 親トピックの識別または作成

親トピックは、ナビゲーション管理トピックである必要があります。

リソース: /connect/communities/communityId/managed-topics
HTTP メソッド: GET によってナビゲーション管理トピックのリストを取得し、親トピックを識別します。; POST によって親トピックを作成します。コミュニティマネージャ (「エクスペリエンスの作成および設定」または「環境を管理」権限を持つユーザ) が、管理トピックを作成できます。
GET のレスポンスボディ: Managed Topic Collection; 親トピックにするナビゲーション管理トピックの ID をメモします。プレフィックスは 0mt です。
POST のリクエストボディ: Managed Topic Input
POST のリクエストボディ例
POST の��スポンスボディ: Managed Topic; 作成した親トピックの ID をメモします。プレフィックスは 0mt です。

ステップ 2: 子トピックの作成および階層の親へのリンク

このステップでは、管理子トピックの作成と親へのリンクを 1 ステップで行います。

リソース: /connect/communities/communityId/managed-topics
HTTP メソッド: POST
コミュニティマネージャ (「エクスペリエンスの作成および設定」または「環境を管理」権限を持つユーザ) が、管理トピックを作成できます。
リクエストボディ: Managed Topic Input
リクエストボディの例: ステップ 1 のナビゲーション管理トピック ID を parentId として使用します。
POST のレスポンスボディ: Managed Topic

デフォルトでは、管理トピックレスポンスボディに階層の最上位のみが表示されます。最大でトピック階層の 3 レベルまでを含めることができます。すべてのレベルを表示するには、次のリソースおよびパラメータを使用します。

管理トピックの代わりに標準トピックを使用して子トピックにすることもできますが、これには追加のステップが必要になります。

ステップ 1: 親トピックの識別または作成

親トピックは、ナビゲーション管理トピックである必要があります。

リソース: /connect/communities/communityId/managed-topics
HTTP メソッド: GET によってナビゲーション管理トピックのリストを取得し、親トピックを識別します。; POST によって親トピックを作成します。コミュニティマネージャ (「エクスペリエンスの作成および設定」または「環境を管理」権限を持つユーザ) が、管理トピックを作成できます。
GET のレスポンスボディ: Managed Topic Collection; 親トピックにするナビゲーション管理トピックの ID をメモします。プレフィックスは 0mt です。
POST のリクエストボディ: Managed Topic Input
POST のリクエストボディ例
POST のレスポンスボディ: Managed Topic; 作成した親トピックの ID をメモします。プレフィックスは 0mt です。

ステップ 2: 子トピックの識別または作成

この例では、管理トピックの代わりに標準トピックを識別するか作成して子トピックにします。

リソース: /connect/communities/communityId/topics
HTTP メソッド: GET によってトピックのリストを取得し、子トピックを識別します。; POST によって子トピックを作成します。「トピックの作成」権限を持つユーザがトピックを作成できます。
GET のレスポンスボディ: Topic Collection; 子トピックにするトピックの ID をメモします。プレフィックスは 0TO です。
POST のリクエストボディ: Topic Input
POST のリクエストボディ例
POST のレスポンスボディ: Topic; 作成した子トピックの ID をメモします。プレフィックスは 0TO です。

ステップ 3: 階層での子トピックと親トピックのリンク

リソース: /connect/communities/communityId/managed-topics
HTTP メソッド: POST
リクエストボディ: Managed Topic Input
リクエストボディの例: 例 2 のステップ 1 の管理トピック ID を parentId として使用し、例 2 のステップ 2 のトピック ID を recordId として使用します。
レスポンスボディ: Managed Topic