wehub-resource-sync
e04ed9c211
CF: Deploy Dev Docs / deploy (push) Has been cancelled
Sync Labels / build (push) Has been cancelled
tests / unit tests (macos-latest) (push) Has been cancelled
tests / unit tests (windows-latest) (push) Has been cancelled
tests / unit tests (ubuntu-latest) (push) Has been cancelled
46 lines
2.4 KiB
Markdown
46 lines
2.4 KiB
Markdown
---
|
|
title: "Gemini Data Analytics Source"
|
|
type: docs
|
|
weight: 1
|
|
linkTitle: "Source"
|
|
description: >
|
|
A "cloud-gemini-data-analytics" source provides a client for the Gemini Data Analytics API.
|
|
no_list: true
|
|
---
|
|
|
|
## About
|
|
|
|
The `cloud-gemini-data-analytics` source provides a client to interact with the [Gemini Data Analytics API](https://docs.cloud.google.com/gemini/docs/conversational-analytics-api/reference/rest). This allows tools to send natural language queries to the API.
|
|
|
|
Authentication can be handled in two ways:
|
|
|
|
1. **Application Default Credentials (ADC) (Recommended):** By default, the source uses ADC to authenticate with the API. The Toolbox server will fetch the credentials from its running environment (server-side authentication). This is the recommended method.
|
|
2. **Client-side OAuth:** If `useClientOAuth` is set to `true`, the source expects the authentication token to be provided by the caller when making a request to the Toolbox server (typically via an HTTP Bearer token). The Toolbox server will then forward this token to the underlying Gemini Data Analytics API calls.
|
|
|
|
## Available Tools
|
|
|
|
{{< list-tools >}}
|
|
|
|
## Example
|
|
|
|
```yaml
|
|
kind: source
|
|
name: my-gda-source
|
|
type: cloud-gemini-data-analytics
|
|
projectId: my-project-id
|
|
---
|
|
kind: source
|
|
name: my-oauth-gda-source
|
|
type: cloud-gemini-data-analytics
|
|
projectId: my-project-id
|
|
useClientOAuth: true
|
|
```
|
|
|
|
## Reference
|
|
|
|
| **field** | **type** | **required** | **description** |
|
|
| -------------- | :------: | :----------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| type | string | true | Must be "cloud-gemini-data-analytics". |
|
|
| projectId | string | true | The Google Cloud Project ID where the API is enabled. |
|
|
| useClientOAuth | boolean | false | If true, the source uses the token provided by the caller (forwarded to the API). Otherwise, it uses server-side Application Default Credentials (ADC). Defaults to `false`. |
|