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

統合のアップロードとダウンロード

統合を JSON ファイルとしてダウンロードして、ローカル システムに保存できます。そのため、統合全体を 1 つのファイルで使用でき、このファイルを変更せずに別の統合プロジェクトに直接アップロードできます。統合をアップロードすると、ファイルがアップロードされたプロジェクトに新しいバージョンの統合が作成されます。

統合全体を 1 つのファイル形式で行うと、次のような利点があります。
  • ほとんど労力をかけずに、プロジェクト間で統合をコピーできます。
  • タスク名の変更や変数名の動的な変更など、反復的な変更のために統合ファイルをプログラムで更新できます。

統合をダウンロードする

統合をダウンロードするには、次のいずれかのオプションを選択します。

Console

  1. Google Cloud コンソールで [Application Integration] ページに移動します。

    Application Integration に移動

  2. ナビゲーション メニューで [統合] をクリックします。[統合] のページが表示されます。
  3. 既存の統合を選択します。 統合エディタで統合が開きます。
  4. [Versions] プルダウンをクリックして、ダウンロードするバージョンを選択します。
  5. デザイナー ツールバーで、[]（アクション メニュー）をクリックし、[ダウンロード] を選択します。

    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

  1. Google Cloud コンソールで [Application Integration] ページに移動します。

    Application Integration に移動

  2. ナビゲーション メニューで [統合] をクリックします。[統合] のページが表示されます。
  3. 既存の統合を選択するか、[統合を作成] をクリックして新しい統合を作成します。

    新しい統合を作成する場合:

    1. [Create Integration] ダイアログで名前と説明を入力します。
    2. 統合のリージョンを選択します。
    3. [作成] をクリックします。

    統合エディタで統合が開きます。

  4. デザイナー ツールバーで、[]（アクション メニュー）をクリックし、[Upload] を選択します。
  5. ファイル ブラウザ ダイアログで、アップロードするファイルを選択し、[開く] をクリックします。

    統合の新しいバージョンは、アップロードされたファイルを使用して作成されます。

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 をご覧ください。

次のステップ