Inserir uma imagem em uma célula do Planilhas Google

Resumo: exiba uma imagem dentro de uma célula do Google Sheets usando a fórmula IMAGE do Google Sheets e a atividade Write Cell.

Aplicativos: Planilhas Google

Descrição: este exemplo explica como usar a atividade Write Cell para escrever a fórmula IMAGE do Google Sheets em uma célula, que exibe uma imagem acessível publicamente diretamente dentro da célula.

Observação:

A API do Google Sheets não é compatível com a inserção de imagens diretamente nas células. Esse tutorial mostra uma solução alternativa usando a fórmula IMAGE , que faz referência a um URL de imagem acessível publicamente e o renderiza dentro da célula.

Fluxo de Trabalho

1. Abra o Studio Web e crie um novo projeto.
2. Adicione uma atividade Write Cell ao seu fluxo de trabalho.
3. Na atividade, configure o seguinte:
   • Configure sua conexão do Planilhas Google.
   • No campo Planilha , navegue e selecione a planilha de destino.
   • No campo Planilha/Intervalo nomeado , selecione a planilha na qual você deseja inserir a imagem, por exemplo, Sheet1.
   • No campo Célula , insira a célula de destino, por exemplo, A1.
   • No campo O que escrever , insira a fórmula IMAGE com o URL acessível publicamente da sua imagem: =IMAGE("https://example.com/your-image.png").
4. Para controlar como a imagem se encaixa na célula, adicione um parâmetro de modo à fórmula. Os seguintes modos estão disponíveis:
   • =IMAGE("url", 1) — Redimensiona a imagem para caber dentro da célula, mantendo a proporção original. Esse é o comportamento padrão.
   • =IMAGE("url", 2) — Estica ou comprime a imagem para preencher a célula, ignorando a proporção.
   • =IMAGE("url", 3) — Exibe a imagem em seu tamanho original. A imagem pode ser cortado se for maior do que a célula.
   • =IMAGE("url", 4, height, width) — Exibe a imagem em um tamanho personalizado. Substitua height e width pelos valores de pixels desejados, por exemplo: =IMAGE("url", 4, 100, 200).
5. Pronto para executar seu projeto.

Limitações

Mantenha as seguintes limitações em mente ao usar essa abordagem:

• O URL da imagem deve ser acessível publicamente por HTTPS. Imagens atrás de restrições de autenticação ou acesso não são compatíveis.
• As imagens do Google Drive devem ser compartilhadas publicamente (definidas como Qualquer pessoa com o link pode visualizar) para que a fórmula IMAGE as exiba. Os links de arquivos privados do Google Drive não funcionam.
• A fórmula IMAGE adiciona uma referência dinâmica ao URL da imagem, não um objeto incorporado estático. A imagem exibida é atualizada se o conteúdo no URL de origem for alterado.