次の方法で共有

searchRequest リソースの種類

  • [アーティクル]

名前空間: microsoft.graph

JSON BLOB で書式設定された検索要求。

JSON BLOB には、応答で予期されるリソースの種類、基になるソース、ページング パラメーター、並べ替えオプション、要求された集計とフィールド、および実際の検索クエリが含まれています。 さまざまなリソースでの検索要求の 例 を参照してください。

注:

エンティティ型の特定の組み合わせの検索、検索結果の並べ替えまたは集計に関する 既知の制限 事項に注意してください。

プロパティ

プロパティ 型 説明
aggregationFilters String collection 集計され、フィールドの特定の値にフィルター処理された検索結果を取得するための 1 つ以上のフィルターが含まれます。 省略可能。
同じフィールドで集計する以前の検索に基づいて、このフィルターを構築します。 以前の検索の応答から、結果をフィールドの特定の値にフィルター処理する searchBucket を特定し、 その aggregationFilterToken プロパティで文字列を使用し、 "{field}:\"{aggregationFilterToken}\" という形式で集計フィルター文字列を作成します。
同じフィールドに複数の値を指定する必要がある場合は、 aggregationFilterToken プロパティの文字列を使用し 、"{field}:or(\"{aggregationFilterToken1}\",\"{aggregationFilterToken2}\") の形式で集計フィルター文字列を作成します。
たとえば、ドライブ項目をファイルの種類別に検索して集計すると、応答でdocxファイルの種類の searchBucket が返されます。 この searchBucket に返された aggregationFilterToken を後続の検索クエリで使用し、フィルターの一致をダウンして、docx ファイルの種類の項目を駆動できます。 例 1 と 例 2 は、実際の要求と応答を示しています。
集計 aggregationOption コレクション 検索結果と共に返される集計 (絞り込み条件とも呼ばれます) を指定します。 省略可能。
collapseProperties collapseProperty コレクション フィールドの順序付きコレクションと、結果を折りたたむ制限を格納します。 省略可能。
contentSources String collection 対象となる接続が含まれます。
enableTopResults ブール型 これにより、メッセージのハイブリッド並べ替えがトリガーされます。最初の 3 つのメッセージが最も関連します。 このプロパティは entityType=message にのみ適用されます。 省略可能。
entityTypes entityType コレクション 応答で予期される 1 つ以上の種類のリソース。 可能な値は、event、message、driveItem、externalItem、site、list、listItem、drive、chatMessage、person、acronym、bookmark です。 chatMessage、person、acronym、bookmark:この進化可能な列挙型で次の値を取得するには、Prefer: include-unknown-enum-members要求ヘッダーを使用する必要があることに注意してください。 同じ検索要求でサポートされている 2 つ以上のエンティティ型の組み合わせに関する 既知の制限事項 を参照してください。 必須。
フィールド String collection entityTypes で指定された各リソース オブジェクトに対して返されるフィールドを格納し、既定で返されるフィールドをカスタマイズできます。それ以外の場合は、SharePoint と OneDrive のカスタム 管理プロパティなどの追加フィールドや、Microsoft Graph コネクタが取り込むコンテンツの externalItem のカスタム フィールドを含みます。 fields プロパティでは、プロパティに適用されるセマンティック ラベルを使用できます。 たとえば、プロパティにタイトルのラベルが付いている場合は、次の構文を使用して取得できます: label_title。 省略可能。
from Int32 検索結果のオフセットを指定します。 オフセット 0 は、最初の結果を返します。 省略可能。
query SearchQuery クエリ用語が含まれます。 必須です。
queryAlterationOptions searchAlterationOptions スペル修正に関連する 2 つの省略可能なフラグを含む JSON BLOB で書式設定されたクエリ変更オプション。 省略可能。
地域 String 検索の地理的な場所。 アプリケーションのアクセス許可を使用する検索に必要です。 詳細については、「 リージョンの値を取得する」を参照してください。
resultTemplateOptions resultTemplateOption コレクション コネクタから検索結果をレンダリングするための検索結果テンプレート オプションを提供します。
sharePointOneDriveOptions sharePointOneDriveOptions アプリケーションのアクセス許可を使用して検索を実行するときに検索するコンテンツの種類を示します。 省略可能。
size Int32 取得するページのサイズ。 最大値は 500 です。 省略可能。
sortProperties sortProperty コレクション 結果を並べ替えるフィールドと方向の順序付けされたコレクションが含まれます。 コレクションには最大 5 つの並べ替えプロパティがあります。 省略可能。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "aggregationFilters": ["String"],
  "aggregations": [{"@odata.type": "microsoft.graph.aggregationOption"}],
  "collapseProperties": [{"@odata.type": "microsoft.graph.collapseProperty"}],
  "enableTopResults": "Boolean",
  "entityTypes": ["String"],
  "contentSources": ["String"],
  "fields": ["String"],
  "from": "Int32",
  "query": {"@odata.type": "microsoft.graph.searchQuery"},
  "queryAlterationOptions": {"@odata.type": "microsoft.graph.searchAlterationOptions"},
  "region": "String",
  "resultTemplateOptions": [{"@odata.type": "microsoft.graph.resultTemplateOption"}],
  "sharePointOneDriveOptions": {"@odata.type": "microsoft.graph.sharePointOneDriveOptions"},
  "size": "Int32"
}

関連コンテンツ