Integrasi Google Sheets untuk AI Flowi Workflow

Oleh Ai Flowi · Diterbitkan · Dikemas kini

Sumber rasmi: dokumentasi Google Sheets API

Integrasi Google Sheets dengan AI Flowi Workflow membolehkan anda membaca atau mengubah data hamparan menggunakan komponen yang tersedia. Pelan: Go dari USD8/bulan dengan bil tahunan (USD10 bulanan), lima pelan sehingga Pro 500. Semua pelan disenaraikan di halaman harga. Aliran kerja bersambung boleh menggunakan mana-mana pelan Flowi. Harga disemak pada 1 November 2026. Pada 8 Oktober 2026, resipi webhook yang diuji dalam persekitaran produksi menambah satu baris bagi permintaan sah yang disahkan dan mengembalikan 200. Mulakan dengan aliran kerja yang boleh dimuat turun, kemudian konfigurasikan akaun Google dan helaian anda.

Perkara yang boleh anda lakukan dengan Google Sheets

Katalog komponen menyenaraikan 23 komponen yang tersedia untuk Google Sheets. Senarai di bawah menggunakan semua nama tepat dalam katalog. Setiap satunya tersedia sebagai komponen; kewujudan dalam katalog sahaja tidak membuktikan kejayaan semasa pelaksanaan. Append Rows diuji dalam persekitaran produksi dalam resipi 8 Oktober, dan Upsert Row diuji dalam persekitaran produksi dalam versi perlindungan pendua pada 9 Oktober. Keputusan tersebut terpakai pada konfigurasi yang didokumenkan.

  • Add Sheet
  • Append Rows
  • Bulk Upsert Rows
  • Clear Range
  • Clear Sheet
  • Copy Sheet
  • Create Spreadsheet
  • Delete Columns
  • Delete Rows
  • Delete Sheet
  • Duplicate Sheet
  • Find & Replace
  • Get Spreadsheet
  • Insert Columns
  • Insert Rows
  • List Sheets
  • Read Range
  • Rename Sheet
  • Resize Sheet
  • Search & Delete Row
  • Search Row
  • Update Range
  • Upsert Row

Sumber: Katalog komponen Google Sheets. Semak medan wajib dan kelayakan akses komponen yang dipilih sebelum membina aliran anda sendiri.

Sambungkan akaun Google anda

Gunakan sambungan Google yang disimpan dalam komponen Sheets pilihan anda. Panduan persediaan memberikan langkah berikut:

  1. Buka Settings > Google Connections dan berikan kebenaran kepada akaun Google yang ingin anda gunakan.
  2. Kembali ke komponen dan pilih akaun Google yang disimpan dalam medan sambungannya.
  3. Konfigurasikan medan wajib komponen dan pastikan sambungan mempunyai skop yang diperlukan untuk operasi tersebut.
  4. Jalankan aliran kerja dengan item ujian yang boleh anda semak dalam Google Sheets.

Jika ia gagal, semak Connection yang disimpan, akses akaun yang dilog masuk kepada helaian, dan skop yang diperlukan untuk tindakan tersebut. Berikan kebenaran semula apabila kebenaran tidak lagi dapat diperbaharui, kemudian cuba semula tindakan yang sama dengan sumber yang boleh diakses oleh akaun itu.

Sumber: Persediaan sambungan akaun Google dan Penyelesaian masalah sambungan Google.

Resipi yang diuji: webhook ke Google Sheets

Resipi tanpa model ini diuji dalam persekitaran produksi pada 8 Oktober 2026 menggunakan permintaan HTTP POST sintetik dan helaian Google yang dicipta oleh aplikasi. Ia menggunakan Universal Webhook, JSON Operations, Verification Router, Append Rows dan Webhook Response. JSON Operations mengesahkan dan menyediakan baris; Verification Router menghantar input sah dan input yang ditolak ke cabang masing-masing.

Aktifkan POST, pilih pengesahan Platform API Key dan tetapkan POST Response Mode kepada From Flow. Titik akhir produksi melaksanakan aliran. Titik akhir ujian hanya merekodkan permintaan, jadi ia tidak dapat membuktikan penulisan yang selesai atau balasan From Flow. Tepat satu Webhook Response mesti terpakai pada cabang yang dilaksanakan.

Keputusan yang direkodkan: 8 Oktober 2026
PermintaanKeputusan HTTPKeputusan helaian
Input sah yang disahkan200Satu baris ditambah.
E-mel tiada, jenis medan salah, e-mel tidak sah atau JSON yang tidak terbentuk dengan betul422Tiada baris ditambah.
Kunci API tiada atau tidak sah403Tiada baris ditambah.

Aliran kerja yang telah dibersihkan daripada maklumat sensitif diimport ke dalam aliran kosong dan diuji semula. Selepas import, pilih Google Account anda, tetapkan Spreadsheet ID dan julat, serta konfigurasikan pengesahan webhook. Versi yang lebih ringkas menggunakan Sheet1!A:C dengan lajur name,email,request dan menambah satu lagi baris bagi setiap penghantaran yang serupa.

Ikuti persediaan webhook ke Sheets yang telah diuji.

Sumber: keputusan resipi yang direkodkan, Universal Webhook dan Webhook Response.

Semak keputusan ujian webhook ke Google Sheets sebelum menggunakan fail muat turun; keputusan ini terpakai pada konfigurasi yang direkodkan.

Cegah baris pendua

Versi yang diuji pada 9 Oktober 2026 menggunakan Upsert Row dengan event_id yang dibekalkan oleh pemanggil. Gunakan semula pengecam yang sama untuk percubaan semula peristiwa yang sama; gunakan pengecam berbeza untuk peristiwa baharu. Penghantaran pertama mengembalikan 200 {"status":"inserted"}. Penghantaran ulangan secara berurutan mengemas kini baris yang sama, tidak menambah baris dan mengembalikan 200 {"status":"duplicate"}; penulisan terakhir diutamakan.

Kunci ialah teks peka huruf besar/kecil sepanjang 1–100 aksara, yang disimpan tanpa membuang ruang pada awal atau akhir. Perlindungan terhad kepada satu helaian kerja dalam satu hamparan dan berterusan selagi baris itu wujud. Mengedit atau memadam kuncinya membolehkan sisipan lain. Kedua-dua penghantaran pendua serentak boleh menyisipkan baris kerana komponen membaca kemudian menulis tanpa penguncian. Baris pendua sedia ada tidak digabungkan.

Baca persediaan perlindungan pendua, keputusan ujian dan batasan sebelum menggunakan fail muat turun tersebut.

Apakah yang berlaku apabila ralat Google Sheets menghentikan aliran?

Dalam resipi AI Flowi Workflow 1.9.2 yang didokumenkan, ralat Google Sheets menghentikan aliran sebelum Webhook Response di hiliran dijalankan. Titik akhir mengembalikan HTTP 404 (atau 500) bersama ralat mentah komponen, termasuk URL Google API dan Spreadsheet ID. Ujian Spreadsheet ID yang salah mengembalikan 404 mentah; respons 502 terkawal tidak berjaya dihasilkan.

Sahkan Spreadsheet ID dan perkongsian sebelum mula digunakan dalam produksi. Tiada cabang ralat dalam aliran untuk versi ini, dan respons di hiliran tidak dapat menangkap kegagalan tersebut. Jangan dedahkan respons titik akhir secara bulat-bulat kepada pengguna akhir.

Sumber: batasan kegagalan hamparan yang telah diuji.

Gunakan panduan pengendalian ralat webhook untuk menyemak batasan ralat mentah hamparan dan merancang respons kepada pemanggil.

Kos

Setiap pelaksanaan nod menggunakan 1 Flowi Token. Pelan: Go dari USD8/bulan dengan bil tahunan (USD10 bulanan), lima pelan sehingga Pro 500. Semua pelan disenaraikan di halaman harga.

Resipi yang diuji tidak menggunakan model AI. Penggunaan API pihak ketiga tidak termasuk dalam langganan AI Flowi. Lihat harga AI Flowi Workflow untuk pelan tersebut.

Sumber: katalog komponen, panduan sambungan Google, penyelesaian masalah sambungan, resipi Sheets yang telah diuji, pencetus webhook dan respons webhook.