Method: spaces.messages.search

string

必須。検索クエリ。

クエリでは、結果のフィルタに使用される 1 つ以上の検索キーワードを指定できます。

次のメッセージ フィールドを使用して結果をフィルタすることもできます。

• createTime: RFC-3339 形式のタイムスタンプを受け入れます。サポートされている比較演算子は < と >= です。
• sender.name: 送信者のリソース名（users/{user}）。= のみがサポートされています。このメールアドレスを {user} のエイリアスとして使用できます。たとえば、users/example@gmail.com などです。ここで、example@gmail.com は Google Chat ユーザーのメールアドレスです。
• space.name: メッセージが投稿されるスペースのリソース名。（spaces/{space}）。= のみをサポートします。このフィルタが設定されていない場合、ユーザーがスペースのメンバーとしてアクセスできるすべてのダイレクト メッセージとスペースで検索が実行されます。
• space.display_name: 演算子 :（has）をサポートし、表示名が部分的に一致するスペースに基づいてフィルタします。結果は、一致度の高い上位 5 つのスペースに限定されます。たとえば、space.display_name:Project は、表示名に「Project」という単語が含まれている上位 5 つのスペース内のメッセージを検索します。
• attachment: 添付ファイルの有無を確認する演算子 :*（has any）をサポートします。attachment:* が指定されている場合は、1 つ以上の添付ファイルがあるメッセージのみが返されます。
• annotations.user_mentions.user.name: 言及されたユーザーのリソース名（users/{user}）。:（has）のみをサポートします。たとえば、annotations.user_mentions.user.name:"users/1234567890" は、指定されたユーザーへの言及を含むメッセージのみを返します。また、エイリアス me を使用して、呼び出し元ユーザーに言及しているメッセージをフィルタすることもできます（例: annotations.user_mentions.user.name:users/me）。メールアドレスを {user} のエイリアスとして使用することもできます（例: users/example@gmail.com）。

高度なフィルタリングでは、次の関数も使用できます。

• has_link(): メッセージ テキストに 1 つ以上のハイパーリンクが含まれているメッセージのみを返します。
• is_unread(): 呼び出し元のユーザーが既読にしたメッセージを除外します。

space.display_name フィルタを使用するには、呼び出し元の認証情報に次のいずれかの認可スコープが含まれている必要があります。

• https://www.googleapis.com/auth/chat.spaces.readonly
• https://www.googleapis.com/auth/chat.spaces

is_unread() フィルタを使用するには、呼び出し元の認証情報に次のいずれかの認可スコープが含まれている必要があります。

• https://www.googleapis.com/auth/chat.users.readstate.readonly
• https://www.googleapis.com/auth/chat.users.readstate

異なるフィールドでは、AND 演算子のみがサポートされています。有効な例は sender.name = "users/1234567890" AND is_unread() です。AND という単語は省略可能で、省略した場合は暗黙的に指定されたものとみなされます。たとえば、sender.name = "users/1234567890" is_unread() は有効で、前の例と同じです。OR は異なるフィールド間ではサポートされていないため、sender.name = "users/1234567890" OR is_unread() は無効な例です。

同じフィールド内:

• createTime は AND のみをサポートし、createTime >= "2022-01-01T00:00:00+00:00" AND createTime < "2023-01-01T00:00:00+00:00" などの間隔を表すためにのみ使用できます。
• sender.name は OR 演算子のみをサポートします（例: sender.name = "users/1234567890" OR sender.name = "users/0987654321"）。
• space.name は OR 演算子のみをサポートします（例: space.name = "spaces/ABCDEFGH" OR space.name = "spaces/QWERTYUI"）。
• space.display_name は AND 演算子と OR 演算子をサポートしますが、両方を組み合わせたものはサポートしません。たとえば、space.display_name:Project AND space.display_name:Tasks は、Project と Tasks の両方を含む表示名のスペースにあるメッセージを返します。一方、space.display_name:Project OR space.display_name:Tasks は、Project または Tasks のいずれか、または両方を含む表示名のスペースにあるメッセージを返します。
• annotations.user_mentions.user.name は AND 演算子と OR 演算子をサポートしますが、両方を組み合わせたものはサポートしません。たとえば、annotations.user_mentions.user.name:"users/1234567890" AND annotations.user_mentions.user.name:"users/0987654321" は両方のユーザーに言及しているメッセージのみを返しますが、annotations.user_mentions.user.name:"users/1234567890" OR annotations.user_mentions.user.name:"users/0987654321" はどちらかのユーザーまたは両方のユーザーに言及しているメッセージを返します。

同じクエリで AND 演算子と OR 演算子を組み合わせる場合は、演算子の優先順位を明確にするためにかっこが必要です。例: (sender.name="users/me" OR sender.name="users/123456") AND is_unread()それ以外の場合、括弧は省略可能です。

次のクエリの例は有効です。

"Pending reports" AND createTime >= "2023-01-01T00:00:00Z"

sender.name = "users/example@gmail.com"

annotations.user_mentions.user.name:"users/0987654321"

attachment:* AND space.name = "spaces/ABCDEFGH"

tasks AND is_unread() AND sender.name = "users/1234567890"

"things to do" "urgent"

(sender.name = "users/1234567890")
AND (createTime < "2023-05-01T00:00:00Z")

tasks AND space.name = "spaces/ABCDEFGH" AND has_link()

"project one" is_unread()

space.display_name:Project tasks

クエリの最大長は 1,000 文字です。

無効なクエリは、サーバーによって INVALID_ARGUMENT エラーで拒否されます。

integer

省略可。返される結果の最大件数です。サービスから返される数は、この値より少ない場合があります。

指定されていない場合、最大で 25 個が返されます。

最大値は 100 です。100 を超える値を使用すると、自動的に 100 に変更されます。

string

省略可。前の search messages 呼び出しから受け取ったトークン。後続のページを取得するには、このパラメータを指定します。

ページ分割を行う場合、指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。他のパラメータに異なる値を渡すと、予期しない結果が生じる可能性があります。

string

省略可。結果リストの並べ替え順序。

並べ替えに使用できる属性は次のとおりです。

• createTime: メッセージの作成時刻で結果を並べ替えます。デフォルト値。
• relevance: 結果を関連性で並べ替えます。（science デベロッパー プレビュー）

デフォルトの順序は createTime desc です。クエリ（createTime または relevance）ごとに 1 つの順序のみがサポートされます。降順（desc）のみがサポートされており、順序属性の後に指定する必要があります。

enum (SearchMessagesView)

省略可。返す検索結果ビューの種類を指定します。デフォルト値は SEARCH_MESSAGES_VIEW_BASIC です。