Sobre a Criação de Ações de Dados da API HTTP

Você pode criar ações de dados da API HTTP para estabelecer conexão com uma API REST em uma pasta de trabalho.

Você configura uma ação de dados da API HTTP para informar valores de coluna selecionados de uma pasta de trabalho para uma API REST que retorna uma resposta. Observe o seguinte:

  • Não há limite para o número de ações de dados que você pode criar.

  • Um URL pode conter tokens que transmitem valores contextuais a uma ação de dados, por exemplo, valores de dados, nome do usuário, caminho da pasta de trabalho, nome da tela.

    O seguinte exemplo de URL da API REST inclui um valor de token da coluna Categoria que exibe a API do Google livros: http://www.googleapis.com/books/v1/volumes?q=${valuesForColumn:"Category"}. O valor que você seleciona em uma célula na coluna Categoria, por exemplo, "Books", é transmitido à API REST, que exibe a página solicitada.

  • Se você usar um método POST, ou usar o cabeçalho HTTP personalizado que substitui o cabeçalho HTTP, o seguinte será aplicado:

    • Informe cada parâmetro como um par de nome/valor, com o nome e o valor separados por "=".
    • É possível usar a mesma sintaxe de token do URL nos pares de nome/valor, conforme exigido pela API que você está chamando. Por exemplo:
      • paramName1=paramValue1
      • paramName2=${valuesForColumn:"Product"}
    • Um cabeçalho personalizado funcionará se o destino da solicitação HTTP permitir especificamente que os cabeçalhos HTTP que você estiver usando sejam definidos na solicitação. Se os cabeçalhos não forem permitidos, o browser bloqueará a solicitação e exibirá uma mensagem de erro; por exemplo, um cabeçalho Cookie, contendo Content-Type=application/json, será bloqueado.