呼び出し元のユーザーがアクセスできる Google Chat
のメッセージを検索します。検索条件に一致するメッセージのリストを返します。
ユーザーがアクセスできるすべてのスペースを検索するには、parent を spaces/-
に設定します。parent に別の値を指定すると、INVALID_ARGUMENT
エラーが発生します。返されるメッセージの name フィールドには、メッセージが存在する特定の space を含む完全なリソース名が入力されます。
この API は、すべてのメッセージ タイプを返すわけではありません。以下のメッセージ タイプはレスポンスに含まれません。すべてのメッセージを一覧表示するには、messages.list を使用します。
異なるフィールドでは、AND 演算子のみがサポートされています。有効な例は sender.name = "users/1234567890" AND is_unread() です。AND という単語は省略可能で、省略すると暗黙的に指定されます。たとえば、sender.name =
"users/1234567890" is_unread() は有効で、前の例と同じです。無効な例は sender.name = "users/1234567890" OR
is_unread() です。これは、異なるフィールド間で OR がサポートされていないためです。
同じフィールド内:
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
