Jadual Google

Ciri ini tersedia pada tarif maksimum.

Kandungan

Cara menyediakan Helaian Google
Cara menulis pertanyaan JSON
Cara menulis baris ke lajur tertentu
Cara menulis data ke sel tertentu
Cara memadam data dari sel tertentu
Cara menulis ke sel kosong pertama dalam baris
Cara membaca data dari jadual
Cara mencari teks dalam jadual (kembalikan baris padanan pertama)
Cara menyenaraikan semua padanan dalam jadual
Cara memadam sepenuhnya baris (dengan offset)
Cara memadam sepenuhnya lajur (dengan offset)
Cara membuat butang untuk memilih helaian dalam jadual
Cara bekerja melalui akaun anda
Cara bekerja dengan huruf lajur
Cara menetapkan pemboleh ubah dalam nama lajur
Cara memadam data dari jadual
Cara menambah helaian ke jadual
Ralat yang berpotensi
Fungsi Helaian Google (API)

Dalam artikel ini, kita akan melihat bagaimana bot boleh berinteraksi dengan Helaian Google.

Untuk menggunakan fungsi ini, anda perlu:

Helaian Google dengan akses penyuntingan didayakan melalui pautan
URL fungsi
Parameter pertanyaan

Cara menulis pertanyaan JSON

Pergi ke tetapan blok dari mana anda ingin menghantar permintaan.

Pilih jenis permintaan POST JSON, masukkan URL fungsi yang diperlukan, dan tambahkan parameter ke medan Parameter POST JSON.

Untuk melihat respons yang dikembalikan oleh permintaan anda, masukkan {custom_answer} dalam medan Jawapan, simpan blok, dan jalankan melalui rantai.

Anda kemudian boleh menyimpan nilai individu dari respons ke pemboleh ubah dalam medan Simpan Nilai dari Respons JSON menggunakan sintaks berikut:

parameters_from_query -> your_variable

Jika respons mengandungi parameter bersarang, ekstrak seperti berikut.

Contohnya, jika respons adalah:

{
  "cell_number": {
    "row": 4,
    "col": 2
  }
}

Gunakan:

cell_number|row -> Row
cell_number|col -> Column

Sekarang mari kita lihat dengan lebih terperinci apa yang boleh dilakukan oleh bot dengan Helaian Google.

Cara menulis baris ke lajur tertentu

Anda boleh mengumpul data dari pengguna dan menulisnya ke baris pertama yang tersedia dalam jadual. Ini dilakukan menggunakan fungsi mapping.

Pengepala mesti diisi — sekurang-kurangnya satu sel dalam baris pertama mesti mengandungi nilai.

URL fungsi:

https://store.mavibot.ai/function/gsheets

Parameter pertanyaan:

{
  "id": "table id",
  "mapping": {
    "a": "#{variable}",
    "b": "#{yet}",
    "c": "#{yet}",
    "d": "just text"
  }
}

Jika anda ingin menulis data ke helaian selain daripada yang pertama, tambahkan parameter list_name:

{
  "id": "table id",
  "mapping": {
    "a": "just text",
    "b": "#{variable}"
  },
  "list_name": "Sheet name"
}

Di mana:

id — ID Helaian Google anda. Anda boleh mendapatkannya dari URL Helaian Google.
a, b, c, d — nama lajur.
list_name — nama helaian, contohnya "Sheet 2".

Contoh URL Helaian Google:

https://docs.google.com/spreadsheets/d/1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4/edit#gid=0

Dalam contoh ini, ID jadual adalah:

1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4

Jika permintaan berjaya diselesaikan, respons akan kelihatan seperti ini:

{
  "number_row": 8
}

Anda boleh menyimpan nombor baris yang dikembalikan dan menggunakannya kemudian.

Jika anda tidak mahu menjadikan jadual boleh diedit secara awam melalui pautan, anda perlu lulus parameter creds_path dengan laluan ke fail data kebenaran anda.

Untuk maklumat lanjut, lihat bahagian Bekerja melalui akaun anda.

Contoh:

{
  "id": "table id",
  "mapping": {
    "a": "#{variable}",
    "b": "#{yet}",
    "c": "#{yet}",
    "d": "just text"
  },
  "creds_path": "path to your authorization data file"
}

Cara menulis data ke sel tertentu

URL fungsi:

https://store.mavibot.ai/function/gsheets

Parameter pertanyaan:

{
  "id": "table id",
  "write": {
    "a1": "#{variable}",
    "b3": "#{yet}",
    "c1": "#{yet}",
    "d20": "just text"
  }
}

Data ditulis ke sel tertentu yang anda berikan — dalam contoh ini: A1, B3, C1, dan D20.

Penomboran lajur bermula dari 1.

Jika anda ingin menulis data ke helaian selain daripada yang pertama, tambahkan parameter list_name:

{
  "id": "table id",
  "write": {
    "a1": "#{variable}",
    "b3": "#{yet}",
    "c1": "#{yet}",
    "d20": "just text"
  },
  "list_name": "Sheet name"
}

Jika permintaan berjaya diselesaikan, tiada parameter dikembalikan.

Jika anda tidak mahu menjadikan jadual boleh diedit secara awam melalui pautan, lulus parameter creds_path dengan laluan ke fail data kebenaran anda.

Untuk maklumat lanjut, lihat bahagian Bekerja melalui akaun anda.

Contoh:

{
  "id": "table id",
  "write": {
    "a1": "#{variable}",
    "b3": "#{yet}",
    "c1": "#{more}",
    "d20": "just text"
  },
  "list_name": "Sheet name",
  "creds_path": "path to your authorization data file"
}

Cara memadam data dari sel tertentu

URL fungsi:

https://store.mavibot.ai/function/gsheets

Parameter pertanyaan:

{
  "id": "table id",
  "remove": [
    "a1",
    "b3",
    "c2"
  ]
}

Ini memadam nilai dari sel yang ditentukan — dalam contoh ini: A1, B3, dan C2.

Penomboran lajur bermula dari 1.

Jika anda ingin memadam nilai dari sel pada helaian selain daripada yang pertama, tambahkan parameter list_name:

{
  "id": "table id",
  "remove": [
    "a1",
    "b3",
    "c2"
  ],
  "list_name": "Sheet name"
}

Jika permintaan berjaya diselesaikan, tiada parameter dikembalikan.

Jika anda tidak mahu menjadikan jadual boleh diedit secara awam melalui pautan, lulus parameter creds_path dengan laluan ke fail data kebenaran anda.

Untuk maklumat lanjut, lihat bahagian Bekerja melalui akaun anda.

Contoh:

{
  "id": "table id",
  "remove": [
    "a1",
    "b3",
    "c2"
  ],
  "list_name": "Sheet name",
  "creds_path": "path to your authorization data file"
}

Cara menulis ke sel kosong pertama dalam baris

Anda boleh menulis data ke baris yang ditentukan. Nilai akan ditambah ke sel kosong pertama di sebelah kanan sel terakhir yang diisi.

Ini dilakukan menggunakan fungsi append_in_row.

URL fungsi:

https://store.mavibot.ai/function/gsheets

Parameter pertanyaan:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value"
}

Jika anda ingin menulis data ke baris pada helaian selain daripada yang pertama, tambahkan parameter list_name:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value",
  "list_name": "Sheet name"
}

Di mana:

id — ID Helaian Google anda.
append_in_row — nombor baris di mana nilai harus ditulis.
value — nilai yang akan ditulis ke sel.
list_name — nama helaian.

Jika permintaan berjaya diselesaikan, respons akan kelihatan seperti ini:

{
  "number_col": 10,
  "col_name": "J3"
}

Anda boleh menyimpan nilai yang dikembalikan dan menggunakannya kemudian.

Jika anda tidak mahu menjadikan jadual boleh diedit secara awam melalui pautan, lulus parameter creds_path dengan laluan ke fail data kebenaran anda.

Contoh:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value",
  "creds_path": "path to your authorization data file"
}

Cara membaca data dari jadual

URL fungsi:

https://store.mavibot.ai/function/gsheets

Parameter pertanyaan:

{
  "id": "table id",
  "read": {
    "a1": "a1",
    "b3": "b4",
    "c1": "c10",
    "d20": "a1"
  }
}

Gunakan parameter read untuk menentukan julat yang ingin anda ambil.

Contohnya:

"a1": "a1" mengembalikan satu sel.
"c1": "c10" mengembalikan 10 nilai dari lajur C.

Respons mengandungi alamat sel dan nilainya.

Penomboran lajur bermula dari 1.

Jika anda ingin membaca nilai dari helaian selain daripada yang pertama, tambahkan parameter list_name:

{
  "id": "table id",
  "read": {
    "a1": "a3",
    "b3": "b6"
  },
  "list_name": "Sheet name"
}

Jika permintaan berjaya diselesaikan, respons akan mengandungi nama sel dan nilainya.

Contoh:

{
  "A1": "value 1",
  "A2": "value 2",
  "A3": "value 3"
}

Jika anda tidak mahu menjadikan jadual boleh diedit secara awam melalui pautan, lulus parameter creds_path dengan laluan ke fail data kebenaran anda.

Untuk maklumat lanjut, lihat bahagian Bekerja melalui akaun anda.

Contoh:

{
  "id": "table id",
  "read": {
    "a1": "a3",
    "b3": "b6"
  },
  "list_name": "Sheet name",
  "creds_path": "path to your authorization data file"
}