# Atualizar Planilha

## CONFIGURAÇÃO

Para utilizar esse objeto é necessário Autenticar, ter em mãos as informações corretas e configurar os parâmetros desejados.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fy79G70aj4RLBiCfHfbIs%2Fimage.png?alt=media&#x26;token=96e817fd-4ea9-4909-acb6-f29bb5482d22" alt=""><figcaption><p>Layout geral do objeto</p></figcaption></figure>

**Preenchendo o objeto:**

| Campo                          | Descritivo                                                                                                                                                                                                                                                       |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Título                         | É o nome do objeto e **não precisa ser alterado**, a menos que você queira identificá-lo para facilitar a localização dele no robô, por exemplo: "Atualizar Planilha - Dados da Empresa".                                                                        |
| Nome identificador objeto      | É um identificador único do objeto e **não precisa ser alterado**, mas você pode renomear caso queira para localizá-lo mais facilmente quando for usá-lo em outros objetos. Apenas lembre-se que esse nome deve ser único e sem espaços ou caracteres especiais. |
| Autenticador Google Sheets API | Opção para selecionar objeto [Autenticação do Google Sheets API](https://docs.roboteasy.tech/studio/geral/objetos/google-sheets-api/autenticacao-do-google-sheets-api).                                                                                          |
| ID da planilha                 | Opção para preencher o ID da planilha. [Documentação ensinando](https://docs.roboteasy.tech/studio/geral/objetos/google-sheets-api/configurar-google-sheets).                                                                                                    |
| Nome da Aba                    | Opção para preencher o nome da aba da planilha do Google Sheets que será modificada.                                                                                                                                                                             |
| + Adicionar Célula             | Opção para adicionar mais células que serão acrescentadas com novas informações.                                                                                                                                                                                 |
| Coluna                         | Indicar a coluna da nova informação                                                                                                                                                                                                                              |
| Linha                          | Indicar a linha da nova informação                                                                                                                                                                                                                               |
| Tipo de entrada                | Padrão (adiciona valores padrões texto ou número) ou Fórmula (adiciona alguma fórmula de Excel).                                                                                                                                                                 |
| Valores                        | Campo para preencher os valores que serão inseridos no Google sheets.                                                                                                                                                                                            |
| Ícone de lixeira               | Ícone para deletar células novas.                                                                                                                                                                                                                                |

{% hint style="info" %}
**INTERPOLAÇÃO**

Trata-se de um conceito técnico utilizado em programação e você não precisa se preocupar em alterá-lo neste momento.
{% endhint %}

## PRÉ-REQUISITOS

* Para utilizar o objeto corretamente é necessário configurar o objeto [Autenticação do Google Sheets API.](https://docs.roboteasy.tech/studio/geral/objetos/google-sheets-api/autenticacao-do-google-sheets-api)

## CASOS DE USO

* Utilizar quando precisar atualizar com novas informações um documento Google Sheets.

## ID DA PLANILHA

* Os objetos do Google Sheets API pedem o ID da planilha, para pegar ela basta verificar na sua URL, vejamos: Sempre vai ficar entre o /d/ e /edit...

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F4Pl3E3T48jcFY8UaBWJf%2Fimage.png?alt=media&#x26;token=9502f03d-8111-4f34-9d0f-075fac5aee05" alt=""><figcaption><p>ID da Planilha</p></figcaption></figure>

## PERMISSÃO PARA EDITAR

* As planilhas do google sheets precisam que o usuário principal de permissão ao usuário que foi criado dentro do projeto, ou seja, aquele e-mail longo em Credenciais.
* Para isso basta ir em Compartilhar no canto superior direito e colocar o e-mail desejado.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FXmg2Xv5YRhfOW9altvra%2Fimage.png?alt=media&#x26;token=6a872455-bf8f-4139-b105-543074460ba7" alt=""><figcaption><p>Compartilhar</p></figcaption></figure>

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F1Jgl3XwtqxZrEkiMFx3y%2Fimage.png?alt=media&#x26;token=068b5d56-e975-4600-a28d-2eb9ce4c88f6" alt=""><figcaption><p>E-mail com autorização para editar.</p></figcaption></figure>

## EXEMPLO

Verificar em tela a atualização de novas informações sendo inseridas.

<details>

<summary>ITENS UTILIZADOS NO ROBÔ</summary>

* **Objetos:** [Autenticação do Google Sheets API.](https://docs.roboteasy.tech/studio/geral/objetos/google-sheets-api/autenticacao-do-google-sheets-api)

</details>

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FCbnWZkQBiImafZ7KQdlE%2Fimage.png?alt=media&#x26;token=5d265aa9-5019-4fd8-837b-0d4332b06e06" alt=""><figcaption><p>Configuração Robô Exemplo Atualizar Planilha</p></figcaption></figure>

**PASSO 1:** Configurar Autenticação do Google Sheets API com o [JSON autenticado](https://docs.roboteasy.tech/studio/geral/objetos/google-sheets-api/configurar-google-sheets).&#x20;

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FyuHDMMXDh1hGsCOmvSWH%2Fimage.png?alt=media&#x26;token=05a149d8-5fa1-4692-99b5-e49c5bcc74cd" alt=""><figcaption><p>Configuração Autenticação do Google Sheets API</p></figcaption></figure>

**PASSO 2:** Configurar Atualizar Planilha.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F375v8Tg5S1JgU5Hf17H0%2Fimage.png?alt=media&#x26;token=37aec489-c90c-4674-a214-3d2d1bc0ee2c" alt=""><figcaption><p>Configuração Atualizar Planilha</p></figcaption></figure>

PASSO 3: Executar o robô e verificar as ações.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fzt5HuOb95hdQCJy4AeLb%2Fsucesso.gif?alt=media&#x26;token=d04945ee-1844-4822-808d-66a9f4a79027" alt=""><figcaption><p>Execução Sucesso Robô Exemplo Atualizar Planilha</p></figcaption></figure>

## Baixar o robô

{% hint style="info" %}
Não será disponibilizado por conter informações/documentos sensíveis.&#x20;
{% endhint %}