Steg 2: anslut Google API och konfigurera workflow

Lagra API-endpoints, API-nycklar och användarinställningar som återanvänds i hela workflowet.

1. Lägg till Configuration Setup och aktivera Include Other Fields.
2. Ställ in googleBooksApiUrl till https://www.googleapis.com/books/v1/volumes.
3. Ställ in googleCustomSearchApiUrl till https://www.googleapis.com/customsearch/v1.
4. Ställ in googleCustomSearchApiKey till <__PLACEHOLDER_VALUE__Google_Custom_Search_API_Key__> och googleCustomSearchEngineId till <__PLACEHOLDER_VALUE__Search_Engine_ID__>.
5. Mappa userEmail till inskickat formulärvärde med {{ $json['メール送信先 (Email Address)'] }}.
6. Ställ in sheetId till <__PLACEHOLDER_VALUE__Google_Sheet_ID__> och amazonAffiliateTag till <__PLACEHOLDER_VALUE__Amazon_Associate_Tag__>.

Steg 3: konfigurera boksökning och mappning av metadata

Hämta bokdetaljer från Google Books och förbered ren metadata för efterföljande steg.

1. I Fetch Book Data API, ställ in URL till {{ $('Configuration Setup').first().json.googleBooksApiUrl }}?q=intitle:{{ encodeURIComponent($json.bookTitle) }}{{ $json.authorName ? '+inauthor:' + encodeURIComponent($json.authorName) : '' }}&maxResults=1&langRestrict=ja.
2. Konfigurera Validate Book Availability med ett numeriskt villkor: leftValue {{ $json.totalItems }} är större än 0.
3. I Map Book Metadata, mappa fält som bookTitle till {{ $json.items[0].volumeInfo.title }} och bookAuthors till {{ $json.items[0].volumeInfo.authors ? $json.items[0].volumeInfo.authors.join(', ') : 'Unknown' }}.
4. Mappa även bookDescription, bookIsbn, bookCoverImage, bookPublisher och bookPublishedDate med uttrycken som är definierade i Map Book Metadata.

Steg 4: konfigurera AI Book Curator

Samla in recensionsutdrag, skapa AI-prompten och tolka strukturerad JSON-output.

1. I Retrieve Review Snippets, ställ in URL till {{ $('Configuration Setup').first().json.googleCustomSearchApiUrl }}?key={{ $('Configuration Setup').first().json.googleCustomSearchApiKey }}&cx={{ $('Configuration Setup').first().json.googleCustomSearchEngineId }}&q={{ encodeURIComponent($json.bookTitle + ' 書評 感想') }}&num=5.
2. I Assemble AI Prompt Data, ställ in reviewSnippets till {{ $json.items ? $json.items.map(item => item.snippet).join('\n\n') : 'No reviews found' }}.
3. Konfigurera AI Book Curator med Text satt till 書籍情報: 書名: {{ $json.bookTitle }} 著者: {{ $json.bookAuthors }} あらすじ: {{ $json.bookDescription }} Web上のレビュー: {{ $json.reviewSnippets }} och behåll Prompt Type som define.
4. Koppla Structured JSON Parser till AI Book Curator och behåll JSON-schemaexemplet som det är.
5. Inloggning krävs: Anslut era openAiApi-inloggningsuppgifter i OpenAI Chat Engine (detta är språkmodellen som driver AI Book Curator). Structured JSON Parser är en verktygsnod—credentials läggs till i OpenAI Chat Engine, inte i parsern.

Steg 5: konfigurera output och loggning

Generera HTML-mejlet, skicka det till läsaren och logga förfrågan i Google Sheets.

1. I Compose HTML Email, behåll den medföljande JavaScript-koden som bygger htmlEmail och emailSubject med data från Map Book Metadata och AI Book Curator.
2. Konfigurera Dispatch Email Message med Send To satt till {{ $('Configuration Setup').first().json.userEmail }}, Message satt till {{ $json.htmlEmail }} och Subject satt till {{ $json.emailSubject }}.
3. Inloggning krävs: Anslut era gmailOAuth2-inloggningsuppgifter i Dispatch Email Message.
4. I Append Sheet Log, ställ in Operation till appendOrUpdate, Sheet Name till History och Document ID till {{ $('Configuration Setup').first().json.sheetId }}.
5. Mappa kolumner med uttrycken i Append Sheet Log, till exempel {{ $now.format('yyyy-MM-dd HH:mm') }} för date och {{ $('AI Book Curator').first().json.review_summary }} för ai_comment.
6. Inloggning krävs: Anslut era googleSheetsOAuth2Api-inloggningsuppgifter i Append Sheet Log.

Steg 6: konfigurera villkorsstyrd routing för saknade böcker

Hantera fall där Google Books API returnerar noll resultat.

1. Säkerställ att Validate Book Availability har två utgångar: grenen true till Map Book Metadata och grenen false till Send Missing Book Notice.
2. I Send Missing Book Notice, ställ in Send To till {{ $('Configuration Setup').first().json.userEmail }} och behåll det förinställda japanska notifieringsmeddelandet.
3. Ställ in Subject till 📚 読書アドバイザー: 書籍が見つかりませんでした och Email Type till text.
4. Inloggning krävs: Anslut era gmailOAuth2-inloggningsuppgifter i Send Missing Book Notice.

Steg 7: testa och aktivera ert workflow

Verifiera hela flödet från formulärinsändning via AI-output till leverans av mejl.

1. Klicka på Execute Workflow och skicka in Reader Request Form med en känd boktitel.
2. Bekräfta att Fetch Book Data API returnerar totalItems > 0 och att AI Book Curator producerar strukturerad JSON.
3. Verifiera att mejlet från Dispatch Email Message renderar HTML:en och att Append Sheet Log lägger till en rad i arket History.
4. Testa en titel som inte finns för att säkerställa att Validate Book Availability routar till Send Missing Book Notice.
5. När allt är verifierat, växla workflowet till Active för användning i produktion.