Ações do Planilhas Google
As ações do Google Sheets são ações de interação com a solução G Suite Google Sheets, uma solução online e colaborativa para planilhas.
Depois de começar a usar essas ações, é importante ter uma conta de serviço e compartilhar sua planilha com a conta de serviço.
Ações
google.sheets.append
Anexe novas linhas à planilha. Se você definir cell_range
como A1, Marvin tomará cuidado para não sobrepor nenhum dado, e anexará o novo conteúdo na primeira linha em branco após A1
, sempre inserindo novos dados após a última linha da planilha.
Parâmetros:
planilha - Variável de planilha retornada por google.sheets.open
cell_range - intervalo de células em que Marvin começará a anexar novos dados no Planilhas Google. Pode ser uma célula única como A1
, definindo que todas as colunas e linhas devem ser inseridas após a célula A1
, ou pode ser um intervalo A1:C1
, novos dados serão inseridos após esse intervalo.
line_values (opcional) - array com cada índice sendo uma coluna diferente, exemplo:
grid_values (opcional) - uma grade onde cada linha representará uma linha e cada elemento de linha representará uma coluna, exemplo:
[
['Linha 1 - Col1', 'Linha 1 - Col2', 'Linha 1 - Col3'],
['Linha 2 - Col1', 'Linha 2 - Col2', 'Linha 2 - Col3']
]
Retorna:
updated_range - intervalo de células que foram anexadas à planilha.
first_col - identificação da primeira coluna anexada em update_range.
first_row - identificação da primeira linha anexada em update_range.
last_col - identificação da última coluna anexada em update_range.
last_row - identificação da última linha anexada em update_range.
Exceções:
Esta ação não retorna nenhuma exceção
google.sheets.delete_rows
Exclui todas as linhas entre o número da linha inicial e o número da linha final.
Parâmetros:
planilha - planilha a ser usada para excluir linhas.
start - número da primeira linha a ser excluída.
end (opcional) - número da última linha a ser excluída. Se apenas uma linha precisam ser deletados, este parâmetro não precisa ser informado.
Retorna:
Esta ação não tem retorno.
Exceções:
GoogleSheetsException - se ocorrer algum problema durante a exclusão de linhas.
google.sheets.get_cell
Retorna o valor de uma célula específica.
Parâmetros:
planilha - Planilha a ser usada para excluir linhas.
cell_range - número da primeira linha a ser excluída.
value_render_option (opcional) - define o tipo de inserção na planilha (padrão=FORMATTED_VALUE). Mais informações podem ser encontradas em este link
Retorna:
updated_range - intervalo de células que foram anexadas à planilha.
first_col - identificação da primeira coluna anexada em update_range.
first_row - identificação da primeira linha anexada em update_range.
last_col - identificação da última coluna anexada em update_range.
last_row - identificação da última linha anexada em update_range.
Exceções:
GoogleSheetsException - se ocorrer algum problema durante a exclusão de linhas.
google.sheets.open
Abra uma planilha do Google on-line para começar a usá-la.
Para usar qualquer uma das soluções de integração do Google, é necessário ter uma conta de serviço do Google GCP. Este é um arquivo JSON usado para autenticar e autorizar você a usar o Google Sheet. Para mais informações sobre como criá-lo, verifique este tutorial.
A imagem acima mostra como obter as informações que precisam passar como parâmetro nesta ação:
Parâmetros:
spreadsheet_id - ID da planilha com a qual se conectar. Este ID pode ser encontrado no URL da planilha.
Exemplo:
URL: https://docs.google.com/spreadsheets/d/1_aF0LPBxZZ4vImNKAg8KjDNzb3rqx88-46eatuQmA0c/edit#gid=0
ID da planilha: 1_aF0LPBxZZ4vImNKAg8KjDNzb3rqx88-46eatuQmA0c
current_sheet - nome da planilha a ser aberta como padrão e pode ser encontrada na parte inferior da tela do Planilhas Google.
service_account_path - caminho para o arquivo JSON com a autorização da conta de serviço. Para obter mais informações sobre como criar esta credencial, consulte este link
Retorna:
planilha - Variável de planilha a ser usada e passada para todas as outras ações do Planilhas Google.
Exceções:
Esta ação não retorna nenhuma exceção
google.sheets.update
Atualiza as células do Planilhas Google, atualizando as células para os valores fornecidos
Parâmetros:
planilha - Planilha a ser usada para excluir linhas.
cell_range - identificação da célula (A1 por exemplo) para iniciar a atualização dos valores.
line_values (opcional) - array com cada índice sendo uma coluna diferente, exemplo:
grid_values (opcional) - uma grade onde cada linha representará uma linha e cada elemento de linha representará uma coluna, exemplo:
[
['Linha 1 - Col1', 'Linha 1 - Col2', 'Linha 1 - Col3'],
['Linha 2 - Col1', 'Linha 2 - Col2', 'Linha 2 - Col3']
]
value_input_option (opcional)- Determina como os dados de entrada devem ser interpretados (padrão=RAW). Os valores podem ser:
Valor | Descrição |
---|---|
RAW | Os valores inseridos pelo usuário não serão analisados e serão armazenados como estão |
USER_ENTERED | Os valores serão analisados como se o usuário os digitasse na interface do usuário. Os números permanecerão como números, mas as strings podem ser convertidas em números, datas etc. seguindo as mesmas regras aplicadas ao inserir texto em uma célula por meio da interface do usuário do Planilhas Google |
Retorna:
updated_range - intervalo de células que foram atualizadas na planilha.
first_col_updated - identificação da primeira coluna atualizada em update_range.
first_row_updated - identificação da primeira linha atualizada em update_range.
last_col_updated - identificação da última coluna atualizada em update_range.
last_row_updated - identificação da última linha atualizada em update_range.
Exceções:
GoogleSheetsException - se ocorrer algum problema durante a atualização das células.
Ative a API do Planilhas Google e crie uma conta de serviço
Para usar as ações do Planilhas Google, primeiro você precisa criar uma conta de serviço
-
Acesse console do Google GCP e selecione o projeto em que deseja ativar a API do Planilhas Google e crie o
-
Acesse Gerenciamento da API do Planilhas Google e ative o uso da API
-
Clique em Credenciais
-
Clique em Criar credenciais e depois em Conta de serviço
-
Dê um nome à sua nova Conta de Serviço e preencha todas as informações solicitadas e clique em CONCLUÍDO
-
As próximas duas etapas são necessárias apenas se você quiser um controle mais preciso sobre as concessões e acessos desta Conta de Serviço. Se você não precisar, basta clicar em CONCLUÍDO nessas etapas.
-
Após a criação da Conta de Serviço, na tela Credenciais, clique na Conta de Serviço criada
-
Adicione uma nova chave a esta Conta de serviço, clicando em ADICIONAR CHAVE e depois em Criar nova chave
-
Selecione a opção JSON para criar, clique em CREATE e aguarde o download do arquivo JSON.
-
Agora você compartilha sua planilha do Google com sua Conta de serviço. Não se esqueça de dar privilégios para editar a planilha se quiser que Marvin o faça.
Compartilhe a planilha com a conta de serviço
-
Em seu Planilhas Google, clique em Compartilhar
-
Em Adicionar pessoas e grupos, insira seu endereço de Conta de serviço
-
Verifique se os privilégios corretos são concedidos à Conta de Serviço. Se você deseja que o Marvin altere, exclua ou insira novos dados em sua planilha, você deve definir como Editor.