Mengaktifkan Conversational Analytics API

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan langkah-langkah untuk mengaktifkan Conversational Analytics API (diakses melalui geminidataanalytics.googleapis.com) untuk project Google Cloud Anda. Conversational Analytics API adalah kemampuan pertama dalam Data Analytics API with Gemini di konsol Google Cloud .

Sebelum memulai

Sebelum dapat menggunakan Conversational Analytics API, Anda harus memiliki Google Cloud project yang dapat mengakses data yang ingin Anda gunakan. Untuk menyiapkan project, selesaikan langkah-langkah berikut:

1. Identifikasi data yang ingin Anda gunakan dengan Conversational Analytics API. Anda dapat menggunakan sumber data seperti tabel BigQuery, Eksplorasi Looker, dan laporan Looker Studio.

2. Di konsol Google Cloud, pada halaman pemilih project, buat Google Cloud project yang dapat mengakses data yang ingin Anda gunakan dengan Conversational Analytics API.

   Catatan: Saat ini tidak ada penagihan untuk Conversational Analytics API.

   Buka pemilih project

Mengaktifkan API yang diperlukan

Untuk menggunakan Conversational Analytics API, Anda harus mengaktifkan serangkaian API yang diperlukan di project Google Cloud Anda. Jika Anda berencana menggunakan Conversational Analytics API dari lingkungan Colab Enterprise, Anda juga harus mengaktifkan API tambahan.

API yang diperlukan

Catatan: Jika Anda tidak memiliki izin untuk mengaktifkan API, minta administrator project Anda untuk mengaktifkan API untuk Anda dari dasbor API & Layanan. Atau, administrator project Anda dapat memberi Anda peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin) di konsol Google Cloud , yang memungkinkan Anda mengaktifkan dan menonaktifkan API untuk project saat ini.

console

Aktifkan API berikut di konsol Google Cloud untuk project Google Cloud yang akan Anda gunakan dengan Conversational Analytics API.

Mengaktifkan Gemini Data Analytics API

Mengaktifkan Gemini untuk Google Cloud API

Aktifkan BigQuery API

Tips: Saat mengaktifkan API, Anda mungkin perlu memuat ulang halaman konsol Google Cloud untuk mengonfirmasi bahwa API telah diaktifkan.

gcloud

Dengan Google Cloud CLI, jalankan perintah gcloud services enable berikut untuk mengaktifkan Gemini Data Analytics API, Gemini for Google Cloud API, dan 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

Pada perintah gcloud CLI contoh sebelumnya, ganti project_id dengan ID project Google Cloud Anda.

API untuk Colab Enterprise

Jika Anda berencana menggunakan Conversational Analytics API dari lingkungan Colab Enterprise, aktifkan juga API berikut:

Mengaktifkan Dataform API

Mengaktifkan Compute Engine API

Mengaktifkan Vertex AI API

Tips: Saat mengaktifkan API, Anda mungkin perlu memuat ulang halaman konsol Google Cloud untuk mengonfirmasi bahwa API telah diaktifkan.

Memberikan peran yang diperlukan

Untuk menggunakan Conversational Analytics API, berikan peran Identity and Access Management (IAM) berikut di konsol Google Cloud kepada akun utama (seperti pengguna atau akun layanan) yang perlu berinteraksi dengan API:

Buka Peran

• Gemini untuk Google Cloud Pengguna (roles/cloudaicompanion.user): diperlukan untuk membuat percakapan yang dikelola oleh Google Cloud.
• Pengguna Instance Looker (roles/looker.instanceUser): diperlukan untuk mengakses data dari instance Looker (Google Cloud core)
• Pengguna BigQuery (roles/bigquery.user): diperlukan untuk mengakses data di BigQuery
• Pengguna BigQuery Studio (roles/bigquery.studioUser): diperlukan jika Anda menggunakan BigQuery Studio dan kanvas data

Selain itu, izin untuk tindakan seperti mengelola agen dikontrol oleh peran Gemini Data Analytics, seperti yang dijelaskan dalam Memberikan peran dan izin IAM Conversational Analytics API.

Konfigurasi tambahan untuk Kontrol Layanan VPC

Jika Kontrol Layanan VPC diaktifkan untuk organisasi Anda atau untuk Google Cloud project yang Anda gunakan, tambahkan API berikut, yang digunakan oleh Conversational Analytics API, ke daftar yang diizinkan:

• Dari geminidataanalytics.googleapis.com, izinkan API berikut:
  • projects.locations.chat
• Dari aiplatform.googleapis.com, izinkan API berikut:
  • projects.locations.endpoints.generateContent
• Dari datacatalog.googleapis.com, izinkan API berikut:
  • entries.lookup
  • catalog.search
• Dari bigquery.googleapis.com, izinkan API berikut:
  • jobs.query
  • jobs.insert
  • jobs.getQueryResults