Pemetaan medan webhook untuk Google Sheets

Pemetaan medan webhook menukar contoh kandungan JSON webhook kepada lajur helaian mengikut susunan yang anda pilih. Alat percuma ini menyenaraikan laluan medan daun serta jenisnya, membina pemetaan baris JQ dan memaparkan pratonton nilainya. Alat ini berjalan dalam pelayar anda; alat pemetaan ini tidak menghantar atau menyimpan contoh anda.

Oleh Ai Flowi · Diterbitkan

Petakan medan anda

Tampalkan kandungan itu sendiri, tanpa membungkusnya dalam objek body. Gunakan contoh rekaan tanpa maklumat pengesahan akses atau data peribadi. JQ yang dijana membaca .body nod webhook.

Tatasusunan hanya menggunakan elemen pertama: items[0].sku memilih SKU item pertama. Item seterusnya dan medan yang hanya terdapat dalam item tersebut tidak disenaraikan. Objek kosong dan tatasusunan kosong tiada nilai daun.

1. Pilih medan daun

2. Susun lajur helaian

Gunakan Alih ke atas atau Alih ke bawah. Medan yang baru dipilih diletakkan di hujung. Pengepala menggunakan laluan dalam kandungan supaya nama medan dalam objek bersarang dapat dibezakan.

    3. Salin pemetaan

    Ungkapan ini membina {values: [[ ... ]]}. Ungkapan ini tidak mengesahkan permintaan masuk. Dalam panduan aliran kerja yang mempunyai pengesahan, ubah pembinaan baris dalam pertanyaan pengesahan; kekalkan semakan perlindungannya dan unjuran {values: .values} pada peringkat seterusnya. Lihat arahan penempatan.

    Bila perlu menggunakan alat pemetaan ini

    Gunakannya apabila webhook sudah mengandungi nilai yang diperlukan oleh helaian Google Sheets anda dan anda mahu memilih susunan lajurnya. Objek bersarang boleh membekalkan lajur seperti contact.email. Anda tidak memerlukan model untuk mengekstrak medan yang sudah wujud dalam JSON.

    Untuk pengesahan identiti, pengesahan data dan persediaan helaian, ikuti panduan aliran kerja webhook ke Google Sheets. Aliran kerjanya yang mempunyai pengesahan serta salinan yang diimport telah diuji dalam persekitaran operasi sebenar pada 8 Oktober 2026. Keputusan tersebut terpakai pada panduan aliran kerja itu, bukan pada setiap pemetaan tersuai yang dijana di sini.

    Contoh dengan langkah penerangan: name, email dan request

    Muatkan contoh rekaan ini, kemudian kekalkan pilihan name, email dan request mengikut susunan tersebut:

    {"name":"Amina","email":"amina@example.com","request":"Send a workflow demo"}

    Baris pengepalanya ialah name, email, request. Ungkapan pemetaannya ialah:

    (.body) as $b
| {values: [[ $b.name, $b.email, $b.request ]]}

    Baris pratontonnya ialah:

    ["Amina","amina@example.com","Send a workflow demo"]

    Mengalihkan email ke atas name mengubah baris pengepala, ungkapan akses JQ dan pratonton serentak. Kunci literal bernama contact.email menggunakan $b.["contact.email"]; e-mel bersarang menggunakan $b.contact.email.

    Tempat menampalkan JQ dalam panduan aliran kerja

    1. Persediaan pemetaan sahaja: sambungkan Universal Webhook → JSON kepada JSON Operations → JSON. Pilih JQ Expression, pastikan medan pertanyaan kekal dipaparkan dan tampalkan ungkapan yang dijana. Sambungkan output JSON kepada Append Rows → Rows. Persediaan ini tiada pengesahan input.
    2. Panduan aliran kerja dengan pengesahan yang telah diuji dalam persekitaran operasi sebenar: nod JSON Operations pertamanya sudah menggunakan (.body) as $b untuk menetapkan nilai $b dan menyemak medan wajib. Gunakan ungkapan akses $b yang dijana untuk menggantikan bahagian values: [[ ... ]] sahaja pada cabang yang berjaya. Kekalkan verified: true, semakan pengesahan, cabang ralat dan Verification Router. Tambahkan pengesahan yang sesuai untuk setiap medan baharu. Jangan gantikan seluruh pertanyaan pengesahan dengan ungkapan pemetaan sahaja ini.
    3. Kekalkan tetapan nod JSON Operations kedua pada cabang Verified sebagai {values: .values}. Nod itu menerima objek yang telah disahkan, bukan kandungan mentah webhook. Panduan aliran kerja ini membina baris pada nod pertama, kemudian mengambil bahagian values melalui {values: .values} pada nod kedua.
    4. Tampalkan pengepala yang dijana pada baris 1 helaian dan padankan julat helaian dengan bilangan lajur anda. Dalam panduan aliran kerja perlindungan pendua, kekalkan pilihan event_id dan padankan pengepala lajur kunci. Uji keseluruhan aliran dalam editor dengan permintaan rekaan sebelum menggunakannya.

    Had dan semakan sebelum digunakan

    • Tiada pengesahan semasa pelaksanaan: jenis yang dipaparkan hanya menerangkan contoh ini. Permintaan seterusnya mungkin tidak menyertakan medan tertentu atau mungkin mengubah jenisnya. Pratonton tidak menjalankan JQ, menghantar webhook atau menulis ke Google Sheets. Uji ungkapan yang dijana dalam editor, termasuk keadaan medan tiada dan jenis berubah.
    • Tatasusunan: hanya indeks [0] diperiksa, termasuk dalam tatasusunan bersarang. Tiada pengulangan, pemetaan satu baris bagi setiap item atau penggabungan elemen seterusnya. Gunakan transformasi JQ berasingan jika anda memerlukannya.
    • Nilai null dan jenis skalar: null kekal sebagai null; nombor dan boolean mengekalkan jenis JSON masing-masing. Tiada penukaran automatik kepada rentetan. Semak cara nod Sheets anda mengendalikannya dalam editor. Kandungan skalar pada aras teratas menggunakan pengepala value.
    • Had pelayar: maksimum 100,000 aksara input, 50 aras bersarang dan 500 medan daun. Nombor di luar julat terhingga pelayar dan integer di luar julat ketepatan selamatnya ditolak; wakilkan pengecam besar sebagai rentetan JSON.
    • Tafsiran helaian: alat ini tidak mengawal pemformatan Google Sheets. Panduan aliran kerja asas menggunakan USER_ENTERED; panduan aliran kerja perlindungan pendua menggunakan RAW supaya teks seperti 001 kekal sebagai nilai literal. Semak mod penulisan untuk data anda.

    Panduan aliran kerja webhook ke Google Sheets · Integrasi Google Sheets · Pengesah JSON

    Baca gambaran keseluruhan produk AI Flowi Workflow sebelum membina dan menguji aliran yang dipetakan.