Ir para o conteúdo

Google - Planilhas

Interaja e execute várias operações por meio de uma conta do Google. Leia, escreva e atualize arquivos de planilha facilmente através do plugin BotCity para o Google Planilhas.

Instalação

pip install botcity-googlesheets-plugin

Importando o Plugin

Depois de instalar este pacote e obter o arquivo de credenciais Google, o próximo passo é importar o pacote para o seu código e começar a usar as funções.

from botcity.plugins.googlesheets import BotGoogleSheetsPlugin

Instanciando o Plugin

Para fazer o exemplo, instanciaremos o plugin usando o caminho do arquivo de credenciais e o ID da planilha que queremos usar.

# Instancie o plugin
bot_planilha = BotGoogleSheetsPlugin(CAMINHO_ARQUIVO_CREDENCIAIS, 'ID_PLANILHA')

Dica

Você pode encontrar o ID da planilha na sua URL. Por exemplo, se a URL da planilha for https://docs.google.com/spreadsheets/d/1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t1u2v3w4x5y6z7/edit, o ID da planilha é 1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t1u2v3w4x5y6z7.

Manipulando dados da planilha

Agora, vamos manipular alguns dados do nosso arquivo, adicionando novos dados e retornando o conteúdo de leitura.

# Adiciona alguns dados
bot_planilha.add_row(['nome', 'idade'])
bot_planilha.add_rows([['Peter', '53'], ['Paulo', '35']])

# Classifica as colunas por idade ascendente
bot_planilha.sort('b')

# Imprime a lista resultante
print(bot_planilha.as_list())

Código completo

Vamos dar uma olhada no código completo:

from botcity.plugins.googlesheets import BotGoogleSheetsPlugin

# Instancie o plugin
bot_planilha = BotGoogleSheetsPlugin(CAMINHO_ARQUIVO_CREDENCIAIS, 'ID_PLANILHA')

# Adiciona alguns dados
bot_planilha.add_row(['nome', 'idade'])
bot_planilha.add_rows(['Peter', '53'], ['Paulo', '35'])

# Classifica as colunas por idade ascendente
bot_planilha.sort('b')

# Imprime a lista resultante
print(bot_planilha.as_list())

Dica

Este plugin permite que você use encadeamento do método para que o código acima possa ser escrito assim:

dados = [['nome', 'idade'], ['Peter', '53'], ['Paulo', '35']]
tratando_dados = BotGoogleSheetsPlugin(CAMINHO_ARQUIVO_CREDENCIAIS, 'id_planilha')
        .add_rows(linhas)
        .sort('b')
        .as_list()

print(tratando_dados)