- 基本的な手順は、Webhookを送信することです。
- URLは固定です。変数は本文に含めることができます。
- 答えは、さらなるステップのために残されています。
- この機能を使用するには、管理者の承認が必要です。
Google Workspace Studio のワークフローでは、Gmail、Drive、Chat 以外のデータが必要になる場合があります。たとえば、注文ステータス、データベースの数値、内部ツールからの応答などです。このデータを取得したり、別のサービスに情報を送信したりするには、次のステップを追加できます。 ウェブフックを送信するこれは、指定したAPIのアドレスに対してHTTPリクエストを送信します。
このリクエストを行うために、Gemini関数呼び出しを設定する必要はありません。Workspace Studioでは、フローがWebhookステップを実行し、応答を受信します。その後、必要に応じて、その応答を別のステップに渡して、要約したり、データを抽出したり、結果を伝達したりできます。
APIに接続する前に必要なもの
最初のステップは、組織がウェブフックを使用できることを確認することです。関数は 限定プレビュー デフォルトでは無効になっています。管理者がログインする必要があります。 アプリ > Google Workspace > Workspace Studio > Webhook 設定 そして、該当する組織単位に対してそれを有効にします。
一部のエディションでは、管理者は接続を1つに制限することもできます。 許可されているドメインとURLのリストステップがStudioに表示されるものの、APIとの通信に失敗した場合は、宛先アドレスが認証されていることを確認してください。また、デフォルトでは、Webhookに関連するアクションは、実行前にユーザーがステップを確認して承認する必要があります。
外部サービスについては、そのURL、サポートするHTTPメソッド、および想定されるデータ形式を把握する必要があります。また、認証方法も確認してください。公開されている読み取り専用APIは、トークンや特別なヘッダーを必要とするプライベートAPIとは異なる要件があります。
Workspace StudioからAPIを呼び出す手順
入力 studio.workspace.google.com そして、必要なトリガーを設定したワークフローを作成します。例えば、特定の条件を満たすメールが届いたときにワークフローを開始するように設定できます。その後、以下の手順に従ってください。
- プレス ステップを追加する 選択して ウェブフックを送信する.
- 入力してください 完全なURL API のプレフィックスを含む
https://住所は固定する必要があります。このフィールドはフロー変数をサポートしていません。 - HTTP方式を選択してください。 得る これはデータの照会に使用されます。 役職送信したり、記録を作成したりするためにも利用できます。 PUT、PATCH、DELETE.
- API に本文が必要な場合は、コンテンツ フィールドに書き込むか、 ペイロードGoogleは、受信側のサービスがJSON形式を期待している場合は、JSONを使用することを推奨しています。
- 作る テスト実行結果を確認し、正常に動作することを確認したら、フローを有効化してください。
テストに注意してください アクションを実行するPOST 文を使ってレコードを作成したり、DELETE 文を使ってレコードを削除したりする場合は、まず、問題なく変更できるテスト環境またはデータを使用してください。
例：外部ツールへの通知の送信
あなたのチームが、アラートを作成するAPIを持っていると想像してください。 https://api.ejemplo.com/v1/avisosこの住所は 例示的サービスのものに置き換える必要があります。ドキュメントにPOSTとJSONボディを受け入れると記載されている場合は、次のような内容でステップを設定できます。 {"tipo":"nuevo_correo","origen":"Workspace Studio"}.
また、 流量変数 例えば、本文に、トリガーとなったメールの件名を含める場合。Studio の変数セレクターからこれを実行し、結果を確認します。挿入されたテキストに引用符やその他の特殊文字が含まれている場合、JSON が不正な形式になる可能性があります。変数はコンテンツで使用できますが、 URLフィールドには含まれていません.
データを取得する必要がある場合は、「GET」を選択し、必要なパラメータが既に含まれている固定URLを入力してください。Workspace Studioは、GETリクエストの本文に記述された内容を無視します。
APIレスポンスをどう処理するか
ウェブフックのステップでは サービス応答をテキストとして表示 後続のステップで使用できる変数に格納されます。これを使用して、通知を送信したり、要約を作成したり、AIステップに特定のデータを抽出させたりすることができます。
例えば、APIが注文のステータスを返した場合、次のステップでそのステータスをチームに伝えることができます。レスポンスを含む変数を明示的に選択してください。後続のステップは、フローの以前の段階で発生したすべての情報を自動的に受け取るわけではありません。返されたコンテンツに依存する手順を作成する前に、そのコンテンツをテストすることをお勧めします。
APIに認証やより複雑なロジックが必要な場合
文書化された基本構成 ウェブフックを送信する これには、URL、メソッド、およびオプションのボディが含まれます。統合処理でOAuthトークンの取得、可変パラメータを含むURLの構築、特定のヘッダーの追加、または処理を進める前にレスポンスを変換する必要がある場合は、この手順がこれらの要件を満たしているかどうかを確認してください。
それが不十分な場合、1つの選択肢は Workspace Studio のカスタムステップ プラグインを介して。Google Apps Script の実装では、サービスは UrlFetchApp この機能を使うと、外部APIへのリクエストを行い、JSONレスポンスを処理できます。このソリューションには開発と適切な権限設定が必要ですが、ネイティブステップで既に処理できるような単純なリクエストには不要です。
フローの表示フィールドに秘密鍵を貼り付けたり、共有URLに埋め込んだりすることは避けてください。Gmail、チャット、カレンダーからデータを送信する前に、外部サービスがどのような情報を受け取るのか、またその情報を処理する権限があるかどうかを確認してください。
ウェブフックのエラーを見つける方法
接続に失敗した場合は、タブを開いてください。 活動 フローの詳細を確認できます。そこで、エラーの全文と宛先サーバーから送信された応答を確認できます。この情報は、Studioの設定の問題とAPIによって拒否されたリクエストを区別するのに役立ちます。
- その手順は表示されません。 組織単位でWebhookが有効になっているかどうか、管理者に確認してください。
- URLがブロックされています。 お使いのエディションにその制限がある場合は、許可されているアドレスのリストを確認してください。
- エラー 400: APIで要求されるボディのフォーマットとフィールドを確認してください。
- エラー401または403： サービスが必要とする権限と認証方法を確認してください。
- エラー 429: 対象APIのリクエスト制限を超えていないか確認してください。
- エラー 500: リクエストを受け取ったサービスのステータスと記録を確認してください。
Workspace Studio の一般的な制限事項にも注意してください。現在サポートされているのは最大で ユーザーあたり25フロー y フローごとに20ステップさらに、実行回数の合計制限があり、これは24時間ごとにリセットされます。複数のフローの実行が停止した場合は、APIに原因があると判断する前に、それぞれのフローのアクティビティを確認してください。
ほとんどのシンプルなHTTP接続の場合、手順は簡単です。Webhookを有効にし、固定URLと適切なメソッドを設定し、リクエストをテストして、そのレスポンスを後続の手順で使用します。統合に高度な認証やコードによるデータ変換が必要な場合は、カスタム手順を準備するのが賢明です。
私はテクノロジー愛好家であり、その「オタク」の興味を職業に変えています。私は 10 年以上、純粋な好奇心から最先端のテクノロジーを使用し、あらゆる種類のプログラムをいじくり回してきました。現在はコンピューター技術とビデオゲームを専門にしています。これは、私が 5 年以上、テクノロジーやビデオ ゲームに関するさまざまな Web サイトに執筆し、誰にでも理解できる言語で必要な情報を提供することを目的とした記事を作成しているためです。
ご質問がございましたら、私の知識は Windows オペレーティング システムから携帯電話用の Android に関連するあらゆるものまで多岐にわたります。そして、私はあなたに対して、いつでも喜んで数分を費やして、このインターネットの世界であなたが抱いている疑問を解決するお手伝いをしたいと考えています。