Ativar a API Conversational Analytics

Pré-lançamento particular

Este produto ou recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis no estado em que se encontram e podem ter suporte limitado. Você encontra mais detalhes nas descrições das fases de lançamento.

Nesta página, descrevemos as etapas para ativar a API Conversational Analytics (acessada por geminidataanalytics.googleapis.com) no projeto Google Cloud . A API Conversational Analytics é o primeiro recurso da API Data Analytics com Gemini no console Google Cloud .

Observação: para usar a API Conversational Analytics, você precisa fazer parte do pré-lançamento privado. Para manifestar interesse, preencha o formulário de interesse no pré-lançamento.

Antes de começar

Para trabalhar com a API Conversational Analytics, você precisa atender aos seguintes pré-requisitos e ter os papéis necessários do Identity and Access Management (IAM) no projeto Google Cloud .

Pré-requisitos

1. Identifique os dados que quer usar com a API Conversational Analytics. É possível usar fontes de dados como tabelas do BigQuery, análises detalhadas do Looker e relatórios do Looker Studio.

2. No console do Google Cloud, na página do seletor de projetos, crie um Google Cloud projeto que possa acessar os dados que você quer usar com a API Conversational Analytics.

   Observação: no momento, não há faturamento para a API Conversational Analytics.

   Acessar o seletor de projetos

Papéis necessários

Verifique se você tem os seguintes papéis do IAM no projeto Google Cloud que vai usar com a API Conversational Analytics:

Acessar "Papéis"

• Gemini para Google Cloud (roles/cloudaicompanion.user)
• Usuário do BigQuery (roles/bigquery.user)
• Usuário do BigQuery Studio (roles/bigquery.studioUser) (se você estiver usando o BigQuery Studio e o painel de dados)

Ative as APIs necessárias

Para usar a API Conversational Analytics, ative as APIs necessárias no projeto Google Cloud . Ao ativar uma API, pode ser necessário atualizar a página para confirmar que ela foi ativada.

Observação: se você não tiver permissão para ativar as APIs, peça para o administrador do projeto fazer isso no painel "APIs e serviços". Como alternativa, o administrador do projeto pode conceder a você o papel Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin) no console Google Cloud , o que permite ativar e desativar APIs para o projeto atual.

Ativar a API Gemini Data Analytics

Para usar a API Conversational Analytics, ative a API Gemini Data Analytics usando o console Google Cloud ou a CLI do Google Cloud.

console

Ative a API Gemini Data Analytics no console Google Cloud .

• Ativar a API Gemini Data Analytics

gcloud

Para ativar a API Gemini Data Analytics com a CLI do Google Cloud, execute o comando gcloud services enable da seguinte maneira:

gcloud services enable geminidataanalytics.googleapis.com --project=project_id

No exemplo anterior, substitua project_id pelo ID do projeto Google Cloud .

Ativar outras APIs necessárias

Além disso, para usar a API Conversational Analytics, ative as seguintes APIs no projeto Google Cloud que você vai usar com a API Conversational Analytics:

• Ativar a API Cloudaicompanion

• Ativar a API BigQuery

Ativar APIs para o Colab Enterprise

Se você pretende usar a API Conversational Analytics em um ambiente do Colab Enterprise, ative as seguintes APIs:

• Ativar a API Dataform

• Ativar a API Compute Engine

• Ativar a API Vertex AI

Configuração adicional para o VPC Service Controls

Se o VPC Service Controls estiver ativado na organização ou no projeto Google Cloud que você está usando, adicione as seguintes APIs, usadas pela API Conversational Analytics, à lista de permissões:

• Em geminidataanalytics.googleapis.com, permita a seguinte API:
  • projects.locations.chat
• Em aiplatform.googleapis.com, permita a seguinte API:
  • projects.locations.endpoints.generateContent
• Em datacatalog.googleapis.com, permita as seguintes APIs:
  • entries.lookup
  • catalog.search
• Em bigquery.googleapis.com, permita as seguintes APIs:
  • jobs.query
  • jobs.insert
  • jobs.getQueryResults