# Google Sheets Add-on: extraia dados para sua planilha > Instale o add-on ImageToTable.ai pela Google Workspace Marketplace, conecte-o à sua conta existente com o login do Google ou uma API Key, e envie, processe e escreva as linhas extraídas direto na planilha que você tem aberta — gastando os mesmos créditos do aplicativo web. O **add-on ImageToTable.ai para Google Sheets** coloca a ferramenta de extração em um painel lateral ao lado da sua planilha. Você envia documentos, processa e escreve as linhas extraídas na planilha em que está trabalhando — usando a mesma conta, [modelos](/docs/reference/glossary#template) e [créditos](/docs/reference/glossary#credits) do site. ## Instalar o add-on Instale pela Google Workspace Marketplace: [ImageToTable.ai — Extract Data from Image](https://workspace.google.com/marketplace/app/imagetotableai_%E2%80%94_extract_data_from_image/758062068256?flow_type=2) Depois de instalado, abra qualquer Google Sheet e vá em **Extensions → ImageToTable.ai → Open**. O painel lateral aparece à direita da planilha; abra-o novamente do mesmo jeito sempre que precisar. ## Conectar sua conta O add-on usa sua conta ImageToTable.ai existente — não é preciso criar conta separada nem assinar nada extra. A seção **Account** no topo do painel lateral oferece duas formas de conectar: - **Sign in with Google.** Clique em **Sign in with Google** e aprove a solicitação. Se essa conta do Google já estiver vinculada a uma conta ImageToTable.ai, o painel lateral a abre; se não estiver, uma conta é criada para ela. - **Paste an API Key.** Digite ou cole a chave no campo **Paste API Key** e clique em **Save**. O campo informa onde encontrá-la: na seção **API Key** da sua página de perfil no site. A API Key é o que vincula o painel lateral à sua conta, então trate-a como uma senha — qualquer pessoa que a tiver pode agir como sua conta. Para obter uma, ou substituir uma que não quer mais usar, veja [API Key management](/docs/guides/api-key-management). Quando conectado, a seção Account mostra seu nome de usuário, seu plano e seu **Balance** em créditos. **Switch Account** conecta uma conta diferente por API Key, e **Sign out** desconecta o painel lateral sem afetar nada na planilha. Por ser a mesma conta, o painel lateral compartilha tudo com o aplicativo web: - A lista **Files** mostra os lotes da sua conta, incluindo os enviados ou processados no site. - A seção **Data Columns** funciona com os modelos que você já salvou no site. - O processamento gasta o mesmo saldo de créditos mostrado no seu perfil. ## O que você pode fazer no painel lateral ### Enviar documentos Na seção **Your Uploads**, use o botão **Upload** na guia **Files** para adicionar arquivos do seu computador. Imagens, PDFs, documentos Word (`.docx`) e arquivos de texto simples (`.txt`) são aceitos, e você pode selecionar vários de uma vez. Adicionar um PDF abre primeiro uma caixa de diálogo **Select PDF Pages**, para que você escolha quais páginas enviar em vez de ter que pegar o documento inteiro. Veja [Uploading Documents](/docs/guides/uploading-documents) para saber o que cada tipo de arquivo faz ao chegar. ### Escolher o que extrair A seção **Data Columns** funciona como a do painel principal. Digite um nome de coluna na caixa (ela sugere *Column name, e.g. Invoice Number*) e clique em **Add**; **New**, **Switch** e **Settings** criam, escolhem e configuram modelos. Qualquer modelo salvo no site está disponível aqui, então você pode configurar suas colunas uma vez e usá-las de qualquer lugar — veja [Templates & Columns](/docs/concepts/templates-and-columns). Se você começar a processar um lote sem colunas definidas e com mais de um arquivo, o painel lateral pode propor uma lista de **AI-Suggested Columns** antes de executar. ### Processar um lote Cada lote na lista de Files tem um controle de reprodução que inicia o processamento. O painel lateral verifica primeiro seus créditos disponíveis; se não houver o suficiente para cada arquivo, ele mostra uma caixa de diálogo **Insufficient Credits** oferecendo **Get More Credits** ou processar os arquivos que seu saldo cobre. Um lote já processado pode ser executado novamente, e o painel lateral pergunta se você deseja reenviar apenas os arquivos com falha e não processados ou reprocessar tudo. ### Gravar resultados na planilha **Insert** grava as linhas extraídas na planilha atualmente aberta. Você pode inserir o resultado de um único arquivo, um lote inteiro ou vários lotes de uma vez — resultados que compartilham as mesmas colunas são gravados sob um único cabeçalho, independentemente do lote de onde vieram. Cada linha inserida carrega seu **File Name** e **Batch** de origem, para que as linhas permaneçam rastreáveis depois de chegarem à planilha. Se as colunas de uma inserção corresponderem à última inserção nessa planilha, as linhas serão anexadas abaixo do cabeçalho existente. Se o conjunto de colunas for diferente, uma nova linha de cabeçalho é adicionada acima das novas linhas, em vez de misturá-las na tabela antiga. Antes de inserir, você pode abrir uma visualização que mostra a tabela extraída ao lado do documento original e permite navegar pelos arquivos do lote. O painel lateral processa arquivos no modo To Table, então o resultado gravado é a tabela extraída; um lote sem resultado de tabela não tem nada para inserir. Para um documento que você quer de volta como saída Word editável em vez de uma tabela, use o modo To Word do aplicativo web e [Exportar](/docs/guides/export). ## Como funcionam os créditos O add-on não tem cota própria separada. O processamento pelo painel lateral é cobrado nos mesmos [créditos](/docs/reference/glossary#credits) que o aplicativo web, à mesma taxa: uma cobrança por arquivo processado, definida pelo [Model Tier](/docs/concepts/model-tier) da sua conta. Como cada página de um PDF, Word ou arquivo de texto conta como um arquivo próprio, um documento multipágina usa vários créditos. A seção Account sempre mostra seu saldo atual, e **Get more** leva você à página de planos. Usar o add-on não gera nem consome um tipo diferente de crédito — um saldo gasto aqui é o mesmo saldo que você gastaria no site. Os detalhes por plano estão em [Plans & Credits](/docs/guides/plans-and-points). ## Perguntas frequentes ### Preciso de uma conta ou assinatura separada para o add-on? Não. O add-on se conecta à conta que você já tem e não tem cota separada. Qualquer plano que você tenha também se aplica aqui. ### Verei os mesmos arquivos e modelos do site? Sim. A lista de Files, os modelos em Data Columns e o saldo de créditos vêm todos da sua conta, então um lote enviado no site pode ser processado aqui e os resultados inseridos na sua planilha. ### Em qual planilha os resultados são inseridos? Na que estiver ativa quando você inserir — a guia selecionada na planilha à qual o painel lateral está anexado. Se você estiver inserindo um novo conjunto de colunas, uma linha de cabeçalho é adicionada acima dos dados. ### O que acontece se eu ficar sem créditos? O processamento não inicia. O painel lateral mostra quantos créditos você tem e quantos o lote precisa, e permite obter mais ou processar apenas os arquivos que seu saldo cobre. Consulte [Plans & Credits](/docs/guides/plans-and-points). --- Source: https://imagetotable.ai/pt/docs/guides/google-sheets-add-on