Preparar a planilha

O que fazer no Google Sheets antes de conectar: criar uma planilha, compartilhá-la e copiar o link

Você não precisa criar um projeto no Google Cloud, ativar uma API ou baixar uma chave JSON — a conta de serviço já está configurada do lado do serviço. Tudo o que é necessário da sua parte é a própria planilha, o acesso a ela e o seu link.

Passo 1. Crie uma planilha

Abra o Google Sheets e crie uma nova planilha — ou use uma que você já utiliza. O nome da planilha pode ser qualquer um, o serviço não o verifica.

Passo 2. Copie o endereço da conta de serviço

O endereço é exibido na sua conta — é com essa conta que você vai compartilhar a planilha.

  1. Abra Conexão API — o item "Conexão API" no menu do usuário (canto superior direito da sua conta).
  2. Encontre o cartão "Google Sheets".
  3. Na linha "Conta de serviço", clique no ícone de cópia ao lado do endereço — a notificação "E-mail copiado" aparece.
Captura de telaO cartão "Google Sheets" na página "Conexão API" no estado "Não conectado": a linha "Conta de serviço" com o endereço e um botão de cópia, a linha "Planilha" com o valor "Não conectado", e o botão "Conectar" no cabeçalho do cartão.

Passo 3. Compartilhe a planilha com a função "Editor"

  1. Abra sua planilha no navegador.
  2. Clique em "Compartilhar" no canto superior direito (em algumas versões da interface do Google, este item se chama "Configurações de compartilhamento").
  3. Cole o endereço copiado da conta de serviço.
  4. Escolha a função "Editor".
  5. Clique em "Enviar".
A função "Leitor" não é suficiente: o serviço não apenas lê a planilha, ele também grava resultados nela. Até que o acesso seja concedido, a planilha simplesmente não existe para o serviço — o teste de conexão responde "Planilha não encontrada ou não compartilhada com a conta de serviço".
Esses mesmos cinco passos estão sempre à mão na sua conta: o botão "Como?" ao lado do endereço da conta de serviço os abre em uma janela. O próprio serviço mostra essa mesma janela quando encontra falta de acesso.

Passo 4. Copie o link da planilha

O link é o endereço da planilha aberta na barra de endereços do navegador:

https://docs.google.com/spreadsheets/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit

Copie-o por completo — não é preciso extrair o identificador do meio do endereço, o serviço faz isso sozinho.

A planilha está pronta. A seguir — Conectando a planilha.