Aller au contenu principal

Google Sheets

Ajout de connexion

La connexion se fait de la même manière que pour les autres comptes Google dans Siesta AI (OAuth).

Aperçu​

Ce document décrit les intégrations disponibles avec les services Google :

  • GoogleSearch (Custom Search JSON API)
  • GoogleSheets (opérations sur les tableurs)

Les intégrations sont conçues comme des opérations déterministes, sans état, adaptées à l'automatisation, au reporting et aux pipelines de données.

Nom du service​

GoogleSearch

Opérations​

Description
Effectue une recherche à l'aide de l'API JSON de recherche personnalisée de Google.

Paramètres d'entrée

ParamètreTypeObligatoireDescription
queryStringOuiRequête de recherche transmise à l'API Google.

Comportement

  • Retourne les résultats selon la configuration du moteur de recherche personnalisé (CSE).
  • Respecte les limites et quotas de l'API Google.
  • Ne réalise aucune interprétation ou filtrage des résultats.

Utilisation typique

  • Analyse de marché
  • Surveillance de marques
  • Recherche automatisée
  • Enrichissement de données

2. Intégration Google Sheets​

Nom du service​

GoogleSheets

Description​

L'intégration permet de créer, rechercher et mettre à jour des tableurs Google. Elle est utilisée comme un léger stockage de données ou une cible d'exportation pour des processus automatisés.

2.1 CreateSheetAsync​

Description
Crée un nouveau tableur Google avec des colonnes spécifiées.

Paramètres d'entrée

ParamètreTypeObligatoireDescription
nameStringOuiNom du tableur.
columnNamesStringOuiListe des noms de colonnes séparés par des virgules.

Comportement

  • Si le tableur avec le nom donné n'existe pas, il est créé.
  • Les colonnes sont initialisées dans la première ligne.

Utilisation typique

  • Initialisation de rapports
  • Préparation de la structure de données pour une écriture ultérieure

2.2 GetSheetAsync​

Description
Recherche un tableur Google existant par son nom.

Paramètres d'entrée

ParamètreTypeObligatoireDescription
nameStringOuiNom du tableur.

Comportement

  • Retourne les métadonnées du tableur.
  • Si le tableur n'existe pas, l'opération échoue.

2.3 UpdateSheetAsync​

Description
Remplace le contenu d'un tableur existant par des données au format CSV.

Paramètres d'entrée

ParamètreTypeObligatoireDescription
nameStringOuiNom du tableur.
csvContentStringOuiDonnées CSV à écrire. Si le champ contient une virgule, il doit être entre guillemets.

Comportement

  • Remplace complètement le contenu existant.
  • Ne réalise pas de validation de type de données.
  • La responsabilité du format CSV correct incombe à l'appelant.

Utilisation typique

  • Exportation de données
  • Synchronisation de rapports
  • Réécriture automatique des sorties de pipeline

Remarques de sécurité​

  • L'intégration fonctionne exclusivement via l'API Google officielle.
  • Aucun identifiant de connexion direct n'est exposé.
  • Les droits d'accès sont gérés au niveau du compte Google ou du compte de service.

Décisions de conception​

  • Opérations sans état sans cache ni état partagé.
  • Noms explicites : le tableur est identifié par son nom, pas par son ID.
  • Approche fail-fast : des données incohérentes entraînent une erreur.

Résumé​

  • GoogleSearch fournit une recherche déterministe via l'API JSON de recherche personnalisée de Google.
  • GoogleSheets couvre la création, la recherche et la mise à jour des tableurs.
  • Le format des données et les autorisations sont entièrement sous la responsabilité du système appelant.