Slack

Slack コネクタを使用すると、Slack データに対して、挿入、削除、更新、読み取りオペレーションを実行できます。

始める前に

Slack コネクタを使用する前に、次の作業を行います。

  • Google Cloud プロジェクトで次の操作を行います。
    • ネットワーク接続が設定されていることを確認します。ネットワーク パターンの詳細については、Network Connectivity をご覧ください。
    • コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
    • コネクタに使用するサービス アカウントに、次の IAM ロールを付与します。
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      サービス アカウントは特別なタイプの Google アカウントで、Google API のデータにアクセスするのに認証を受ける必要がある人間以外のユーザーを表します。サービス アカウントがない場合は、サービス アカウントを作成する必要があります。詳細については、サービス アカウントを作成するをご覧ください。

    • 次のサービスを有効にします。
      • secretmanager.googleapis.com（Secret Manager API）
      • connectors.googleapis.com（Connectors API）

      サービスを有効にする方法については、サービスを有効にするをご覧ください。

    以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときにそれを有効にすることを求められます。

  • Slack ワークスペースを作成する方法については、Slack のクイックスタートをご覧ください。Slack プラットフォームの詳細については、Slack プラットフォームの概要をご覧ください。

コネクタを構成する

コネクタを構成するには、データソース（バックエンド システム）への接続を作成する必要があります。接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。

  1. Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。

    [接続] ページに移動

  2. [+ 新規作成] をクリックして [接続の作成] ページを開きます。
  3. [ロケーション] セクションで、接続のロケーションを選択します。
    1. リージョン: プルダウン リストからロケーションを選択します

      サポートされているすべてのリージョンのリストについては、ロケーションをご覧ください。

    2. [NEXT] をクリックします。
  4. [接続の詳細] セクションで、次の操作を行います。
    1. コネクタ: 使用可能なコネクタのプルダウン リストから [Slack] を選択します。
    2. コネクタのバージョン: 使用可能なバージョンのプルダウン リストからコネクタのバージョンを選択します。
    3. [接続名] フィールドに、接続インスタンスの名前を入力します。

      接続名は次の条件を満たす必要があります。

      • 接続名には英字、数字、ハイフンを使用できます。
      • 文字は小文字のみを使用できます。
      • 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
      • 接続名は 63 文字以内で指定してください。
    4. 必要に応じて、接続インスタンスの [説明] を入力します。
    5. 必要に応じて、Cloud Logging を有効にして、ログレベルを選択します。デフォルトのログレベルは Error に設定されています。
    6. サービス アカウント: 必要なロールを持つサービス アカウントを選択します。
    7. 必要に応じて、接続ノードの設定を構成します。

      • ノードの最小数: 接続ノードの最小数を入力します。
      • ノードの最大数: 接続ノードの最大数を入力します。

      ノードは、トランザクションを処理する接続の単位（またはレプリカ）です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され（可用性を高めるため）、最大ノード数は 50 に設定されます。

    8. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
    9. [NEXT] をクリックします。
  5. [認証] セクションで、認証の詳細を入力します。
    1. [認証タイプ] を選択し、関連する詳細を入力します。

      Slack 接続でサポートされる認証タイプは次のとおりです。

      • OAuth2.0 - 認証コード
      • ユーザー トークン認証

      2. これらの認証タイプの構成方法については、認証を構成するをご覧ください。

    2. [NEXT] をクリックします。
  6. Review: 接続と認証の詳細を確認します。
  7. [作成] をクリックします。

認証を構成する

使用する認証に基づいて詳細を入力します。

  • OAuth2.0 - 認証コード

    OAuth2.0 を使用して認証するには、次の情報を入力します。

    • クライアント ID: 作成したアプリに対してコネクタから提供されたクライアント ID。
    • スコープ: 必要なスコープのカンマ区切りのリスト。
    • クライアント シークレット: 作成した接続されているアプリのクライアント シークレットを含む Secret Manager の Secret。
    • シークレット バージョン: 上で選択したシークレットのシークレット バージョン。
  • ユーザー トークン認証

    ユーザー トークンを使用して認証するには、次の情報を入力します。

    • User Token: ユーザーの認証に使用されるユーザー トークン。
    • シークレット バージョン: 上で選択したシークレットのシークレット バージョン。

Authorization code 認証タイプの場合は、接続を作成した後、認証を構成するためにいくつかの追加手順を行う必要があります。詳細については、接続作成後の追加手順をご覧ください。

接続作成後の追加手順

認証に OAuth 2.0 - Authorization code を選択した場合は、接続の作成後に次の追加の手順を行う必要があります。

  1. 接続ページで、新しく作成された接続を見つけます。

    新しいコネクタの [ステータス] は [承認が必要] になります。

  2. [承認が必要] をクリックします。

    これにより、[承認の編集] ペインが表示されます。

  3. [リダイレクト URI] の値を外部アプリケーションにコピーします。
  4. 認可の詳細を確認します。
  5. [Authorize（承認）] をクリックします。

    認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。

認証コードの再認可

Authorization code 認証タイプを使用しているユーザーが、アプリケーションの構成を変更した場合は、Onedrive 接続を再認可する必要があります。接続を再認可するには、次の手順を行います。

  1. [接続] ページで必要な接続をクリックします。

    これにより、[接続の詳細] ページが開きます。

  2. [編集] をクリックして、接続の詳細を編集します。
  3. [認証] セクションで [OAuth 2.0 - 認証コード] の詳細を確認します。

    必要に応じて必要な変更を加えます。

  4. [保存] をクリックします。接続の詳細ページに移動します。
  5. [認証] セクションで [承認の編集] をクリックします。これにより、[承認] ペインが表示されます。
  6. [Authorize（承認）] をクリックします。

    認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。

接続構成のサンプル

このセクションでは、接続を作成するときに構成するさまざまなフィールドのサンプル値を示します。

Slack - UserToken 認証接続タイプ

フィールド名 詳細
場所 us-central1
コネクタ Slack
コネクタのバージョン 1
接続名 slack-usertoken-connection
Cloud Logging を有効にする ○
サービス アカウント SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
詳細レベル 5
ノードの最小数 2
ノードの最大数 50
ユーザー トークン認証 ○
ユーザー トークン USER_TOKEN
シークレットのバージョン 1

Slack - OAuth 2.0 認証の接続タイプ

フィールド名 詳細
場所 us-central1
コネクタ Slack
コネクタのバージョン 1
接続名 slack-google-cloud-oauth-conn
Cloud Logging を有効にする ○
サービス アカウント SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
詳細レベル 5
ノードの最小数 2
ノードの最大数 50
OAuth 2.0 - 認証コード ○
クライアント ID CLIENT_ID
スコープ channels:read、groups:read、im:read、mpim:read、channels:write、groups:write、
im:write、mpim:write、channels:history、groups:history、im:history、mpim:history、
search:read、chat:write:user、chat:write:bot、files:read、files:write:user、pins:read、
pins:write、usergroups:read、usergroups:write、reminders:read、reminders:write、
users:read、users.profile:write
クライアント シークレット CLIENT_SECRET
シークレットのバージョン 2

システムの上限

Slack コネクタは、ノードごとに 1 秒あたり最大 1 件のトランザクションを処理し、この上限を超えるトランザクションをスロットルします。デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます（可用性を高めるため）。

Integration Connectors に適用される上限の詳細については、上限をご覧ください。

統合で Slack 接続を使用する

接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、コネクタタスクを介して統合で使用できます。

  • Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
  • Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。

エンティティ、オペレーション、アクション

すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。

  • エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベース コネクタでは、テーブルがエンティティであり、ファイル サーバー コネクタでは、フォルダがエンティティです。また、メッセージング システム コネクタでは、キューがエンティティです。

    ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、Entities リストは空になります。

  • オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。

    使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティ オペレーションをご覧ください。ただし、コネクタがいずれかのエンティティ オペレーションをサポートしていない場合、サポートされていないオペレーションは Operations リストに含まれません。

  • アクション: コネクタ インターフェースを介して統合で使用できる主要な関数の一つです。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。通常、アクションには入力パラメータと出力パラメータがあります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、Actions リストが空になります。

