Conecta-seEntrar na plataforma

Google Docs

Ler, criar, escrever e editar documentos do Google Docs.

Integrações e ferramentasArquivos e documentosConexão: OAuth

O que faz

Integre o Google Docs ao fluxo. Leia, escreva e crie documentos, insira texto, tabelas, imagens e quebras de página, localize e substitua texto e aplique estilos ao texto.

Quando usar: Use quando o seu fluxo precisar ler, criar, escrever e editar documentos do Google Docs.

Exemplo de situação: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

  1. Adicione Google Docs ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Ler documentoLê documento com o bloco Google Docs.
Escrever no documentoEscreve no documento com o bloco Google Docs.
Criar documentoCria documento com o bloco Google Docs.
Inserir textoInsere texto com o bloco Google Docs.
Localizar e substituir textoLocaliza e substituir texto com o bloco Google Docs.
Inserir tabelaInsere tabela com o bloco Google Docs.
Inserir imagemInsere imagem com o bloco Google Docs.
Inserir quebra de páginaInsere quebra de página com o bloco Google Docs.
Aplicar estilo de textoAplica estilo de texto com o bloco Google Docs.
Aplicar estilo de parágrafoAplica estilo de parágrafo com o bloco Google Docs.
Criar lista com marcadoresCria lista com marcadores com o bloco Google Docs.
Remover lista com marcadoresRemove lista com marcadores com o bloco Google Docs.
Excluir intervalo de conteúdoExclui intervalo de conteúdo com o bloco Google Docs.
Criar intervalo nomeadoCria intervalo nomeado com o bloco Google Docs.
Excluir intervalo nomeadoExclui intervalo nomeado com o bloco Google Docs.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Ler documento · Escrever no documento · Criar documento · Inserir texto · Localizar e substituir texto · Inserir tabela · Inserir imagem · Inserir quebra de página · Aplicar estilo de texto · Aplicar estilo de parágrafo · Criar lista com marcadores · Remover lista com marcadores · Excluir intervalo de conteúdo · Criar intervalo nomeado · Excluir intervalo nomeado
    Padrão:
    Ler documento

  • Conta do Google

    Obrigatório

    Seleciona a conta já conectada que autoriza o acesso ao serviço.

    Exemplo:
    (escolha a conta conectada)

  • Conta do Google

    ObrigatórioEm campos adicionais

    Informa manualmente a credencial usada pela integração no modo avançado.

  • Conta representada

    E-mail do usuário a representar (para contas de serviço).

    Exemplo:
    cliente@exemplo.com

  • Documento

    Selecione um documento.

    Aparece em:
    Ler documento, Escrever no documento, Inserir texto, Localizar e substituir texto, Inserir tabela, Inserir imagem, Inserir quebra de página, Aplicar estilo de texto, Aplicar estilo de parágrafo, Criar lista com marcadores, Remover lista com marcadores, Excluir intervalo de conteúdo, Criar intervalo nomeado, Excluir intervalo nomeado
    Exemplo:
    (escolha na lista do campo)

  • ID do documento

    Em campos adicionais

    Informe o ID do documento.

    Aparece em:
    Ler documento, Escrever no documento, Inserir texto, Localizar e substituir texto, Inserir tabela, Inserir imagem, Inserir quebra de página, Aplicar estilo de texto, Aplicar estilo de parágrafo, Criar lista com marcadores, Remover lista com marcadores, Excluir intervalo de conteúdo, Criar intervalo nomeado, Excluir intervalo nomeado
    Exemplo:
    id-do-recurso

  • Título do documento

    Obrigatório conforme a operação

    Informe o título do novo documento.

    Aparece em:
    Criar documento
    Exemplo:
    Exemplo de atendimento

  • Selecionar pasta pai

    Selecione uma pasta pai.

    Aparece em:
    Criar documento
    Exemplo:
    (escolha na lista do campo)

  • ID da pasta pai

    Em campos adicionais

    Informe o ID da pasta pai (deixe vazio para a pasta raiz).

    Aparece em:
    Criar documento
    Exemplo:
    id-do-recurso

  • Conteúdo

    Obrigatório conforme a operação

    Informe o conteúdo do documento.

    Aparece em:
    Escrever no documento
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Interpretar o conteúdo como Markdown

    Converte títulos, negrito/itálico, listas, tabelas, links, código e citações em conteúdo formatado do Google Docs. Quando desativado, o conteúdo é inserido como texto simples.

    Aparece em:
    Criar documento
    Exemplo:
    false

  • Texto

    Obrigatório conforme a operação

    Informa o texto que será processado pelo bloco.

    Aparece em:
    Inserir texto
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Localizar

    Obrigatório conforme a operação

    Texto a localizar.

    Aparece em:
    Localizar e substituir texto
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Substituir por

    Texto substituto (deixe vazio para apagar as ocorrências).

    Aparece em:
    Localizar e substituir texto
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Diferenciar maiúsculas e minúsculas

    Quando ativado, só são substituídas as ocorrências com as mesmas letras maiúsculas e minúsculas.

    Aparece em:
    Localizar e substituir texto
    Exemplo:
    false

  • Linhas

    Obrigatório conforme a operação

    Quantidade de linhas da tabela que será inserida no documento do Google Docs (ex.: 3).

    Aparece em:
    Inserir tabela
    Exemplo:
    3

  • Colunas

    Obrigatório conforme a operação

    Quantidade de colunas da tabela que será inserida no documento do Google Docs (ex.: 2).

    Aparece em:
    Inserir tabela
    Exemplo:
    2

  • URL da imagem

    Obrigatório conforme a operação

    URL pública da imagem a inserir.

    Aparece em:
    Inserir imagem
    Exemplo:
    https://api.exemplo.com/v1/recurso

  • Largura (pt)

    Em campos adicionais

    Largura em pontos (opcional).

    Aparece em:
    Inserir imagem
    Exemplo:
    Largura em pontos (opcional)

  • Altura (pt)

    Em campos adicionais

    Altura em pontos (opcional).

    Aparece em:
    Inserir imagem
    Exemplo:
    Altura em pontos (opcional)

  • Posição inicial

    Obrigatório conforme a operação

    Posição do caractere inicial (inclusiva).

    Aparece em:
    Aplicar estilo de texto, Aplicar estilo de parágrafo, Criar lista com marcadores, Remover lista com marcadores, Excluir intervalo de conteúdo, Criar intervalo nomeado
    Exemplo:
    Posição do caractere inicial (inclusiva)

  • Posição final

    Obrigatório conforme a operação

    Posição do caractere final (exclusiva).

    Aparece em:
    Aplicar estilo de texto, Aplicar estilo de parágrafo, Criar lista com marcadores, Remover lista com marcadores, Excluir intervalo de conteúdo, Criar intervalo nomeado
    Exemplo:
    Posição do caractere final (exclusiva)

  • Negrito

    Ativa ou desativa este comportamento.

    Aparece em:
    Aplicar estilo de texto
    Exemplo:
    false

  • Itálico

    Ativa ou desativa este comportamento.

    Aparece em:
    Aplicar estilo de texto
    Exemplo:
    false

  • Sublinhado

    Ativa ou desativa este comportamento.

    Aparece em:
    Aplicar estilo de texto
    Exemplo:
    false

  • Tamanho da fonte (pt)

    Em campos adicionais

    Tamanho da fonte em pontos (opcional).

    Aparece em:
    Aplicar estilo de texto
    Exemplo:
    10

  • Estilo de parágrafo

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Aplicar estilo de parágrafo
    Opções:
    Padrão (sem alteração) · Texto normal · Título · Subtítulo · Título 1 · Título 2 · Título 3 · Título 4 · Título 5 · Título 6
    Exemplo:
    Padrão (sem alteração)

  • Alinhamento

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Aplicar estilo de parágrafo
    Opções:
    Padrão (sem alteração) · Esquerda · Centro · Direita · Justificado
    Exemplo:
    Padrão (sem alteração)

  • Estilo dos marcadores

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Criar lista com marcadores
    Opções:
    Disco / Círculo / Quadrado · Caixa de seleção · Seta / Losango / Disco · Estrela / Círculo / Quadrado · Numerada: decimal / alfabética / romana · Numerada: decimal aninhada
    Exemplo:
    Disco / Círculo / Quadrado

  • Nome do intervalo

    Obrigatório conforme a operação

    Nome do intervalo (de 1 a 256 caracteres).

    Aparece em:
    Criar intervalo nomeado
    Exemplo:
    Exemplo de atendimento

  • ID do intervalo nomeado

    ID do intervalo nomeado a excluir.

    Aparece em:
    Excluir intervalo nomeado
    Exemplo:
    id-do-recurso

  • Nome do intervalo nomeado

    Nome do(s) intervalo(s) nomeado(s) a excluir.

    Aparece em:
    Excluir intervalo nomeado
    Exemplo:
    A1:D20

  • Posição de inserção

    Em campos adicionais

    Posição do caractere (deixe vazio para adicionar no final).

    Aparece em:
    Inserir texto, Inserir tabela, Inserir imagem, Inserir quebra de página
    Exemplo:
    Posição do caractere (deixe vazio para adicionar no final)

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <googledocs.content>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<googledocs.content>stringConteúdo do documento.
<googledocs.metadata>jsonMetadados do documento.
<googledocs.updatedContent>booleanStatus da atualização do conteúdo.
<googledocs.occurrencesChanged>numberNúmero de ocorrências substituídas ao localizar e substituir.
<googledocs.objectId>stringID do objeto de imagem inserido no texto.
<googledocs.namedRangeId>stringID do intervalo nomeado criado.

Exemplo de uso

Objetivo: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

InícioGoogle Docspróxima etapa
Operação
Ler documento
Conta do Google
(escolha a conta conectada)
Conta representada
cliente@exemplo.com
Documento
(escolha na lista do campo)

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <googledocs.content>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Erro de autorização ou permissão (401/403)
A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados