Crie um diário de leitura com busca por ISBN nas Planilhas Google

Piotr Grudzień
Publicado em 9 min de leitura
A linha finalizada de Pride and Prejudice no Planilhas Google, ao lado da resposta do Quickchat AI que recupera a nota.

O que você escreveu quando terminou Pride and Prejudice? Neste diário de leitura, a resposta é “I kept noticing who misunderstood whom.” (Eu reparava o tempo todo em quem interpretava mal quem). Ela pertence à edição em capa comum da Penguin, ISBN 9780141439518, concluída em 8 de novembro. A frase continua lá quando você abre uma nova conversa.

Você vai criar Shelf Notes, um diário de leitura privado no Google Sheets. O Open Library fornece os detalhes da edição, você fornece a data e a ideia que quer guardar, e um Agent do Quickchat AI coloca tudo na mesma linha depois da sua confirmação.

A entrada PAP-01 finalizada no Planilhas Google e a nota exata do leitor em um novo chat do Quickchat AI.
A aba Events tem duas entradas para PAP-01. A segunda guarda a nota de 8 de novembro. Em um novo chat, o Quickchat AI lê a planilha e devolve a mesma frase.

Baixe o kit inicial do Shelf Notes. Abra Shelf Notes.xlsx para ver o exemplo pronto. Use os dois arquivos TSV para montar seu próprio diário nas Planilhas Google. Eles começam uma entrada antes, quando a leitora ainda está lendo. O kit também contém as configurações exatas da Action e o Main Prompt.

1. Qual edição está na sua estante?

Teste a busca antes de conectar qualquer coisa. Abra a edição do ISBN 9780141439518. É uma edição em capa comum em inglês, com 435 páginas, publicada pela Penguin Books em 2003. O romance de Jane Austen apareceu pela primeira vez em 1813. As duas datas pertencem a Pride and Prejudice, mas só uma descreve o exemplar que está na sua mesa.

A ficha da edição no Open Library e o registro proposto no Inbox do Shelf Notes para a mesma edição da Penguin em capa comum.
Encontre a edição da Penguin em capa comum no Open Library. Antes de salvar, confira a editora e o ano de publicação no registro que o Quickchat AI propõe.
  1. Crie sua conta em Quickchat AI ou faça login. Use seu Agent vazio ou escolha Add new AI Agent → Set up manually. Dê a ele o nome Shelf Notes. Você vai precisar de uma conta Google para o diário e de créditos de IA disponíveis para testar uma conversa.
  2. Antes de adicionar notas pessoais, abra Your Website → Install → Availability and access. Desative Widget & Embed access, defina Chat Page Access como Nobody e mantenha os outros canais desconectados. Use AI Preview no painel em que você está conectado.
  3. Em Identity → Main Prompt, cole main-prompt.txt do kit. Ele orienta o Agent a mostrar a entrada proposta e esperar uma confirmação separada.
  4. Em Actions & MCPs → Add Action → API Action → Create manually, crie as duas Actions GET abaixo. Em cada uma, use When to run → AI decides, adicione um parâmetro obrigatório Text chamado isbn em What to ask the user first e deixe o corpo vazio. Remova espaços e hífens do número, mantendo os zeros à esquerda e um X final no ISBN-10.
Nome da açãoEndpoint da APIO que usar do resultado
lookup_book_isbnhttps://openlibrary.org/search.jsonEm Query Params, insira isbn={{isbn}}, fields=key,title,author_name,first_publish_year e limit=1. A obra fornece o autor e o ano original do romance.
lookup_editionhttps://openlibrary.org/isbn/{{isbn}}.jsonVerifique se o número informado aparece em isbn_13 ou isbn_10. Leia a editora, a data da edição e o idioma quando estiverem presentes. Acrescente a chave retornada, que começa com /books/, a https://openlibrary.org para formar o link da fonte.

O parâmetro ISBN e a requisição a Open Library no editor de Actions do Quickchat AI. Digite o ISBN na conversa. A Action o insere em uma URL cujo host fica fixo no editor.

