Consulte os conectores compatíveis com a integração de aplicativos.

Fazer upload e download de integrações

É possível fazer o download das suas integrações como um arquivo JSON e salvá-las no sistema local. Como resultado, toda sua integração está disponível em um arquivo, que pode ser carregado diretamente em outro projeto de integração sem qualquer modificação. O upload de uma integração cria uma nova versão no projeto em que o arquivo é enviado.

A integração total em um formato de arquivo traz as seguintes vantagens:
  • Você pode copiar sua integração de um projeto para outro sem muito esforço.
  • Você pode atualizar programaticamente o arquivo de integração para mudanças repetitivas, como renomear tarefas ou modificar dinamicamente os nomes das variáveis.

Fazer o download de uma integração

Para fazer o download de uma integração, selecione uma das seguintes opções:

Console

  1. No console do Google Cloud, acesse a página Application Integration.

    Acessar o Application Integration

  2. No menu de navegação, clique em Integrações. A página Integrations é exibida.
  3. Selecione uma integração existente. Isso abre a integração na página do editor de integração.
  4. Clique no menu suspenso Versões e selecione a versão que você quer salvar.
  5. Na barra de ferramentas do designer, clique em (menu "Ações") e selecione Download.

    O arquivo INTEGRATION_NAME.json é salvo automaticamente na pasta de download padrão do navegador da Web.

API

Para fazer o download de uma integração, envie uma solicitação GET para a seguinte 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

No exemplo a seguir, mostramos como fazer o download de uma versão específica de uma integração:

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"

Para ver mais informações, consulte projects.locations.integrations.versions.download.

Fazer upload de uma integração

O upload de uma integração cria uma nova versão no projeto em que o arquivo é enviado. Por exemplo, se você tiver uma integração com o nome IP-Test na versão 5 e fizer upload de um arquivo de integração em IP-Test, uma nova versão 6 será criada para a integração.

Se você não tiver uma integração na qual possa fazer upload de um arquivo, primeiro crie uma nova integração e, em seguida, faça o upload. Nesse caso, a nova integração criada estará na versão 1 e a integração enviada por upload estará na versão 2.

Se você tiver uma integração que quer fazer upload, selecione uma das seguintes opções:

Console

  1. No console do Google Cloud, acesse a página Application Integration.

    Acessar o Application Integration

  2. No menu de navegação, clique em Integrações. A página Integrations é exibida.
  3. Selecione uma integração existente ou clique em CRIAR INTEGRAÇÃO.

    Caso você esteja criando uma nova integração, siga estas etapas:

    1. Digite um nome e uma descrição na caixa de diálogo Criar integração.
    2. Selecione uma região para a integração.
    3. Clique em Criar.

    Isso abre a integração na página do editor de integração.

  4. Na barra de ferramentas do designer, clique em (menu "Ações") e selecione Fazer upload.
  5. Na caixa de diálogo do navegador de arquivos, selecione o arquivo que você quer enviar e clique em Abrir.

    Uma nova versão da integração é criada usando o arquivo enviado.

API

Para fazer upload de uma integração, emita uma solicitação POST para a seguinte API:
  https://integrations.googleapis.com/v1/projects/$YOUR_GOOGLE_PROJECT_ID/locations/$PROJECT_LOCATION/integrations $INTEGRATION_NAME/versions/$INTEGRATION_VERSION}:upload
  

No exemplo a seguir, mostramos como fazer o upload de uma integração:

  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
  

Para ver mais informações, consulte projects.locations.integrations.versions.upload.

A seguir