Bu özellik maksimum tarifede kullanılabilir.

İçindekiler

  • Google Sheet nasıl hazırlanır
  • JSON sorgusu nasıl yazılır
  • Belirli sütunlara satırlar nasıl yazılır
  • Belirli hücrelere veri nasıl yazılır
  • Belirli hücrelerden veri nasıl silinir
  • Bir satırdaki ilk boş hücreye nasıl yazılır
  • Tablodan veri nasıl okunur
  • Tabloda metin nasıl bulunur (ilk eşleşen satırı döndürür)
  • Tablodaki tüm eşleşmeler nasıl listelenir
  • Bir satır tamamen nasıl silinir (ofset ile)
  • Bir sütun tamamen nasıl silinir (ofset ile)
  • Tabloda sayfa seçmek için düğmeler nasıl oluşturulur
  • Hesabınız üzerinden nasıl çalışılır
  • Sütun harfleriyle nasıl çalışılır
  • Sütun adlarında değişkenler nasıl ayarlanır
  • Tablodan veri nasıl silinir
  • Tabloya sayfa nasıl eklenir
  • Olası hatalar
  • Google Sheets işlevleri (API)

Bu makalede, botların Google Sheets ile nasıl etkileşim kurabileceğine bakacağız.

Bu işlevselliği kullanmak için ihtiyacınız olanlar:

  • Bağlantı üzerinden düzenleme erişimi etkinleştirilmiş bir Google Sheet
  • Bir işlev URL'si
  • Sorgu parametreleri

JSON sorgusu nasıl yazılır

İsteği göndermek istediğiniz bloğun ayarlarına gidin.

POST JSON istek türünü seçin, gerekli işlevin URL'sini girin ve JSON POST parametreleri alanına parametreleri ekleyin.

İsteğinizin döndürdüğü yanıtı görmek için Yanıt alanına {custom_answer} girin, bloğu kaydedin ve zinciri çalıştırın.

Daha sonra yanıttaki tek tek değerleri JSON Yanıtından Değer Kaydet alanına aşağıdaki sözdizimini kullanarak değişkenlere kaydedebilirsiniz:

parameters_from_query -> your_variable

Yanıt iç içe parametreler içeriyorsa, bunları aşağıdaki gibi çıkarın.

Örneğin, yanıt şu şekildeyse:

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

Şunu kullanın:

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

Şimdi botların Google Sheets ile neler yapabileceğine daha ayrıntılı bakalım.

Belirli sütunlara satırlar nasıl yazılır

Kullanıcıdan veri toplayabilir ve tablodaki ilk uygun satıra yazabilirsiniz. Bu, mapping işlevi kullanılarak yapılır.

Başlık doldurulmalıdır — ilk satırdaki en az bir hücre bir değer içermelidir.

İşlev URL'si:

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

Sorgu parametreleri:

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

İlk sayfadan farklı bir sayfaya veri yazmak istiyorsanız, list_name parametresini ekleyin:

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

Burada:

  • id — Google Sheet'inizin kimliği. Google Sheets URL'sinden alabilirsiniz.
  • a, b, c, d — sütun adları.
  • list_name — sayfanın adı, örneğin "Sheet 2".

Örnek Google Sheets URL'si:

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

Bu örnekte, tablo kimliği:

1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4

İstek başarıyla tamamlanırsa, yanıt şu şekilde görünecektir:

{
  "number_row": 8
}

Döndürülen satır numarasını kaydedebilir ve daha sonra kullanabilirsiniz.

Tabloyu bağlantı üzerinden herkese açık düzenlenebilir yapmak istemiyorsanız, yetkilendirme veri dosyanızın yolunu içeren creds_path parametresini iletmeniz gerekir.

Daha fazla bilgi için Hesabınız üzerinden çalışma bölümüne bakın.

Örnek:

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

Belirli hücrelere veri nasıl yazılır

İşlev URL'si:

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

Sorgu parametreleri:

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

Veriler, sağladığınız belirli hücrelere yazılır — bu örnekte: A1, B3, C1 ve D20.

Sütun numaralandırması 1'den başlar.

İlk sayfadan farklı bir sayfaya veri yazmak istiyorsanız, list_name parametresini ekleyin:

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

İstek başarıyla tamamlanırsa, hiçbir parametre döndürülmez.

Tabloyu bağlantı üzerinden herkese açık düzenlenebilir yapmak istemiyorsanız, yetkilendirme veri dosyanızın yolunu içeren creds_path parametresini iletin.

Daha fazla bilgi için Hesabınız üzerinden çalışma bölümüne bakın.

Örnek:

{
  "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"
}

Belirli hücrelerden veri nasıl silinir

İşlev URL'si:

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

Sorgu parametreleri:

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

Bu, belirtilen hücrelerdeki değerleri kaldırır — bu örnekte: A1, B3 ve C2.

Sütun numaralandırması 1'den başlar.

İlk sayfadan farklı bir sayfadaki hücrelerden değerleri kaldırmak istiyorsanız, list_name parametresini ekleyin:

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

İstek başarıyla tamamlanırsa, hiçbir parametre döndürülmez.

Tabloyu bağlantı üzerinden herkese açık düzenlenebilir yapmak istemiyorsanız, yetkilendirme veri dosyanızın yolunu içeren creds_path parametresini iletin.

Daha fazla bilgi için Hesabınız üzerinden çalışma bölümüne bakın.

Örnek:

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

Bir satırdaki ilk boş hücreye nasıl yazılır

Belirli bir satıra veri yazabilirsiniz. Değer, son dolu hücrenin sağındaki ilk boş hücreye eklenir.

Bu, append_in_row işlevi kullanılarak yapılır.

İşlev URL'si:

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

Sorgu parametreleri:

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

İlk sayfadan farklı bir sayfadaki bir satıra veri yazmak istiyorsanız, list_name parametresini ekleyin:

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

Burada:

  • id — Google Sheet'inizin kimliği.
  • append_in_row — değerin yazılacağı satır numarası.
  • value — hücreye yazılacak değer.
  • list_name — sayfanın adı.

İstek başarıyla tamamlanırsa, yanıt şu şekilde görünecektir:

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

Döndürülen değerleri kaydedebilir ve daha sonra kullanabilirsiniz.

Tabloyu bağlantı üzerinden herkese açık düzenlenebilir yapmak istemiyorsanız, yetkilendirme veri dosyanızın yolunu içeren creds_path parametresini iletin.

Örnek:

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

Tablodan veri nasıl okunur

İşlev URL'si:

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

Sorgu parametreleri:

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

Almak istediğiniz aralıkları belirtmek için read parametresini kullanın.

Örneğin:

  • "a1": "a1" bir hücre döndürür.
  • "c1": "c10" C sütunundan 10 değer döndürür.

Yanıt, hücre adreslerini ve değerlerini içerir.

Sütun numaralandırması 1'den başlar.

İlk sayfadan farklı bir sayfadan değerleri okumak istiyorsanız, list_name parametresini ekleyin:

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

İstek başarıyla tamamlanırsa, yanıt hücre adlarını ve değerlerini içerecektir.

Örnek:

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

Tabloyu bağlantı üzerinden herkese açık düzenlenebilir yapmak istemiyorsanız, yetkilendirme veri dosyanızın yolunu içeren creds_path parametresini iletin.

Daha fazla bilgi için Hesabınız üzerinden çalışma bölümüne bakın.

Örnek:

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