api-geminidataanalytics

name	api-geminidataanalytics
description	Expert guidance, tools, and clients for the Google Cloud Gemini Data Analytics API (GA v1, with v1beta and v1alpha support). Use to perform conversational data analysis, translate natural language into executable SQL, manage multi-turn conversation states, and configure Data Agents with BigQuery data sources.

Google Gemini Data Analytics API (geminidataanalytics)

Overview

The Gemini Data Analytics API enables developers to build intelligent, conversational data analysis applications. It leverages Google's foundation AI models to translate natural language questions into structured queries (such as BigQuery SQL or Looker Explore parameters), execute them on connected data warehouses, and return structured insights, summaries, and visualizations.

This skill provides procedural guidelines, production REST clients (GA v1, v1beta, and v1alpha), request payload construction helpers, and multi-tiered evaluation suites for the Gemini Data Analytics API.

---

1. Architectural Workflow Diagram

graph TD
    User([User Prompt / Question]) --> Client[Client Application / CLI]
    subgraph Payload Construction ["Payload Construction (geminidataanalytics_helpers.sh)"]
        Client --> UMsg["create_user_message_json()"]
        UMsg --> Msg["create_message_with_user_message_json()"]
        Client --> BQ["create_bigquery_table_reference_json()"]
        Msg --> ChatReq["create_chat_request_json()"]
        BQ --> QueryReq["create_query_data_request_json()"]
        Client --> AgentReq["create_data_agent_json()"]
    end
    subgraph REST Execution ["REST API Execution"]
        Client --> CoreGA["geminidataanalytics_v1.sh (GA v1)"]
        Client --> CoreBeta["geminidataanalytics_v1beta.sh (Beta)"]
        Client --> CoreAlpha["geminidataanalytics_v1alpha.sh (Alpha)"]
        CoreGA --> Common["api-common.sh (Auth & Quota Headers)"]
        CoreBeta --> Common
        CoreAlpha --> Common
        ChatReq -.-> CoreGA
        QueryReq -.-> CoreBeta
        AgentReq -.-> CoreGA
        Common --> API["Gemini Data Analytics REST API<br/>https://geminidataanalytics.googleapis.com"]
    end
    API --> Output["SQL Query / Analysis / System Responses"]
    Output --> User