Na nossa primeira busca, também pedimos a lista de edições da obra. Para este ISBN, isso trouxe de volta 4.042 IDs de edição. Ao remover esse campo, a resposta ficou curta, com o autor e o ano original. A segunda solicitação ainda retornou a única edição em capa comum que queríamos.

Em Headers, dê a cada requisição um User-Agent com o valor ShelfNotes/1.0 (YOUR_CONTACT_EMAIL), substituindo o contato de exemplo pelo seu. Cole a API Action Description correspondente de action-recipes.md, salve e ative cada Action. Teste “Look up ISBN 978-0-14-143951-8.”. Você deve ver a edição sem criar uma entrada no diário. Esta busca pessoal não exige uma conta no Open Library. Use-a quando alguém perguntar sobre um livro e siga as diretrizes de uso da API do Open Library.

2. O que entra no diário de leitura?

Separe os fatos de catálogo e as suas próprias observações em colunas diferentes. Você pode emprestar esta edição exata para alguém e discordar sobre todos os personagens. O ISBN continua o mesmo. A sua nota pertence à sua leitura, identificada aqui como PAP-01.

  1. Abra Actions & MCPs → Add Action → Google Sheets → Connect. Autorize a conta Google que será usada como dona do diário e depois escolha Open sheet. A conexão cria uma planilha no Drive com a permissão drive.file. O guia de conexão com o Google Sheets mostra as telas de autorização. Para um diário pessoal, abra Compartilhar no Planilhas Google e mantenha Acesso geral como Restrito.
  2. Desative a Action inicial ativa, log_lead_to_google_sheet. Mantenha o nome dela e copie seu API Endpoint com o ID do arquivo já preenchido. Deixe a Action inicial desativada. Você vai criar Actions separadas para este diário.

A conexão com as Planilhas Google no Quickchat AI e a tela do Google para escolher a conta que será usada com o Quickchat AI. Abra o arquivo criado para este Agent. A Action inicial já contém o ID da planilha que você precisa.

  1. Renomeie a aba Leads para Events e substitua o conteúdo por Events.tsv, começando em A1. Formate as colunas B (ISBN) e F (data) como Plain text antes de colar. Adicione uma segunda aba chamada Status. Em uma nova planilha de exemplo, use File → Settings → Locale → United States para que as fórmulas abaixo aceitem vírgulas.

A aba Events de Shelf Notes no Planilhas Google, com a entrada inicial de Pride and Prejudice e a aba Status ao lado. Comece pela linha 2. PAP-01 ainda está em leitura, com “Started with the Netherfield visit.” em G2. Depois que você confirmar, a entrada finalizada aparecerá na linha 3.

As oito colunas de Events, nesta ordem, são reading_id, isbn, title, edition_url, status, reading_date, note e conversation. A última célula guarda um link de volta para a conversa. O primeiro evento do modelo inicial diz reading em 2 de novembro. A nota é “Started with the Netherfield visit.”

A linha do diário dividida entre campos de catálogo, campos do leitor e o link da conversa. Mantenha um único ID de leitura enquanto um livro passa de reading para finished. Escolha um novo quando você voltar ao livro para uma releitura.

3. Como salvar uma nota de leitura pelo ISBN?

A busca responde “Qual livro?”. Salvar responde outra pergunta: “É isso que eu quero lembrar?”. Configure uma Action para acrescentar a linha confirmada e outra para verificar o que a planilha realmente contém.

  1. Crie uma API Action chamada append_reading_event. Copie a URL do Planilhas Google do modelo inicial, mantendo tudo até o ID real do arquivo. Substitua o restante por /values/Events!A:H:append. Defina POST e adicione em Query Params a entrada valueInputOption=RAW. O modo de entrada bruta preserva os ISBNs e trata uma nota que começa com = como texto.
  2. Em Headers, defina Authorization como Bearer {{google_sheets_access_token}} e Content-Type como application/json. Quickchat AI preenche o token no momento da requisição.
  3. Adicione seis parâmetros obrigatórios Text chamados reading_id, isbn, title, edition_url, status e reading_date. Adicione um parâmetro opcional Text chamado note com valor padrão em branco. Escolha reading, finished, paused ou abandoned para o status. Use a data informada pelo leitor como YYYY-MM-DD.
  4. Em API Endpoint → Body, cole o JSON abaixo. Os dois conjuntos de colchetes significam uma linha com oito células. conversation_url já vem embutido. Cole a descrição de acréscimo do kit em API Action Description.
  5. Crie read_reading_journal como um GET para a mesma planilha, terminando em /values/Events!A2:H1000. Dê a ele o mesmo cabeçalho bearer, a descrição de histórico do kit, nenhum parâmetro e um corpo vazio. Salve e habilite as duas Actions.
{
  "values": [[
    "{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
    "{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
  ]]
}

