チャットの検索

Microsoft Teams内のチャットを検索します。

オプション

フィールド定義タイプ必須

フィールド	定義	タイプ	必須
結果セット（Result Set）	検索結果を表示するために次のオプションのいずれかを選択します。 `First 50 Matching Records`：一致する最初の50チャットを返します。 `Stream Matching Records`：一致するすべてのレコードが親フローからヘルパーフローに渡されます。カードにストリーミング（Streaming）入力セクションが追加され、カスタム拡張可能フィールドのストリーミングと追加のためのヘルパーフローを選択できます。	ドロップダウン	正
検索条件（Search By）	検索の`Exact Match`に該当するチームを返すか、検索式の`Starts With`に該当するチームを返すかを選択します。	ドロップダウン	正

結果セット（Result Set）

検索結果を表示するために次のオプションのいずれかを選択します。

First 50 Matching Records：一致する最初の50チャットを返します。
Stream Matching Records：一致するすべてのレコードが親フローからヘルパーフローに渡されます。カードにストリーミング（Streaming）入力セクションが追加され、カスタム拡張可能フィールドのストリーミングと追加のためのヘルパーフローを選択できます。

ドロップダウン

正

検索条件（Search By）

検索のExact Matchに該当するチームを返すか、検索式のStarts Withに該当するチームを返すかを選択します。

ドロップダウン

正

入力

フィールド	定義	タイプ	必須
検索（Search）
トピック（Topic）	チャットのタイトル。チャットタイトルを指定できるのは、チャットタイプがグループの場合のみです。検索条件（Search By）オプションで`Exact Match`または`Starts With`を選択した場合に表示されます。	テキスト	FALSE
チャットタイプ（Chat Type）	チャットのタイプを指定します。取り得る値は次のとおりです。 `oneOnOne`：1:1チャットであることを示します。 `group`：グループチャットであることを示します。検索条件（Search By）オプションで`Exact Match`を選択した場合に表示されます。	ドロップダウン	正
検索条件（Search Criteria）	結果セット（Result Set）オプションで`Stream Matching Records`が選択されている場合に表示されます。
レコード制限（Record Limit）	ストリーミングするレコードの数を指定します。レコード制限（Record Limit）フィールドを`0`に設定すると、`400 Bad Request`エラーが返されます。レコード制限（Record Limit）フィールドに`0`より大きい値を設定すると、最大で指定された最大レコード数までのレコードが返されます。レコード制限（Record Limit）フィールドが空、null、または未選択の場合、すべてのレコードが返されます。デフォルト値は`120000`です。有効な範囲は`1`～`120000`です。	数値	正
ストリーミング（Streaming）	結果セット（Result Set）オプションで`Stream Matching Records`が選択されている場合に表示されます。
フロー（Flow）	フローの選択（Choose Flow）をクリックして検索結果をストリーミングするヘルパーフローを参照および選択し、選択（Choose）をクリックして確定します。オプションとして、クリックまたはここにドロップして作成（Click or drop here to create）の下の空のフィールドをクリックし、データをヘルパーフローに渡すカスタム拡張可能フィールドを追加します。これらのフィールドは、ヘルパーフロー内の状態（State）出力オブジェクトの下にキーと値のペアとして追加されます。	フロー	正

出力

フィールド	定義	タイプ
チャット（Chats）
Id（ID）	チャットの一意識別子。	テキスト
チャットタイプ（Chat Type）	チャットのタイプを指定します。	テキスト
メンバー（Members）	チーム、チャンネル、またはチャット内のユーザーを表します。「会話メンバー」を参照してください。	オブジェクトのリスト
トピック（Topic）	チャットのタイトル。チャットタイトルを指定できるのは、チャットタイプがグループの場合のみです。	テキスト
作成日時（Created Date Time）	チャットが作成された日時。	日時
最終更新日時（Last Updated Date Time）	チャット名が変更された、またはメンバーリストが最後に変更された日時。	日時
ストリーミングされたレコード（Records Streamed）	ストリーミングフロー内でストリーミングされたレコードの数。このフィールドは、結果セット（Result Set）オプションで`Stream Matching Records`を選択した場合に表示されます。	数値

追加情報

結果セット（Result Set）（First 50 Matching Records）で最初に一致する50レコード（First 50 Matching Records）（Result Set）オプションを選択した場合、想定されるすべてのレコードでAPIが応答しない可能性があります。すべてのレコードを確実に検索するには、一致レコードのストリーミング（Stream Matching Records）オプションを使用します。