本页面介绍了为您的 Google Cloud 项目启用 Conversational Analytics API(通过 geminidataanalytics.googleapis.com
访问)的步骤。Conversational Analytics API 是 Google Cloud 控制台中的 Data Analytics API with Gemini 下的第一个功能。
准备工作
您必须先拥有一个 Google Cloud 可以访问您要使用的数据的项目,然后才能使用 Conversational Analytics API。如需设置项目,请完成以下步骤:
- 确定要与 Conversational Analytics API 搭配使用的数据。您可以使用 BigQuery 表、Looker 探索和 Looker Studio 报告等数据源。
在 Google Cloud 控制台的项目选择器页面上,创建一个 Google Cloud 项目,使该项目可以访问您想与 Conversational Analytics API 搭配使用的数据。
启用所需的 API
如需使用 Conversational Analytics API,您必须在 Google Cloud 项目中启用一组必需的 API。如果您计划从 Colab Enterprise 环境中使用 Conversational Analytics API,还必须启用其他 API。
必需的 API
控制台
在 Google Cloud 控制台中,为要与 Conversational Analytics API 搭配使用的 Google Cloud 项目启用以下 API。
gcloud
使用 Google Cloud CLI 运行以下 gcloud services enable
命令,以分别启用 Gemini Data Analytics API、Gemini for Google Cloud API 和 BigQuery API:
gcloud services enable geminidataanalytics.googleapis.com --project=project_id gcloud services enable cloudaicompanion.googleapis.com --project=project_id gcloud services enable bigquery.googleapis.com --project=project_id
在上面的示例 gcloud CLI 命令中,将 project_id
替换为您的 Google Cloud 项目 ID。
Colab Enterprise 的 API
如果您计划从 Colab Enterprise 环境中使用 Conversational Analytics API,还需要启用以下 API:
授予必需的角色
如需使用 Conversational Analytics API,请在 Google Cloud 控制台中向需要与该 API 互动的主账号(例如用户或服务账号)授予以下 Identity and Access Management (IAM) 角色:
- Gemini for Google Cloud User (
roles/cloudaicompanion.user
):创建由 Google Cloud管理的对话时需要此角色。 - Looker Instance User (
roles/looker.instanceUser
):访问 Looker (Google Cloud Core) 实例中的数据时需要此角色 - BigQuery User (
roles/bigquery.user
):访问 BigQuery 中的数据时需要此角色 - BigQuery Studio User (
roles/bigquery.studioUser
):如果您使用 BigQuery Studio 和数据画布,则必须拥有此角色
此外,管理代理等操作的权限由 Gemini Data Analytics 角色控制,如授予 Conversational Analytics API IAM 角色和权限中所述。
适用于 VPC Service Controls 的其他配置
如果您的组织或您使用的 Google Cloud 项目启用了 VPC Service Controls,请将以下由 Conversational Analytics API 使用的 API 添加到许可清单:
- 在
geminidataanalytics.googleapis.com
中,允许使用以下 API:projects.locations.chat
- 在
aiplatform.googleapis.com
中,允许使用以下 API: - 在
datacatalog.googleapis.com
中,允许使用以下 API: - 在
bigquery.googleapis.com
中,允许使用以下 API: