Diese Funktion ist im maximalen Tarif verfügbar.

Inhalt

  • So bereiten Sie ein Google Sheet vor
  • So schreiben Sie eine JSON-Abfrage
  • So schreiben Sie Zeilen in bestimmte Spalten
  • So schreiben Sie Daten in bestimmte Zellen
  • So löschen Sie Daten aus bestimmten Zellen
  • So schreiben Sie in die erste leere Zelle einer Zeile
  • So lesen Sie Daten aus einer Tabelle
  • So finden Sie Text in einer Tabelle (erste übereinstimmende Zeile zurückgeben)
  • So listen Sie alle Übereinstimmungen in einer Tabelle auf
  • So löschen Sie eine Zeile vollständig (mit Offset)
  • So löschen Sie eine Spalte vollständig (mit Offset)
  • So erstellen Sie Schaltflächen zum Auswählen eines Blatts in einer Tabelle
  • So arbeiten Sie über Ihr Konto
  • So arbeiten Sie mit Spaltenbuchstaben
  • So legen Sie Variablen in Spaltennamen fest
  • So löschen Sie Daten aus einer Tabelle
  • So fügen Sie ein Blatt zu einer Tabelle hinzu
  • Mögliche Fehler
  • Google Sheets-Funktionen (API)

In diesem Artikel schauen wir uns an, wie Bots mit Google Sheets interagieren können.

Um diese Funktionalität zu nutzen, benötigen Sie:

  • Ein Google Sheet mit Bearbeitungszugriff über den Link
  • Eine Funktions-URL
  • Abfrageparameter

So schreiben Sie eine JSON-Abfrage

Gehen Sie zu den Einstellungen des Blocks, von dem aus Sie die Anfrage senden möchten.

Wählen Sie den Anfragetyp POST JSON, geben Sie die URL der erforderlichen Funktion ein und fügen Sie die Parameter zum Feld JSON-POST-Parameter hinzu.

Um die Antwort zu sehen, die Ihre Anfrage zurückgibt, geben Sie {custom_answer} im Feld Antwort ein, speichern Sie den Block und führen Sie die Kette aus.

Sie können dann einzelne Werte aus der Antwort im Feld Wert aus JSON-Antwort speichern mit der folgenden Syntax in Variablen speichern:

parameters_from_query -> your_variable

Wenn die Antwort verschachtelte Parameter enthält, extrahieren Sie diese wie folgt.

Wenn die Antwort beispielsweise lautet:

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

Verwenden Sie:

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

Jetzt schauen wir uns genauer an, was Bots mit Google Sheets tun können.

So schreiben Sie Zeilen in bestimmte Spalten

Sie können Daten von einem Benutzer sammeln und sie in die erste verfügbare Zeile der Tabelle schreiben. Dies erfolgt mit der Funktion mapping.

Die Kopfzeile muss ausgefüllt sein – mindestens eine Zelle in der ersten Zeile muss einen Wert enthalten.

Funktions-URL:

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

Abfrageparameter:

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

Wenn Sie Daten in ein anderes Blatt als das erste schreiben möchten, fügen Sie den Parameter list_name hinzu:

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

Wobei:

  • id – die ID Ihres Google Sheets. Sie können sie aus der Google Sheets-URL abrufen.
  • a, b, c, d – Spaltennamen.
  • list_name – der Name des Blatts, z. B. "Sheet 2".

Beispiel für eine Google Sheets-URL:

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

In diesem Beispiel lautet die Tabellen-ID:

1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4

Wenn die Anfrage erfolgreich abgeschlossen wird, sieht die Antwort wie folgt aus:

{
  "number_row": 8
}

Sie können die zurückgegebene Zeilennummer speichern und später verwenden.

Wenn Sie die Tabelle nicht über den Link öffentlich bearbeitbar machen möchten, müssen Sie den Parameter creds_path mit dem Pfad zu Ihrer Autorisierungsdatei übergeben.

Weitere Informationen finden Sie im Abschnitt Über Ihr Konto arbeiten.

