メッセージを検索

このピースでできること

  • Google Chatのスペース内でキーワードに一致するメッセージを検索します。
  • 検索結果の最大件数を指定できます。
 

Google Chat の接続方法

workrun と Google Chat を接続するには、Google Cloud Console で作成した OAuth クライアント(クライアントID・クライアントシークレット) が必要です。
💡
APIキーの発行は不要ですが、OAuth認証を利用するため、Google Cloud Console で OAuth クライアントを作成し、クライアントIDとクライアントシークレットを workrun に入力する必要があります。接続画面でクライアントIDとクライアントシークレットが求められるのは正常な挙動です。

ステップ 1:workrun のリダイレクト URL を確認する

  1. workrun で Google Chat のアクションまたはトリガーをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。

ステップ 2:Google Cloud Console で OAuth クライアントを作成する

  1. Google Cloud Console にサインインし、使用するGoogle Cloudプロジェクトを選択または新規作成します。
  1. 『API とサービス』→『ライブラリ』 から、以下のAPIを有効化します:
      • Google Chat API
      • Cloud Pub/Sub API
      • Workspace Events API
      • Cloud Resource Manager API
      • People API
  1. Google Chat でメッセージ送信、メンバー追加、またはトリガーを利用する場合は、『Google Chat API』→『構成』 から Chat アプリの設定を行ってください。
      • 「アプリのステータス」「アプリ名」「説明」などの必要項目を入力して保存します。
      • Google Chat API の構成が未完了の状態では、メッセージ送信やトリガー設定が正常に行えない場合があります。
      • 以下は Google Chat API の「構成」画面の例です。
      • 設定画面が表示される場合は、案内に沿って Chat アプリ名などの必要項目を入力してください。
  1. 『API とサービス』→『OAuth 同意画面』 で同意画面を設定します。
  1. 『API とサービス』→『認証情報』 を開き、「認証情報を作成」→「OAuth クライアント ID」 を選択します。
  1. アプリケーションの種類は 「ウェブ アプリケーション」 を選択します。
  1. 「承認済みのリダイレクト URI」 に、ステップ 1 でコピーした workrun のリダイレクト URL を追加します。
  1. 「作成」 をクリックすると、クライアント IDクライアントシークレット が表示されます。コピーしておきます。
      • 必要なスコープ:
      • 既存のメッセージやスペース情報の参照のみを行う場合は、Chat アプリの構成を省略できることがあります。

ステップ 3:workrun に接続を追加する

  1. ステップ 1 の接続画面に戻り、クライアント IDクライアントシークレット をそれぞれ貼り付けます。
  1. 「接続する」 をクリックすると、Google の認証画面が開きます。
  1. 使用する Google アカウントを選択し、workrun に対するアクセス許可を 「許可」 します。
  1. 画面が自動で閉じ、接続完了です。「保存」 をクリックして接続を登録します。
💡
Google Workspace の管理者によっては、外部アプリのアクセス許可が必要な場合があります。接続できない場合は Google Workspace の管理者にお問い合わせください。
 

ピースの設定項目

1. スペース(必須)

  • 検索対象とするGoogle Chatのスペースを選択します。
  • ドロップダウンから利用可能なスペース一覧が表示されます。

2. キーワード(必須)

  • 検索するキーワードを入力します。
  • このキーワードを含むメッセージが検索されます。

3. 最大結果数(任意)

  • 返す結果の最大数を指定します。
  • 指定しない場合のデフォルトは50件です。