ブロックリファレンス

BLOCKS Reference

Google Cloud

Cloud Functionsの呼び出し

概要

このブロックは、Google Cloud Functionsの関数をHTTPメソッドを使用したHTTPリクエストによって呼び出します。

Cloud Functionsの呼び出しの概念図
(画像をクリックすると拡大表示されます。)

Cloud Runにホストされたサービスも呼び出せます。

対応するHTTPメソッドは、以下のとおりです。

  • GET
  • POST
  • PUT
  • DELETE
  • OPTIONS

このブロックで呼び出す関数は、HTTPトリガータイプとしてデプロイされている必要があります。このデプロイ方法については、Googleのドキュメント「HTTPトリガー」を参照願います。

このブロックでは、認証あり・認証なしのどちらにも対応しています。認証ありの場合は、認証をパスできるGCPサービスアカウントを準備してください。

関数の実行時間の制限を最大の9分に延長した関数も実行できます(Cloud Runの場合は、最大60分)。

HTTPレスポンス時のステータスコードが、400番台および500番台のときは、ブロックの実行が失敗します。

Google Cloud PlatformのプロジェクトIDにコロンが含まれていると、当該プロジェクトの関数は呼び出せません。

プロパティ

プロパティ名 説明
ブロック名 ブロックの名前を指定します。ブロックに表示されます。
GCPサービスアカウント

このブロックで使用するGCPサービスアカウントを選択します。

認証ありの関数を呼び出す場合は、認証をパスできるGCPサービスアカウントを準備し選択してください。

HTTPメソッド

HTTPメソッドを選択します。選択可能なHTTPメソッドは以下のとおりです。

  • GET
  • POST
  • PUT
  • DELETE
  • OPTIONS
URL

呼び出す関数のHTTPエンドポイントを指定します。

例:https://us-central1-MY_PROJECT.cloudfunctions.net/addMessage

HTTPエンドポイントをコピー&ペーストで貼り付ける際は、前後に無駄な空白が付かないように注意してください。もし、そのような場合は本ブロックの実行時に以下のエラーが発生します。

URI::InvalidURIError:bad URI(is not URI?)
コンテンツタイプ

コンテンツタイプ(Content-Type:送信するデータの種類)を以下のいずれかから選択します。

コンテンツタイプ 説明
application/json

{"foo":"bar", "baz":"foobar"}のようなJSONテキストでデータを送信します。

application/x-www-form-urlencoded

foo=bar&baz=foobarのようなクエリーパラメーターの形式でデータを送信します(URLエンコードあり)。

パラメーター

関数に送信するデータを指定します。データは、キーとバリューの組合せで指定します。バリューには、変数展開および%形式の文字列書式が記述できます。

リクエストボディを指定する変数

HTTPリクエストのボディを使ってデータを送信したいときに、データが格納された変数を指定します。

このプロパティを設定すると、コンテンツタイププロパティとパラメータープロパティの設定内容は無視されます。この際のコンテンツタイプは、コンテンツタイププロパティの選択内容に関わらず、application/json固定となります。

ブロックメモ ブロックに対するコメントを指定します。
エラー時の繰り返し回数 エラー時の繰り返し回数を指定します。
繰り返し間隔 エラー時の繰り返し間隔を秒単位で指定します。
レスポンスを格納する変数

HTTPレスポンスを格納する変数を指定します。

変数に格納する値は、HTTPレスポンスのボティのみです。HTTPレスポンスのContent-Typeヘッダーがapplication/jsonの場合は、ボディをデコードした結果を変数に格納します。

リクエストヘッダー

関数呼び出し時に追加したいHTTPリクエストのヘッダーをキーとバリューの組合せで指定します。バリューには、変数展開および%形式の文字列書式が記述できます。

この情報は役に立ちましたか?