A configuração de entrada RAW da Action de append e as oito células no corpo JSON dela. O array corresponde às colunas A até H. Manter a nota na sétima posição coloca as palavras do leitor na coluna G.

Com a linha inicial pronta, envie a mensagem a seguir em AI Preview.

Look up ISBN 978-0-14-143951-8. I finished PAP-01 on 2026-11-08. My note: I kept noticing who misunderstood whom.

Confira a edição proposta, o ID, a data e a pontuação. Neste ponto, Events ainda deve conter apenas a entrada inicial. Depois diga “Yes, that is my edition. Save PAP-01 with that status, date and note.”. Um segundo evento deve aparecer na linha 3.

Shelf Notes mostra a edição, a data e a nota, e pede permissão para salvar. A proposta dá a você uma última chance de conferir o ISBN e a sua redação. Você pode corrigir qualquer um dos dois antes de o diário mudar.

No nosso teste ao vivo, a proposta manteve a linha inicial intacta. Depois da confirmação, Shelf Notes verificou o diário, conferiu o ISBN novamente, adicionou uma linha e leu essa nova linha para checar. Em Inbox, expanda append_reading_event e compare o updates.updatedRange do Google com as células da sua planilha. Se uma solicitação expirar, procure a linha antes de tentar de novo. Referência de adição de linhas do Google Sheets

A adição de linha bem-sucedida pelo Quickchat AI e a nota de leitura confirmada na célula G3 do Planilhas Google. O Google informou uma linha e oito células atualizadas em Events!A3:H3. Selecione G3 para comparar o texto com a nota que você aprovou.

4. O que você pode perguntar em uma nova conversa?

Abra uma nova conversa no AI Preview e pergunte “What was the last note I saved for PAP-01?”. No nosso teste, o Agent leu Events novamente e retornou “I kept noticing who misunderstood whom.” A linha 2 ainda guarda a nota anterior de Netherfield. O Google pode omitir células vazias no fim de uma linha retornada, então é normal que o link da conversa fique em branco na sua linha inicial.

Para “Which books am I still reading?”, dois eventos para uma mesma leitura dariam uma resposta enganosa se você contasse cada linha. Use a aba Status para selecionar o último evento acrescentado para cada ID de leitura.

  1. Cole Status.tsv em Status!A1. A fórmula em A2 lista cada ID de leitura uma vez. B2 usa uma busca por correspondência exata começando do fim de Events. Preencha B2 para baixo ao lado dos novos IDs conforme a sua estante crescer. D2 conta os IDs cujo status mais recente é finished.
  2. Crie read_reading_status, outro GET com o mesmo cabeçalho Bearer, usando o sufixo /values/Status!A1:B1000. Cole a descrição de status do kit, deixe o corpo e os parâmetros vazios, depois salve e habilite.
  3. Pergunte quais livros estão concluídos. No exemplo, Status tem uma leitura concluída, PAP-01. Para uma segunda leitura do romance, dê a ela PAP-02. Assim você pode distinguir o que percebeu na primeira vez do que percebeu na segunda.
Na aba Status do Planilhas Google, o estado passa de reading para finished e a contagem de leituras concluídas vai de zero a uma. Em uma nova conversa, o Shelf Notes responde com finished.
Status!B2 mostra finished e D2 conta uma leitura. Mantenha Events na ordem de adição, mesmo para entradas retroativas. Use uma visualização filtrada para navegar.
Copie as três fórmulas no Planilhas Google

Status!A2 lista os IDs.

