組織内のユーザーの管理検索回答を設定する (プレビュー)

Microsoft Search を使用すると、管理者は、組織に固有の意味または Web ページに検索語句を関連付け、これらの関連付けを検索回答として含めることができます。 たとえば、組織内のユーザーは、内部プロジェクト名を表す不慣れな頭字語や、チーム Web ページに関連付けられているチーム名に陥ることがあります。 管理者は、[検索& インテリジェンス] で 、Microsoft 365 管理センターで 頭字語、ブックマーク、または QnA を設定できます。 これにより、ユーザーは検索を使用して移動し、作業に慣れることができます。

管理者は、Microsoft Graph の Microsoft Search API を使用して、組織内の 管理検索回答をプログラムで管理 することもできます。 これらの回答は、使用できる検索回答リソースの種類 ( 頭字語、 ブックマーク、 QnA リソース) で定義された頭字語またはキーワードによってトリガーされると、Microsoft Search の結果に表示されます。

定義された頭字語またはキーワードによってトリガーされると、組織内の検索結果ページの上部にこれらの検索回答が表示されます。

例 1: 新しい頭字語を作成する

次の要求は、ユーザーが検索したときに検索結果ページに表示される新しい頭字語を作成します。

要求

POST https://graph.microsoft.com/beta/search/acronyms
Content-Type: application/json

{
  "displayName": "GDPR",
  "standsFor": "General Data Protection Regulation",
  "description": "A European Union (EU) regulation on data protection and privacy in the EU and the European Economic Area (EEA) that enhances individuals' control and rights over their personal data, simplifies the regulatory environment for international business, and addresses the transfer of personal data outside the EU and EEA areas.",
  "webUrl": "http://contoso.com/GDPR",
  "state": "published"
}

応答

以下は、応答の例です。

HTTP/1.1 200 Ok
Content-Type: application/json

{
  "id": "733b26d5-af76-4eea-ac69-1a0ce8716897"
}

例 2: 新しいブックマークを作成する

次の要求は、ユーザーがそのキーワードの少なくとも 1 つを検索したときに検索結果ページに表示される新しいブックマークを作成します。

要求

POST https://graph.microsoft.com/beta/search/bookmarks
Content-Type: application/json

{
  "displayName": "Contoso Install Site",
  "webUrl": "http://www.contoso.com/",
  "description": "Try or buy Contoso for Home or Business and view product information",
  "keywords":  {
    "keywords": ["Contoso", "install"],
    "reservedKeywords": ["Contoso"],
    "matchSimilarKeywords": true
  },
  "state": "published"
}

応答

以下は、応答の例です。

HTTP/1.1 201 CREATED
Location: /733b26d5-af76-4eea-ac69-1a0ce8716897
Content-Type: application/json

{
  "id": "733b26d5-af76-4eea-ac69-1a0ce8716897"
}

次の手順

• Search API のシナリオと機能について理解してください。 Microsoft Search API の概要。
• Graph Explorer で検索 API について調べます。
• Microsoft Search API を使用して管理回答を管理します。