操作

このセクションでは、Slack コネクタでサポートされているアクションについて説明します。アクションの構成方法については、アクションの例をご覧ください。

InviteUser アクション

このアクションは、ユーザーをチャンネルに招待します。

InviteUser アクションの入力パラメータ

パラメータ名 データ型 必須 説明
ChannelId 文字列 正しい ユーザーを招待する公開チャンネルまたは非公開チャンネルの ID。
ユーザー 文字列 正しい ユーザー ID のカンマ区切りのリスト。指定できるユーザー ID は 30 個までです。

InviteUser アクションの構成方法の例については、InviteUser の例をご覧ください。

CloseChannel アクション

ダイレクト メッセージまたは複数人へのダイレクト メッセージが閉じられます。

CloseChannel の入力パラメータ

パラメータ名 データ型 必須 説明
ChannelId 文字列 正しい 閉じる会話の ID。

CloseChannel アクションの構成例については、CloseChannel の例をご覧ください。

JoinChannel アクション

このアクションにより、ユーザーは既存の会話に参加できます。

JoinChannel の入力パラメータ

パラメータ名 データ型 必須 説明
ChannelId 文字列 正しい 参加するチャンネルの ID。

JoinChannel アクションの構成方法の例については、JoinChannel の例をご覧ください。

LeaveChannel アクション

このアクションを使用すると、ユーザーは会話を終了できます。

LeaveChannel の入力パラメータ

パラメータ名 データ型 必須 説明
ChannelId 文字列 正しい 退出する会話の ID。

LeaveChannel アクションの構成例については、LeaveChannel の例をご覧ください。

OpenChannel アクション

この操作により、ダイレクト メッセージまたは複数人向けダイレクト メッセージが開くか、再開されます。

OpenChannel の入力パラメータ

パラメータ名 データ型 必須 説明
ChannelId 文字列 正しい インスタント メッセージまたは複数人インスタント メッセージの ID を指定して会話を再開するか、ユーザー ID を指定します。
ユーザー 文字列 正しい ユーザーのカンマ区切りのリスト。ユーザーが 1 人だけ指定されている場合は、1 対 1 のダイレクト メッセージが作成されます。ユーザーを指定しない場合、会話を再開するチャンネル ID を指定します。

OpenChannel アクションの構成方法の例については、OpenChannel の例をご覧ください。

DownloadFile アクション

このアクションにより、ファイルをダウンロードします。

DownloadFile の入力パラメータ

パラメータ名 データ型 出力ストリームに対応 説明
FileId 文字列 False ダウンロードするファイルの ID
FileLocation 文字列 False ファイルのダウンロード先
FileStream 文字列 正しい ファイルデータを書き込む出力ストリームのインスタンス。このフィールドは、FileLocation が指定されていない場合に使用されます。
エンコード 文字列 False FileData のエンコード タイプ。BASE64 または NONE を指定できます。デフォルト値は BASE64 です。

DownloadFile アクションの構成方法の例については、DownloadFile の例をご覧ください。

EndDnd アクション

このアクションを行うと、ユーザーのサイレンモードが終了します。

EndDnd アクションの入力パラメータ

空の JSON（{} など）を渡します。

EndDnd アクションの構成方法の例については、EndDnd の例をご覧ください。

SetSnooze アクション

このアクションにより、ユーザーのサイレンモードがオンになったり、サイレンモードの時間が変更されたりします。

SetSnooze アクションの入力パラメータ

パラメータ名 データ型 必須 説明
NumOfMinutes 文字列 60 ユーザーをスヌーズする分数。

SetSnooze アクションの構成方法の例については、SetSnooze の例をご覧ください。

EndSnooze アクション

このアクションにより、ユーザーのスヌーズ モードが終了します。

EndSnooze アクションの入力パラメータ

空の JSON（{} など）を渡します。

EndSnooze アクションの構成方法の例については、EndSnooze の例をご覧ください。

SendScheduleMessage アクション

