Application Integration でサポートされているコネクタをご覧ください。

REST エンドポイントの呼び出しタスク

REST エンドポイントの呼び出しタスクを使用すると、統合からサードパーティの REST API を呼び出すことができます。REST API 呼び出しからのレスポンスは統合変数で使用でき、他のダウンストリームタスクで使用できます。

準備

REST API 呼び出しの認証エンドポイントに接続するには、OAuth 2.0 プロファイルを作成済みであるか、統合にユーザー管理のサービスアカウントを接続していることを確認します。API で認証が不要な場合は、タスク構成ペインの [Authentication profile] フィールドを空のままにしておくことができます。構成リストを表示するには、構成プロパティをご覧ください。
統合に OAuth 2.0 プロファイルとユーザー管理のサービスアカウントの両方が構成されている場合は、デフォルトで OAuth 2.0 プロファイルが認証に使用されます。OAuth 2.0 プロファイルとユーザー管理のサービスアカウントのどちらも構成されていない場合、実行は失敗します。
統合にサービスアカウントが関連付けられている場合は、REST エンドポイント URL に基づいて、必要な IAM ロールをそのサービスアカウントに付与します。たとえば、REST エンドポイント URL が Cloud Storage サービスを呼び出す場合は、Cloud Storage サービスに必要な IAM ロールを付与します。
サービスアカウントへのロールの付与については、サービスアカウントに対するアクセス権の管理をご覧ください。
Google Cloud プロジェクトの Application Integration で VPC Service Controls が設定されていないことを確認します。
警告: Google Cloud プロジェクトで Application Integration 用に VPC Service Controls が設定されている場合、Cloud Function は機能しないか、機能を停止します。

REST エンドポイントの呼び出しタスクを構成する

REST エンドポイントの呼び出し タスクを構成するには:

Google Cloud コンソールで [Application Integration] ページに移動します。
Application Integration に移動
ナビゲーションメニューで [統合] をクリックします。
[統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。
既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。
新しい統合を作成する場合:
1. [統合の作成] ペインで名前と説明を入力します。
2. 統合のリージョンを選択します。
  注: [リージョン] プルダウンには、Google Cloud プロジェクトにプロビジョニングされたリージョンのみが表示されます。新しいリージョンをプロビジョニングするには、[リージョンを有効にする] をクリックします。詳細については、新しいリージョンを有効にするをご覧ください。
3. 統合用のサービスアカウントを選択します。統合のサービスアカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
  注: サービスアカウントを選択するオプションは、選択したリージョンで統合ガバナンスを有効にしている場合にのみ表示されます。
4. [作成] をクリックします。
統合エディタで統合が開きます。
統合エディタのナビゲーションバーで、[タスク] をクリックして、使用可能なタスクとコネクタのリストを表示します。
統合エディタで [Call REST Endpoint] 要素をクリックして配置します。
デザイナーで [Call REST Endpoint] 要素をクリックし、[Call REST Endpoint] タスク構成ペインを表示します。
次の表に示すように、タスクの構成プロパティを使用して、表示されるフィールドを構成します。
プロパティへの変更は自動的に保存されます。

構成プロパティ

次の表に、REST エンドポイントの呼び出しタスクの構成プロパティを示します。

プロパティ	データ型	説明
ラベル	文字列	省略可: タスクのラベルを追加します。
認証	文字列	省略可: 外部システムへの接続の認証の詳細を構成して保存します。詳細については、Application Integration で認証プロファイルを作成するをご覧ください。
エンドポイントのベース URL	String（文字列）	クエリパラメータのない REST エンドポイント URL。
HTTP メソッド	なし	使用する HTTP メソッド。以下の HTTP メソッドのいずれかを選択できます。 DELETE GET HEAD PATCH POST PUT
URL クエリ文字列パラメータ	クエリ文字列キー: 文字列値: 文字列	REST API 呼び出しに必要なクエリパラメータです。クエリパラメータは Key-Value ペアの形式です。key はキー名、value は対応するキーの値です。プラス（+）アイコンをクリックすると、複数の Key-Value ペアを入力できます。
HTTP ヘッダー	HTTP ヘッダーキー: 文字列値: 文字列	REST API 呼び出しに必要な HTTP ヘッダーです。 HTTP ヘッダーは Key-Value ペアの形式です。key はキー名、value は対応するキーの値です。プラス（+）アイコンをクリックすると、複数の Key-Value ペアを入力できます。
リダイレクトのフォロー	ブール値	URL リダイレクトを行います。次のいずれかの値を選択できます。 True: エンドポイントのベース URL が別の URL に転送される場合に、リダイレクト URL を呼び出します。 False: エンドポイントのベース URL が別の URL に転送される場合に、リダイレクト URL を呼び出しません。
タスクが HTTP エラーで失敗するはずである	ブール値	REST API 呼び出しが失敗した場合の例外処理の方法。 HTTP レスポンスコードが `4xx` または `5xx` の場合、REST エンドポイントの呼び出しは失敗します。エラーコードのリストについては、エラーコードをご覧ください。他の HTTP レスポンスコードの場合は、レスポンスでエラーコードとエラーメッセージを返します。注: URL が間違っているなど、REST API 呼び出しに関係しないエラーの場合、このオプションの設定に関係なく、タスクは常に失敗します。次のいずれかの値を選択できます。 True : 例外をスローします。 False: 例外をスローしません。ただし、レスポンスでエラーコードとエラーメッセージを返します。
レスポンスヘッダー（<タスク名>）	String（文字列）	REST API のレスポンスからの圧縮されていないレスポンスヘッダー。
レスポンス本文（<タスク名>）	String（文字列）	REST API のレスポンスからの圧縮されていないレスポンスの本文。
レスポンスステータス（<タスク名>）	String（文字列）	REST API レスポンスからの HTTP レスポンスコードと、対応するコードテキスト。

ベストプラクティス

REST エンドポイントの呼び出しタスクに適用される使用量上限については、使用量上限をご覧ください。

エラー処理方法

タスクのエラー処理方法では、一時的なエラーによってタスクが失敗した場合のアクションを指定します。エラー処理方式と、さまざまな種類のエラー処理方式の詳細については、エラー処理方法をご覧ください。

4xx エラーまたは 5xx エラーの再試行戦略を処理する方法については、レスポンスのステータスに基づいて残りの呼び出し元タスクを再試行する方法のブログをご覧ください。