Beispiel:

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

So schreiben Sie Daten in bestimmte Zellen

Funktions-URL:

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

Abfrageparameter:

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

Daten werden in die von Ihnen angegebenen Zellen geschrieben – in diesem Beispiel: A1, B3, C1 und D20.

Die Spaltennummerierung beginnt bei 1.

Wenn Sie Daten in ein anderes Blatt als das erste schreiben möchten, fügen Sie den Parameter list_name hinzu:

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

Wenn die Anfrage erfolgreich abgeschlossen wird, werden keine Parameter zurückgegeben.

Wenn Sie die Tabelle nicht über den Link öffentlich bearbeitbar machen möchten, übergeben Sie den Parameter creds_path mit dem Pfad zu Ihrer Autorisierungsdatei.

Weitere Informationen finden Sie im Abschnitt Über Ihr Konto arbeiten.

Beispiel:

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

So löschen Sie Daten aus bestimmten Zellen

Funktions-URL:

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

Abfrageparameter:

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

Dies entfernt Werte aus den angegebenen Zellen – in diesem Beispiel: A1, B3 und C2.

Die Spaltennummerierung beginnt bei 1.

Wenn Sie Werte aus Zellen auf einem anderen Blatt als dem ersten entfernen möchten, fügen Sie den Parameter list_name hinzu:

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

Wenn die Anfrage erfolgreich abgeschlossen wird, werden keine Parameter zurückgegeben.

Wenn Sie die Tabelle nicht über den Link öffentlich bearbeitbar machen möchten, übergeben Sie den Parameter creds_path mit dem Pfad zu Ihrer Autorisierungsdatei.

Weitere Informationen finden Sie im Abschnitt Über Ihr Konto arbeiten.

Beispiel:

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

So schreiben Sie in die erste leere Zelle einer Zeile

Sie können Daten in eine bestimmte Zeile schreiben. Der Wert wird zur ersten leeren Zelle rechts von der letzten gefüllten Zelle hinzugefügt.

Dies erfolgt mit der Funktion append_in_row.

Funktions-URL:

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

Abfrageparameter:

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

Wenn Sie Daten in eine Zeile auf einem anderen Blatt als dem ersten schreiben möchten, fügen Sie den Parameter list_name hinzu:

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

Wobei:

  • id – die ID Ihres Google Sheets.
  • append_in_row – die Zeilennummer, in die der Wert geschrieben werden soll.
  • value – der Wert, der in die Zelle geschrieben wird.
  • list_name – der Name des Blatts.

Wenn die Anfrage erfolgreich abgeschlossen wird, sieht die Antwort wie folgt aus:

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

Sie können die zurückgegebenen Werte speichern und später verwenden.

Wenn Sie die Tabelle nicht über den Link öffentlich bearbeitbar machen möchten, übergeben Sie den Parameter creds_path mit dem Pfad zu Ihrer Autorisierungsdatei.

Beispiel:

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

So lesen Sie Daten aus der Tabelle

Funktions-URL:

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

Abfrageparameter:

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

Verwenden Sie den Parameter read, um die Bereiche anzugeben, die Sie abrufen möchten.

Zum Beispiel:

  • "a1": "a1" gibt eine Zelle zurück.
  • "c1": "c10" gibt 10 Werte aus Spalte C zurück.

Die Antwort enthält die Zelladressen und ihre Werte.

Die Spaltennummerierung beginnt bei 1.

Wenn Sie Werte aus einem anderen Blatt als dem ersten lesen möchten, fügen Sie den Parameter list_name hinzu:

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

Wenn die Anfrage erfolgreich abgeschlossen wird, enthält die Antwort die Zellnamen und ihre Werte.

Beispiel:

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

Wenn Sie die Tabelle nicht über den Link öffentlich bearbeitbar machen möchten, übergeben Sie den Parameter creds_path mit dem Pfad zu Ihrer Autorisierungsdatei.

Weitere Informationen finden Sie im Abschnitt Über Ihr Konto arbeiten.

Beispiel:

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