이 페이지에서는 Google Cloud 프로젝트에 대화형 분석 API(geminidataanalytics.googleapis.com을 통해 액세스)를 사용 설정하는 단계를 설명합니다. 대화형 분석 API는 Google Cloud 콘솔의 Gemini 기반 Data Analytics API에 속하는 첫 번째 기능입니다.
시작하기 전에
대화형 분석 API를 사용하려면 다음 기본 요건을 충족하고 Google Cloud 프로젝트에 필요한 Identity and Access Management(IAM) 역할이 있어야 합니다.
기본 요건
- 대화형 분석 API와 함께 사용할 데이터를 식별합니다. BigQuery 테이블, Looker Explore, Looker Studio 보고서와 같은 데이터 소스를 사용할 수 있습니다.
Google Cloud 콘솔의 프로젝트 선택기 페이지에서 Conversational Analytics API와 함께 사용하려는 데이터에 액세스할 수 있는 Google Cloud 프로젝트를 만듭니다.
필요한 역할
Conversational Analytics API로 사용할 Google Cloud 프로젝트에 다음 IAM 역할이 있는지 확인합니다.
- Google Cloud (
roles/cloudaicompanion.user)용 Gemini - BigQuery 사용자(
roles/bigquery.user) - BigQuery Studio 사용자(
roles/bigquery.studioUser)(BigQuery Studio 및 데이터 캔버스를 사용하는 경우)
필요한 API 사용 설정
대화형 분석 API를 사용하려면 Google Cloud 프로젝트에서 필요한 API를 사용 설정해야 합니다. API를 사용 설정하면 페이지를 새로고침하여 API가 사용 설정되었는지 확인해야 할 수 있습니다.
Gemini 데이터 분석 API 사용 설정
대화형 분석 API를 사용하려면 Google Cloud 콘솔이나 Google Cloud CLI를 사용하여 Gemini 데이터 분석 API를 사용 설정합니다.
콘솔
Google Cloud 콘솔에서 Gemini 데이터 분석 API를 사용 설정합니다.
gcloud
Google Cloud CLI로 Gemini 데이터 분석 API를 사용 설정하려면 다음과 같이 gcloud services enable 명령어를 실행합니다.
gcloud services enable geminidataanalytics.googleapis.com --project=project_id
이전 예시에서 project_id를 Google Cloud 프로젝트 ID로 바꿉니다.
추가 필수 API 사용 설정
또한 대화형 분석 API를 사용하려면 대화형 분석 API로 사용할 Google Cloud 프로젝트에서 다음 API를 사용 설정해야 합니다.
Colab Enterprise용 API 사용 설정
Colab Enterprise 환경에서 대화형 분석 API를 사용하려면 다음 API를 사용 설정합니다.
VPC 서비스 제어 추가 구성
조직 또는 사용 중인 Google Cloud 프로젝트에 VPC 서비스 제어가 사용 설정된 경우 Conversational Analytics API에서 사용하는 다음 API를 허용 목록에 추가합니다.
geminidataanalytics.googleapis.com에서 다음 API를 허용합니다.projects.locations.chat
aiplatform.googleapis.com에서 다음 API를 허용합니다.datacatalog.googleapis.com에서 다음 API를 허용합니다.bigquery.googleapis.com에서 다음 API를 허용합니다.