Data Analytics API with Gemini (geminidataanalytics.googleapis.com) menyediakan metode untuk mengkueri dan menganalisis data menggunakan bahasa alami, serta untuk membuat dan mengelola agen data yang berinteraksi dengan data Anda di sumber data yang didukung.
Pilih jalur endpoint yang sesuai dengan persyaratan stabilitas Anda:
- v1: Direkomendasikan untuk fitur ketersediaan umum yang dapat diintegrasikan ke dalam lingkungan produksi.
- v1beta: Direkomendasikan untuk mengintegrasikan fitur baru ke lingkungan produksi selama periode Pratinjau.
- v1alpha: Ditujukan untuk menguji fitur baru dan yang akan datang. Fitur ini dapat berubah atau dihapus, sehingga berpotensi memerlukan update pada kode Anda.
Pelajari lebih lanjut tahapan peluncuran produk Google Cloud.
Untuk panduan penerapan yang mendetail, lihat Ringkasan Analisis Percakapan API.
- Resource REST: v1beta.a2a.projects.locations.dataAgents.v1
- Resource REST: v1beta.a2a.projects.locations.dataAgents.v1.message
- Resource REST: v1beta.projects.locations
- Resource REST: v1beta.projects.locations.conversations
- Resource REST: v1beta.projects.locations.conversations.messages
- Resource REST: v1beta.projects.locations.dataAgents
- Resource REST: v1beta.projects.locations.observabilitySettings
- Resource REST: v1beta.projects.locations.operations
- Resource REST: v1alpha.projects.locations
- Resource REST: v1alpha.projects.locations.conversations
- Resource REST: v1alpha.projects.locations.conversations.messages
- Resource REST: v1alpha.projects.locations.dataAgents
- Resource REST: v1alpha.projects.locations.observabilitySettings
- Resource REST: v1alpha.projects.locations.operations
- Resource REST: v1.a2a.projects.locations.agents.v1
- Resource REST: v1.a2a.projects.locations.agents.v1.message
- Resource REST: v1.a2a.projects.locations.dataAgents.v1
- Resource REST: v1.a2a.projects.locations.dataAgents.v1.message
- Resource REST: v1.projects.locations
- Resource REST: v1.projects.locations.conversations
- Resource REST: v1.projects.locations.conversations.messages
- Resource REST: v1.projects.locations.dataAgents
- Resource REST: v1.projects.locations.observabilitySettings
- Resource REST: v1.projects.locations.operations
Layanan: geminidataanalytics.googleapis.com
Untuk memanggil layanan ini, sebaiknya gunakan library klien yang disediakan Google. Jika aplikasi perlu menggunakan library Anda sendiri untuk memanggil layanan ini, gunakan informasi berikut saat membuat permintaan API.
Dokumen discovery
Dokumen Discovery adalah spesifikasi yang dapat dibaca mesin untuk mendeskripsikan dan menggunakan REST API. Dokumen ini digunakan untuk membuat library klien, plugin IDE, dan alat lainnya yang berinteraksi dengan Google API. Satu layanan dapat menyediakan beberapa dokumen discovery. Layanan ini menyediakan dokumen discovery berikut:
Endpoint layanan
Endpoint layanan adalah URL dasar yang menentukan alamat jaringan layanan API. Satu layanan dapat memiliki beberapa endpoint layanan. Layanan ini memiliki endpoint layanan berikut dan semua URI di bawah didasarkan pada endpoint layanan ini:
https://geminidataanalytics.googleapis.com
Resource REST: v1beta.a2a.projects.locations.dataAgents.v1
| Metode | |
|---|---|
getCard |
GET /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/card GetAgentCard menampilkan kartu agen untuk agen. |
Resource REST: v1beta.a2a.projects.locations.dataAgents.v1.message
| Metode | |
|---|---|
send |
POST /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:send Kirim pesan ke agen. |
stream |
POST /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:stream SendStreamingMessage adalah panggilan streaming yang akan menampilkan aliran peristiwa pembaruan tugas hingga Tugas berada dalam status terganggu atau terminal. |
Resource REST: v1beta.projects.locations
| Metode | |
|---|---|
chat |
POST /v1beta/{parent=projects/*/locations/*}:chat Menjawab pertanyaan data dengan membuat aliran objek Message. |
get |
GET /v1beta/{name=projects/*/locations/*} Mendapatkan informasi tentang lokasi. |
list |
GET /v1beta/{name=projects/*}/locations Mencantumkan informasi tentang lokasi yang didukung untuk layanan ini. |
queryData |
POST /v1beta/{parent=projects/*/locations/*}:queryData Membuat kueri data dari kueri pengguna dalam bahasa alami. |
retrieveAgentOpsObservability |
GET /v1beta/{parent=projects/*/locations/*}:retrieveAgentOpsObservability Mendapatkan setelan observabilitas agen dan status layanan yang diperlukan. |
Resource REST: v1beta.projects.locations.conversations
| Metode | |
|---|---|
create |
POST /v1beta/{parent=projects/*/locations/*}/conversations Membuat percakapan baru untuk mempertahankan histori percakapan. |
delete |
DELETE /v1beta/{name=projects/*/locations/*/conversations/*} Menghapus percakapan. |
get |
GET /v1beta/{name=projects/*/locations/*/conversations/*} Mendapatkan detail satu percakapan menggunakan ID dan induk percakapan. |
list |
GET /v1beta/{parent=projects/*/locations/*}/conversations Mencantumkan semua percakapan untuk induk tertentu. |
Resource REST: v1beta.projects.locations.conversations.messages
| Metode | |
|---|---|
list |
GET /v1beta/{parent=projects/*/locations/*/conversations/*}/messages Mencantumkan semua pesan untuk percakapan tertentu. |
Resource REST: v1beta.projects.locations.dataAgents
| Metode | |
|---|---|
create |
POST /v1beta/{parent=projects/*/locations/*}/dataAgents Membuat DataAgent baru di project dan lokasi tertentu. |
createSync |
POST /v1beta/{parent=projects/*/locations/*}/dataAgents:createSync Membuat DataAgent baru di project dan lokasi tertentu secara sinkron. |
delete |
DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*} Menghapus satu DataAgent. |
deleteSync |
DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*}:deleteSync Menghapus satu DataAgent secara sinkron. |
get |
GET /v1beta/{name=projects/*/locations/*/dataAgents/*} Mendapatkan detail satu DataAgent. |
getIamPolicy |
POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy Mendapatkan kebijakan IAM untuk DataAgent |
list |
GET /v1beta/{parent=projects/*/locations/*}/dataAgents Mencantumkan DataAgent di project dan lokasi tertentu. |
listAccessible |
GET /v1beta/{parent=projects/*/locations/*}/dataAgents:listAccessible Mencantumkan DataAgent yang dapat diakses oleh pemanggil di project dan lokasi tertentu. |
patch |
PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*} Memperbarui parameter satu DataAgent. |
setIamPolicy |
POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy Menetapkan kebijakan IAM untuk DataAgent. |
updateSync |
PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync Memperbarui parameter satu DataAgent secara sinkron. |
Resource REST: v1beta.projects.locations.observabilitySettings
| Metode | |
|---|---|
setAgentOpsObservability |
POST /v1beta/{parent=projects/*/locations/*}/observabilitySettings:setAgentOpsObservability Mengaktifkan atau menonaktifkan layanan Google Cloud yang diperlukan dan mengonfigurasi setelan observabilitas agen. |
Resource REST: v1beta.projects.locations.operations
| Metode | |
|---|---|
cancel |
POST /v1beta/{name=projects/*/locations/*/operations/*}:cancel Memulai pembatalan asinkron pada operasi yang berjalan lama. |
delete |
DELETE /v1beta/{name=projects/*/locations/*/operations/*} Menghapus operasi yang berjalan lama. |
get |
GET /v1beta/{name=projects/*/locations/*/operations/*} Mendapatkan status terbaru dari operasi yang berjalan lama. |
list |
GET /v1beta/{name=projects/*/locations/*}/operations Menampilkan operasi yang sesuai dengan filter yang ditentukan dalam permintaan. |
Resource REST: v1alpha.projects.locations
| Metode | |
|---|---|
chat |
POST /v1alpha/{parent=projects/*/locations/*}:chat Menjawab pertanyaan data dengan membuat aliran objek Message. |
get |
GET /v1alpha/{name=projects/*/locations/*} Mendapatkan informasi tentang lokasi. |
list |
GET /v1alpha/{name=projects/*}/locations Mencantumkan informasi tentang lokasi yang didukung untuk layanan ini. |
queryData |
POST /v1alpha/{parent=projects/*/locations/*}:queryData Membuat kueri data dari kueri pengguna dalam bahasa alami. |
retrieveAgentOpsObservability |
GET /v1alpha/{parent=projects/*/locations/*}:retrieveAgentOpsObservability Mendapatkan setelan observabilitas agen dan status layanan yang diperlukan. |
Resource REST: v1alpha.projects.locations.conversations
| Metode | |
|---|---|
create |
POST /v1alpha/{parent=projects/*/locations/*}/conversations Membuat percakapan baru untuk mempertahankan histori percakapan. |
delete |
DELETE /v1alpha/{name=projects/*/locations/*/conversations/*} Menghapus percakapan. |
get |
GET /v1alpha/{name=projects/*/locations/*/conversations/*} Mendapatkan detail satu percakapan menggunakan ID dan induk percakapan. |
list |
GET /v1alpha/{parent=projects/*/locations/*}/conversations Mencantumkan semua percakapan untuk induk tertentu. |
Resource REST: v1alpha.projects.locations.conversations.messages
| Metode | |
|---|---|
list |
GET /v1alpha/{parent=projects/*/locations/*/conversations/*}/messages Mencantumkan semua pesan untuk percakapan tertentu. |
Resource REST: v1alpha.projects.locations.dataAgents
| Metode | |
|---|---|
create |
POST /v1alpha/{parent=projects/*/locations/*}/dataAgents Membuat DataAgent baru di project dan lokasi tertentu. |
createSync |
POST /v1alpha/{parent=projects/*/locations/*}/dataAgents:createSync Membuat DataAgent baru di project dan lokasi tertentu secara sinkron. |
delete |
DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*} Menghapus satu DataAgent. |
deleteSync |
DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*}:deleteSync Menghapus satu DataAgent secara sinkron. |
get |
GET /v1alpha/{name=projects/*/locations/*/dataAgents/*} Mendapatkan detail satu DataAgent. |
getIamPolicy |
POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy Mendapatkan kebijakan IAM untuk DataAgent |
list |
GET /v1alpha/{parent=projects/*/locations/*}/dataAgents Mencantumkan DataAgent di project dan lokasi tertentu. |
listAccessible |
GET /v1alpha/{parent=projects/*/locations/*}/dataAgents:listAccessible Mencantumkan DataAgent yang dapat diakses oleh pemanggil di project dan lokasi tertentu. |
patch |
PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*} Memperbarui parameter satu DataAgent. |
setIamPolicy |
POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy Menetapkan kebijakan IAM untuk DataAgent. |
updateSync |
PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync Memperbarui parameter satu DataAgent secara sinkron. |
Resource REST: v1alpha.projects.locations.observabilitySettings
| Metode | |
|---|---|
setAgentOpsObservability |
POST /v1alpha/{parent=projects/*/locations/*}/observabilitySettings:setAgentOpsObservability Mengaktifkan atau menonaktifkan layanan Google Cloud yang diperlukan dan mengonfigurasi setelan observabilitas agen. |
Resource REST: v1alpha.projects.locations.operations
| Metode | |
|---|---|
cancel |
POST /v1alpha/{name=projects/*/locations/*/operations/*}:cancel Memulai pembatalan asinkron pada operasi yang berjalan lama. |
delete |
DELETE /v1alpha/{name=projects/*/locations/*/operations/*} Menghapus operasi yang berjalan lama. |
get |
GET /v1alpha/{name=projects/*/locations/*/operations/*} Mendapatkan status terbaru dari operasi yang berjalan lama. |
list |
GET /v1alpha/{name=projects/*/locations/*}/operations Menampilkan operasi yang sesuai dengan filter yang ditentukan dalam permintaan. |
Resource REST: v1.a2a.projects.locations.agents.v1
| Metode | |
|---|---|
getCard |
GET /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/card GetAgentCard menampilkan kartu agen untuk agen. |
Resource REST: v1.a2a.projects.locations.agents.v1.message
| Metode | |
|---|---|
send |
POST /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/message:send Kirim pesan ke agen. |
stream |
POST /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/message:stream SendStreamingMessage adalah panggilan streaming yang akan menampilkan aliran peristiwa pembaruan tugas hingga Tugas berada dalam status terganggu atau terminal. |
Resource REST: v1.a2a.projects.locations.dataAgents.v1
| Metode | |
|---|---|
getCard |
GET /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/card GetAgentCard menampilkan kartu agen untuk agen. |
Resource REST: v1.a2a.projects.locations.dataAgents.v1.message
| Metode | |
|---|---|
send |
POST /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:send Kirim pesan ke agen. |
stream |
POST /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:stream SendStreamingMessage adalah panggilan streaming yang akan menampilkan aliran peristiwa pembaruan tugas hingga Tugas berada dalam status terganggu atau terminal. |
Resource REST: v1.projects.locations
| Metode | |
|---|---|
chat |
POST /v1/{parent=projects/*/locations/*}:chat Menjawab pertanyaan data dengan membuat aliran objek Message. |
get |
GET /v1/{name=projects/*/locations/*} Mendapatkan informasi tentang lokasi. |
list |
GET /v1/{name=projects/*}/locations Mencantumkan informasi tentang lokasi yang didukung untuk layanan ini. |
retrieveAgentOpsObservability |
GET /v1/{parent=projects/*/locations/*}:retrieveAgentOpsObservability Mendapatkan setelan observabilitas agen dan status layanan yang diperlukan. |
Resource REST: v1.projects.locations.conversations
| Metode | |
|---|---|
create |
POST /v1/{parent=projects/*/locations/*}/conversations Membuat percakapan baru untuk mempertahankan histori percakapan. |
delete |
DELETE /v1/{name=projects/*/locations/*/conversations/*} Menghapus percakapan. |
get |
GET /v1/{name=projects/*/locations/*/conversations/*} Mendapatkan detail satu percakapan menggunakan ID dan induk percakapan. |
list |
GET /v1/{parent=projects/*/locations/*}/conversations Mencantumkan semua percakapan untuk induk tertentu. |
Resource REST: v1.projects.locations.conversations.messages
| Metode | |
|---|---|
list |
GET /v1/{parent=projects/*/locations/*/conversations/*}/messages Mencantumkan semua pesan untuk percakapan tertentu. |
Resource REST: v1.projects.locations.dataAgents
| Metode | |
|---|---|
create |
POST /v1/{parent=projects/*/locations/*}/dataAgents Membuat DataAgent baru di project dan lokasi tertentu. |
createSync |
POST /v1/{parent=projects/*/locations/*}/dataAgents:createSync Membuat DataAgent baru di project dan lokasi tertentu secara sinkron. |
delete |
DELETE /v1/{name=projects/*/locations/*/dataAgents/*} Menghapus satu DataAgent. |
deleteSync |
DELETE /v1/{name=projects/*/locations/*/dataAgents/*}:deleteSync Menghapus satu DataAgent secara sinkron. |
get |
GET /v1/{name=projects/*/locations/*/dataAgents/*} Mendapatkan detail satu DataAgent. |
getIamPolicy |
POST /v1/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy Mendapatkan kebijakan IAM untuk DataAgent |
list |
GET /v1/{parent=projects/*/locations/*}/dataAgents Mencantumkan DataAgent di project dan lokasi tertentu. |
listAccessible |
GET /v1/{parent=projects/*/locations/*}/dataAgents:listAccessible Mencantumkan DataAgent yang dapat diakses oleh pemanggil di project dan lokasi tertentu. |
patch |
PATCH /v1/{dataAgent.name=projects/*/locations/*/dataAgents/*} Memperbarui parameter satu DataAgent. |
setIamPolicy |
POST /v1/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy Menetapkan kebijakan IAM untuk DataAgent. |
updateSync |
PATCH /v1/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync Memperbarui parameter satu DataAgent secara sinkron. |
Resource REST: v1.projects.locations.observabilitySettings
| Metode | |
|---|---|
setAgentOpsObservability |
POST /v1/{parent=projects/*/locations/*}/observabilitySettings:setAgentOpsObservability Mengaktifkan atau menonaktifkan layanan Google Cloud yang diperlukan dan mengonfigurasi setelan observabilitas agen. |
Resource REST: v1.projects.locations.operations
| Metode | |
|---|---|
cancel |
POST /v1/{name=projects/*/locations/*/operations/*}:cancel Memulai pembatalan asinkron pada operasi yang berjalan lama. |
delete |
DELETE /v1/{name=projects/*/locations/*/operations/*} Menghapus operasi yang berjalan lama. |
get |
GET /v1/{name=projects/*/locations/*/operations/*} Mendapatkan status terbaru dari operasi yang berjalan lama. |
list |
GET /v1/{name=projects/*/locations/*}/operations Menampilkan operasi yang sesuai dengan filter yang ditentukan dalam permintaan. |