Cette fonctionnalité est disponible sur le tarif maximum.

Sommaire

  • Comment préparer une feuille Google
  • Comment écrire une requête JSON
  • Comment écrire des lignes dans des colonnes spécifiques
  • Comment écrire des données dans des cellules spécifiques
  • Comment supprimer des données de cellules spécifiques
  • Comment écrire dans la première cellule vide d'une ligne
  • Comment lire des données d'un tableau
  • Comment rechercher du texte dans un tableau (renvoyer la première ligne correspondante)
  • Comment lister toutes les correspondances dans un tableau
  • Comment supprimer complètement une ligne (avec décalage)
  • Comment supprimer complètement une colonne (avec décalage)
  • Comment créer des boutons pour sélectionner une feuille dans un tableau
  • Comment travailler via votre compte
  • Comment travailler avec les lettres de colonnes
  • Comment définir des variables dans les noms de colonnes
  • Comment supprimer des données d'un tableau
  • Comment ajouter une feuille à un tableau
  • Erreurs potentielles
  • Fonctions Google Sheets (API)

Dans cet article, nous allons voir comment les bots peuvent interagir avec Google Sheets.

Pour utiliser cette fonctionnalité, vous avez besoin de :

  • Une feuille Google avec accès en modification activé via le lien
  • Une URL de fonction
  • Des paramètres de requête

Comment écrire une requête JSON

Accédez aux paramètres du bloc à partir duquel vous souhaitez envoyer la requête.

Sélectionnez le type de requête POST JSON, entrez l'URL de la fonction requise et ajoutez les paramètres dans le champ Paramètres JSON POST.

Pour voir la réponse renvoyée par votre requête, entrez {custom_answer} dans le champ Réponse, enregistrez le bloc et exécutez la chaîne.

Vous pouvez ensuite enregistrer des valeurs individuelles de la réponse dans des variables dans le champ Enregistrer la valeur de la réponse JSON en utilisant la syntaxe suivante :

parameters_from_query -> your_variable

Si la réponse contient des paramètres imbriqués, extrayez-les comme suit.

Par exemple, si la réponse est :

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

Utilisez :

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

Examinons maintenant plus en détail ce que les bots peuvent faire avec Google Sheets.

Comment écrire des lignes dans des colonnes spécifiques

Vous pouvez collecter des données d'un utilisateur et les écrire dans la première ligne disponible du tableau. Cela se fait à l'aide de la fonction mapping.

L'en-tête doit être rempli — au moins une cellule de la première ligne doit contenir une valeur.

URL de la fonction :

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

Paramètres de requête :

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

Si vous souhaitez écrire des données dans une feuille autre que la première, ajoutez le paramètre list_name :

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

Où :

  • id — l'identifiant de votre feuille Google. Vous pouvez l'obtenir à partir de l'URL de Google Sheets.
  • a, b, c, d — les noms des colonnes.
  • list_name — le nom de la feuille, par exemple "Sheet 2".

Exemple d'URL Google Sheets :

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

Dans cet exemple, l'identifiant du tableau est :

1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4

Si la requête est exécutée avec succès, la réponse ressemblera à ceci :

{
  "number_row": 8
}

Vous pouvez enregistrer le numéro de ligne renvoyé et l'utiliser plus tard.

Si vous ne souhaitez pas rendre le tableau publiquement modifiable via le lien, vous devez passer le paramètre creds_path avec le chemin vers votre fichier de données d'autorisation.

Pour plus d'informations, consultez la section Travailler via votre compte.

Exemple :

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

Comment écrire des données dans des cellules spécifiques

URL de la fonction :

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

Paramètres de requête :

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

Les données sont écrites dans les cellules spécifiques que vous fournissez — dans cet exemple : A1, B3, C1 et D20.

La numérotation des colonnes commence à 1.

Si vous souhaitez écrire des données dans une feuille autre que la première, ajoutez le paramètre list_name :

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

Si la requête est exécutée avec succès, aucun paramètre n'est renvoyé.

Si vous ne souhaitez pas rendre le tableau publiquement modifiable via le lien, passez le paramètre creds_path avec le chemin vers votre fichier de données d'autorisation.

Pour plus d'informations, consultez la section Travailler via votre compte.

Exemple :

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

Comment supprimer des données de cellules spécifiques

URL de la fonction :

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

Paramètres de requête :

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

Cela supprime les valeurs des cellules spécifiées — dans cet exemple : A1, B3 et C2.

La numérotation des colonnes commence à 1.

Si vous souhaitez supprimer des valeurs de cellules sur une feuille autre que la première, ajoutez le paramètre list_name :

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

Si la requête est exécutée avec succès, aucun paramètre n'est renvoyé.

Si vous ne souhaitez pas rendre le tableau publiquement modifiable via le lien, passez le paramètre creds_path avec le chemin vers votre fichier de données d'autorisation.

Pour plus d'informations, consultez la section Travailler via votre compte.

Exemple :

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

Comment écrire dans la première cellule vide d'une ligne

Vous pouvez écrire des données dans une ligne spécifiée. La valeur sera ajoutée à la première cellule vide à droite de la dernière cellule remplie.

Cela se fait à l'aide de la fonction append_in_row.

URL de la fonction :

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

Paramètres de requête :

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

Si vous souhaitez écrire des données dans une ligne sur une feuille autre que la première, ajoutez le paramètre list_name :

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

Où :

  • id — l'identifiant de votre feuille Google.
  • append_in_row — le numéro de la ligne où la valeur doit être écrite.
  • value — la valeur qui sera écrite dans la cellule.
  • list_name — le nom de la feuille.

Si la requête est exécutée avec succès, la réponse ressemblera à ceci :

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

Vous pouvez enregistrer les valeurs renvoyées et les utiliser plus tard.

Si vous ne souhaitez pas rendre le tableau publiquement modifiable via le lien, passez le paramètre creds_path avec le chemin vers votre fichier de données d'autorisation.

Exemple :

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

Comment lire des données du tableau

URL de la fonction :

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

Paramètres de requête :

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

Utilisez le paramètre read pour spécifier les plages que vous souhaitez récupérer.

Par exemple :

  • "a1": "a1" renvoie une cellule.
  • "c1": "c10" renvoie 10 valeurs de la colonne C.

La réponse contient les adresses des cellules et leurs valeurs.

La numérotation des colonnes commence à 1.

Si vous souhaitez lire des valeurs d'une feuille autre que la première, ajoutez le paramètre list_name :

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

Si la requête est exécutée avec succès, la réponse contiendra les noms des cellules et leurs valeurs.

Exemple :

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

Si vous ne souhaitez pas rendre le tableau publiquement modifiable via le lien, passez le paramètre creds_path avec le chemin vers votre fichier de données d'autorisation.

Pour plus d'informations, consultez la section Travailler via votre compte.

Exemple :

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