Application Integration でサポートされているコネクタをご覧ください。
統合のアップロードとダウンロード
統合を JSON ファイルとしてダウンロードして、ローカル システムに保存できます。そのため、統合全体を 1 つのファイルで使用でき、このファイルを変更せずに別の統合プロジェクトに直接アップロードできます。統合をアップロードすると、ファイルがアップロードされたプロジェクトに新しいバージョンの統合が作成されます。
統合全体を 1 つのファイル形式で行うと、次のような利点があります。- ほとんど労力をかけずに、プロジェクト間で統合をコピーできます。
- タスク名の変更や変数名の動的な変更など、反復的な変更のために統合ファイルをプログラムで更新できます。
統合をダウンロードする
統合をダウンロードするには、次のいずれかのオプションを選択します。
Console
- Google Cloud コンソールで [Application Integration] ページに移動します。
- ナビゲーション メニューで [統合] をクリックします。[Integrations] ページが表示されます。
- 既存の統合を選択します。 統合エディタで統合が開きます。
- [Versions] プルダウンをクリックして、ダウンロードするバージョンを選択します。
- デザイナー ツールバーで、[
INTEGRATION_NAME.json ファイルは、ウェブブラウザのデフォルトのダウンロード フォルダに自動的に保存されます。
](アクション メニュー)をクリックし、[ダウンロード] を選択します。
API
統合をダウンロードするには、次の API にGET
リクエストを発行します。https://integrations.googleapis.com/v1/projects/*/locations/*/integrations/*/versions/*:download を取得https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download
次の例は、特定のバージョンの統合をダウンロードする方法を示しています。
curl -v -s \ -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \ -H "X-GFE-SSL: yes" \ -X GET "https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11:download"
詳細については、projects.locations.integrations.versions.download
をご覧ください。
統合をアップロードする
統合をアップロードすると、ファイルがアップロードされたプロジェクトに新しいバージョンの統合が作成されます。たとえば、バージョン 5 の IP-Test
という名前の統合があり、IP-Test
に統合ファイルをアップロードすると、統合用に新しいバージョン 6 が作成されます。
ファイルをアップロードできる既存の統合がない場合は、新しい統合を作成してからアップロードする必要があります。この場合、作成する新しい統合はバージョン 1 で、アップロードされた統合はバージョン 2 になります。
アップロードする既存の統合がある場合は、次のいずれかのオプションを選択します。
Console
- Google Cloud コンソールで [Application Integration] ページに移動します。
- ナビゲーション メニューで [統合] をクリックします。[Integrations] ページが表示されます。
- 既存の統合を選択するか、[統合を作成] をクリックして新しい統合を作成します。
新しい統合を作成する場合:
- [Create Integration] ダイアログで名前と説明を入力します。
- 統合のリージョンを選択します。
- [作成] をクリックします。
統合エディタで統合が開きます。
- デザイナー ツールバーで、[ ](アクション メニュー)をクリックし、[Upload] を選択します。
- ファイル ブラウザ ダイアログで、アップロードするファイルを選択し、[開く] をクリックします。
統合の新しいバージョンは、アップロードされたファイルを使用して作成されます。
API
統合をアップロードするには、POST
リクエストを次の API に発行します。https://integrations.googleapis.com/v1/projects/$YOUR_GOOGLE_PROJECT_ID/locations/$PROJECT_LOCATION/integrations $INTEGRATION_NAME/versions/$INTEGRATION_VERSION}:upload
次の例は、統合をアップロードする方法を示します。
curl -v -s -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \ -X POST -d '{"content": "{\"name\":\"projects/450954726404/locations/us-east1/integrations/test-workflow/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11\", \"origin\":\"UI\", \"snapshotNumber\":\"3\", \"updateTime\":\"2022-01-06T04:26:58.137Z\", \"lockHolder\":\"abc@test.com\", \"createTime\":\"2022-01-06T04:26:42.734Z\", \"lastModifierEmail\":\"abc@test.com\", \"state\":\"DRAFT\", \"triggerConfigs\":[{\"label\":\"API Trigger\",\"startTasks\":[{\"taskId\":\"1\"}], \"properties\":{\"Trigger name\":\"rj-test-workflow_API_1\"},\"triggerType\":\"API\",\"triggerNumber\":\"1\",\"triggerId\":\"api_trigger/rj-test-workflow_API_1\"}],\"taskConfigs\":[{\"task\":\"EmailTask\",\"taskId\":\"1\",\"taskExecutionStrategy\":\"WHEN_ALL_SUCCEED\",\"displayName\":\"Send Email\"}]}"}' \https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions:upload
詳細については、projects.locations.integrations.versions.upload
をご覧ください。
次のステップ
- 統合を管理する方法を学習する。
- 統合をテストして公開する方法を学習する。
- すべてのタスクとトリガーを確認する。