=SORT(UNIQUE(IFERROR(FILTER(Events!A2:A1000,Events!A2:A1000<>""),"")),1,TRUE)

Status!B2 busca o evento mais recente para o ID da coluna A.

=IF(A2="","",XLOOKUP(A2,Events!$A$2:$A$1000,Events!$E$2:$E$1000,"",0,-1))

Status!D2 conta as leituras concluídas.

=COUNTIF(B2:B1000,"finished")

A receita cobre 999 eventos. Antes que uma nova entrada caia abaixo da linha 1000, estenda juntos os intervalos de leitura e os intervalos das fórmulas. Lembre-se de notas longas e coleções grandes ao decidir quanto histórico retornar em uma única conversa. Referência do XLOOKUP no Google Sheets

5. Isso funciona com o livro que está na sua mesa?

Pegue outro livro e teste o ISBN impresso dele. Peça a edição e depois pare. Uma boa primeira verificação é conseguir consultar um livro sem adicioná-lo. Em seguida, dê a ele um ID de leitura e uma frase que só você poderia ter escrito. Confirme, feche o chat e peça essa frase de volta.

Para fazer verificações reproduzíveis, use Testing → Simulation e depois confira Actions & MCPs → View logs e as células de destino. Experimente um ISBN não reconhecido, recuse uma entrada sugerida e salve uma nota de teste começando com =1+1. As duas primeiras ações devem deixar o histórico intacto. A última deve mostrar os caracteres literais na célula da nota.

Também fizemos a planilha local salvar uma linha e depois atingir o tempo limite antes de responder. Shelf Notes leu a linha de volta, informou o timeout e não fez uma segunda inclusão. Você pode conferir esse mesmo detalhe no log da Action se um salvamento deixar você em dúvida sobre enviar de novo.

Open Library retorna uma edição não encontrada, e Shelf Notes pede ao leitor que confira o ISBN. No teste de edição ausente, o catálogo retornou 404. O Agent pediu outro identificador, e o diário manteve suas duas linhas.

Se você preferir configurar o Agent em outro assistente, o kit inclui uma solicitação de configuração para o conector de conta do Quickchat AI. Anexe action-recipes.md e main-prompt.txt e depois envie setup-request.txt. Revise as cinco Actions, conclua você mesmo a autorização do Google e faça o mesmo teste de leitura. Conector do ChatGPT · Conector do Claude · Guia de configuração da conta

Perguntas frequentes

Como adiciono um livro às Planilhas Google pelo ISBN?

Use o ISBN impresso no seu exemplar para localizar a edição dele no Open Library. Confira o título, a editora e o ano, adicione seu status de leitura e sua nota e depois confirme a linha. O kit inicial inclui os cabeçalhos da planilha, as fórmulas e as cinco receitas de Action do Quickchat AI.

Posso usar um diário de leitura que eu já tenho no Google Sheets?

Copie as entradas que você quiser para a aba Events da planilha criada pela conexão do Quickchat AI. Mantenha as oito colunas correspondentes e os ISBNs como texto. Colar o ID de outro arquivo privado na Action não dá permissão para abrir esse arquivo.

E se o Open Library não encontrar meu ISBN?

Confira o número no código de barras ou na página de copyright, incluindo qualquer zero à esquerda ou X no final. Se ainda não der para verificar a edição, deixe o diário como está. Um ISBN identifica uma edição e não dá acesso ao texto completo do livro.

Como conto os livros concluídos e acompanho releituras?

Dê a cada leitura seu próprio ID. Mantenha esse ID quando você pausar ou concluir o livro e dê um novo ID a uma releitura. Conte as entradas concluídas na aba Status. Assim, duas leituras concluídas da mesma edição contam duas vezes, enquanto duas atualizações de uma mesma leitura contam uma vez.

Posso encontrar uma nota de leitura depois de fechar a conversa?

Sim. Peça o livro ou o ID da leitura em uma nova conversa privada. A Action de histórico lê a aba Events de novo, onde ficam armazenadas as entradas com data e o texto original que você escreveu. A aba Status fornece o estado registrado mais recente de cada leitura.

Quickchat AI Quickchat AI Ask Quickchat AI a question