このアクションは、チャネルに送信されるメッセージをスケジュールします。

SendScheduleMessage アクションの入力パラメータ

空の JSON（{} など）を渡します。

SendScheduleMessage アクションの構成方法の例については、SendScheduleMessage の例をご覧ください。

アクションの例

例 - InviteUser

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [InviteUser] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "ChannelId": "C06Q6NTRNA2",
  "Users": "U070MCLRREW"
}

    4. アクションが成功すると、InviteUser タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
 [{
  "Success": "true"
}]

例 - CloseChannel

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [CloseChannel] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "ChannelId": "C075U92TU4U"
}

    4. アクションが成功すると、CloseChannel タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
 [{
  "Success": "true"
}]

例 - JoinChannel

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [JoinChannel] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "ChannelId": "C06UMDTL1EH"
}

    4. アクションが成功すると、JoinChannel タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
 [{
  "Success": "true"
}]

例 - LeaveChannel

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [LeaveChannel] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "ChannelId": "C06UME4PM2R"
}

    4. アクションが成功すると、LeaveChannel タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
 [{
  "Success": "true"
}]

例 - OpenChannel

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [OpenChannel] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
"Users": "U06VCS3NDNC,U06NE4KAL0G",
"ChannelId": "C071CU9UXFF"
}

    4. アクションが成功すると、OpenChannel タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
[{
"Success": "true"
}]

例 - DownloadFile

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [DownloadFile] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "FileId": "F075UHEMSN8",
  "HasBytes": true
}

    4. アクションが成功すると、DownloadFile タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
  "Success": "True",
  "ContentBytes": "JVBERi0xLjMKJcTl8uXrp/Og0MTGCjQgMCBvYmoKPDwgL0xlbmd0aCA1IDAgUiAvRmlsdGVyIC9GbGF0ZURlY29kZSA"
}]

その他の考慮事項

  • コンテンツを Base64 エンコード形式で提供する PDF や xlsx などの他のファイル形式をダウンロードするには、「HasBytes」を「True」に設定します。
  • ファイルを txt 形式でダウンロードするには、「HasBytes」を「True」に設定し、ファイル コンテンツをバイトとしてダウンロードします。ファイルの実際のコンテンツをダウンロードするには、[HasBytes] を [False] に設定します。

例 - EndDnd

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [EndDnd] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {}

    4. アクションが成功すると、EndDnd タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
 [{
  "Success": "true"
}]

例 - SetSnooze

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [SetSnooze] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
     {
  "NumOfMinutes": "60"
}

    4. アクションが成功すると、SetSnooze タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
 [{
  "Success": "true",
  "SnoozeEnabled": "true",
  "SnoozeEndTime": "1722842455",
  "SnoozeRemaining": "3600",
  "SnoozeIsIndefinite": "false"
}]

例 - EndSnooze

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [EndSnooze] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {}

    4. アクションが成功すると、EndSnooze タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
  [{
  "Success": "true",
  "DndEnabled": "true",
  "NextDndStartTime": "1722875400",
  "NextDndEndTime": "1722911400",
  "SnoozeEnabled": "false"
}]

例 - SendScheduleMessage

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [SendScheduleMessage] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
     {
  "Channel": "C07AMLB39JN",
  "PostAt": "2024-08-27 14:15:00.0",
  "Text": "Hello, World!",
  "ReplyBroadCast": false
 }

    4. アクションが成功すると、SendScheduleMessage タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
   [{
  "Success": "true",
  "ok": "true",
  "scheduled_message_id": "Q07KD4YSG72",
  "channel": "C07AMLB39JN",
  "post_at": "1724768100",
  "message_user": "U071FD3TS8P",
  "message_type": "message",
  "message_bot_id": "B076304QR9V",
  "message_app_id": "A076HCDGHT5",
  "message_text": "Hello, World!",
  "message_team": "T071W04MGV8",
  "message_bot_profile_id": "B076304QR9V",
  "message_bot_profile_deleted": "false",
  "message_bot_profile_name": "Googlecloud_OAuth_Slack",
  "message_bot_profile_updated": "1717513424",
  "message_bot_profile_app_id": "A076HCDGHT5",
  "message_bot_profile_icons_image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
  "message_bot_profile_icons_image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
  "message_bot_profile_icons_image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png",
  "message_bot_profile_team_id": "T071W04MGV8",
  "message_blocks_type": "rich_text",
  "message_blocks_block_id": "MYA",
  "message_blocks_elements_type": "rich_text_section",
  "message_blocks_elements_elements_type": "text",
  "message_blocks_elements_elements_text": "Hello, World!"
}]

エンティティ オペレーションの例

このセクションでは、このコネクタでエンティティ オペレーションの一部を実行する方法について説明します。

例 - Messages エンティティのレコードを一覧表示する

この例では、Messages エンティティのレコードを一覧表示します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity リストから Messages を選択します。
  3. [List] オペレーションを選択し、[完了] をクリックします。

List オペレーションは、次のエンティティに対しても実行できます。Files、MessageReplies、Pins、Reactions、Reminders、TeamInfo、UserGroups、Users、Channels、DND、Teams、UserProfile、ScheduledMessages、TeamProfileFields、TeamProfileSections。

例 - Calls エンティティのレコードを取得する

この例では、Calls エンティティのレコードを取得します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Calls を選択します。
  3. [Get] オペレーションを選択し、[完了] をクリックします。
  4. エンティティ ID を R070LKL3YKX に設定します。これは渡されるキーです。エンティティ ID を設定するには、[コネクタ] タスクの [タスク入力] セクションで [EntityId] をクリックし、[デフォルト値] に R070LKL3YKX を入力します。

エンティティ ID の値は直接渡す必要があります。この例では、R070LKL3YKX が一意の主キー値であり、直接渡されます。

また、Calls、MessageReplies、Messages、Reactions、TeamInfo、Reminders、Users、Channels のエンティティに対しても get オペレーションを実行できます。

例 - Calls エンティティのレコードを削除する

この例では、Calls エンティティのレコードを削除します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Calls を選択します。
  3. [Delete] オペレーションを選択し、[完了] をクリックします。
  4. エンティティ ID を R074DSKVDSS に設定します。これは渡されるキーです。エンティティ ID を設定するには、[コネクタ] タスクの [タスク入力] セクションで [EntityId] をクリックし、[デフォルト値] に R074DSKVDSS を入力します。

    エンティティに 2 つの複合ビジネスキーまたは主キーがある場合は、filterClause を Id='R074DSKVDSS' に設定できます。

削除オペレーションは、Files、MessageReplies、Messages、Pins、Reactions、Reminders のエンティティに対しても実行できます。

例 - Calls エンティティのレコードを作成する

この例では、Calls エンティティのレコードを作成します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Calls を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "ExternalUniqueId": "c249a48c-a154-43d6-a286-791df11927a4",
  "JoinURL": "https://example55.com/call"
}

    アクションが成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
{
  "Id": "R074LBCFBU3"
}

例 - Messages エンティティのレコードを作成する

この例では、Messages エンティティのレコードを作成します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Messages を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "ChannelId": "C06UF15CB0V",
  "Text": "This is google cloud created Message"
}

    統合が成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
{
"Id": "1723008314.867479",
"ChannelId": "C06UF15CB0V"
}

例 - Pins エンティティのレコードを作成する

この例では、Pins エンティティのレコードを作成します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Pins を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
"ChannelId": "C06UF15CB0V",
"Id": "1723008314.867479",
"Type": "message"
}

    統合が成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
{
"Id": "1723008314.867479",
"Type": "message",
"ChannelId": "C06UF15CB0V"
}

例 - Reactions エンティティのレコードを作成する

この例では、Reactions エンティティのレコードを作成します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Reactions を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "ChannelId": "C06UPA4KRD0",
  "Id": "1716375032.038669",
  "Type": "message",
  "Name": "raised_hands"
}

    アクションが成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
{
  "Success": true
}

例 - Reminders エンティティのレコードを作成する

この例では、Reminders エンティティのレコードを作成します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Reminders を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "Text": "this is a reminder",
  "Time": "2025-10-15 14:30:00"
}

    アクションが成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
{
  "Id": "Rm074P0X9JCV"
}

例 - Channels エンティティのレコードを作成する

この例では、Channels エンティティのレコードを作成します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Channels を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
"Name": "googlecloudcreatedchannel",
"IsPublic": true
}

    アクションが成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
{
"Id": "C074MBW5N2G"
}

例 - MessageReplies エンティティのレコードを作成する

この例では、MessageReplies エンティティのレコードを作成します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から MessageReplies を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
"ChannelId": "C076HCY07UN",
"Text": "This is generated text",
"ParentMessageId": "1717659095.881619"
}

    アクションが成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

     
{
"Id": "1717659183.033599",
"ChannelId": C076HCY07UN,
"ParentMessageId": "1717659095.881619"
}

例 - Calls エンティティのレコードを更新する

この例では、Calls エンティティのレコードを更新します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Calls を選択します。
  3. [Update] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "JoinURL": "https://example55.com/call/google-cloud",
  "Title": "title"
}
  5. エンティティ ID を R074LB76Q5R に設定します。エンティティ ID を設定するには、[エンティティ ID] をクリックし、[デフォルト値] フィールドに「R074LB76Q5R」と入力します。

    [entityId] を指定する代わりに、[filterClause] を R074LB76Q5R に設定することもできます。

    統合が成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
  "Id": "null"
}

例 - Messages エンティティのレコードを更新する

この例では、Messages エンティティのレコードを更新します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Messages を選択します。
  3. [Update] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "Text": "Google Cloud Updated Message"
}
  5. filterClause を ChannelId = 'C06UPA4KRD0' と Id = '1716369465.000129' に設定します。filterClause を設定するには、[filterClause] をクリックし、[デフォルト値] フィールドに「ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129'」と入力します。

    統合が成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
  "Id": null,
  "ChannelId": null
}

例 - Users エンティティのレコードを更新する

この例では、Users エンティティのレコードを更新します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Users を選択します。
  3. [Update] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "ProfileDisplayName": "Vaibhav"
}
  5. エンティティ ID を U06Q6VDJYSU に設定します。エンティティ ID を設定するには、[エンティティ ID] をクリックし、[デフォルト値] フィールドに「U06Q6VDJYSU」と入力します。

    [entityId] を指定する代わりに、[filterClause] を U06Q6VDJYSU に設定することもできます。

    統合が成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
"Id": null
}

例 - Channels エンティティのレコードを更新する

この例では、Channels エンティティのレコードを更新します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Channels を選択します。
  3. [Update] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
"Purpose": "This is the one channel that will always include everyone."
}
  5. エンティティ ID を C06MAP1JDSB に設定します。エンティティ ID を設定するには、[エンティティ ID] をクリックし、[デフォルト値] フィールドに「C06MAP1JDSB」と入力します。

    [entityId] を指定する代わりに、[filterClause] を C06MAP1JDSB に設定することもできます。

    統合が成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
"Id": "C06MAP1JDSB"
}

例 - MessageReplies エンティティのレコードを更新する

この例では、MessageReplies エンティティのレコードを更新します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から MessageReplies を選択します。
  3. [Update] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
"Text": "Updated Text"
}
  5. filterClause を ChannelId = 'C06UPA4KRD0' と Id = '1716369465.000129' に設定します。filterClause を設定するには、[filterClause] をクリックし、[デフォルト値] フィールドに「ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129'」と入力します。

    統合が成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
"Id": null,
"ChannelId": null,
"ParentMessageId": null
}

例 - UserProfile エンティティのレコードを更新する

この例では、UserProfile エンティティのレコードを更新します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から UserProfile を選択します。
  3. [Update] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
     {
  "CustomFields": "{\"Xf079082Q70B\": {\"value\": \"Patna Bihar\",\"alt\": \"\"}}",
  "Phone": "8767787654",
  "StatusText": "Long train Journey to work"
 }

    統合が成功すると、Connector タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {

}

Google Cloud コミュニティの助けを借りる

Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。

次のステップ