Data Analytics API עם Gemini (geminidataanalytics.googleapis.com) מספק שיטות לשליחת שאילתות לנתונים ולניתוח שלהם באמצעות שפה טבעית, וליצירה ולניהול של סוכני הנתונים שמבצעים אינטראקציה עם הנתונים שלכם במקורות נתונים נתמכים. המפתחים צריכים לבחור את נתיב נקודת הקצה המתאים בהתאם לדרישות היציבות שלהם.
- v1: מומלץ לתכונות שזמינות לכלל המשתמשים שאפשר לשלב בסביבות ייצור.
- v1beta: מומלץ לשילוב תכונות חדשות בסביבות ייצור במהלך תקופת התצוגה המקדימה שלהן.
- v1alpha: מיועד לבדיקה של תכונות חדשות ועתידיות. יכול להיות שהתכונות האלה ישתנו או יוסרו, ולכן יכול להיות שתצטרכו לעדכן את הקוד.
מידע נוסף על שלבי השקת מוצרים ב-Google Cloud
מדריכים מפורטים להטמעה זמינים במאמר סקירה כללית על Conversational Analytics API.
- משאב REST: v1beta.a2a.projects.locations.dataAgents.v1
- משאב REST: v1beta.a2a.projects.locations.dataAgents.v1.message
- משאב REST: v1beta.projects.locations
- משאב REST: v1beta.projects.locations.conversations
- משאב REST: v1beta.projects.locations.conversations.messages
- משאב REST: v1beta.projects.locations.dataAgents
- משאב REST: v1beta.projects.locations.operations
- משאב REST: v1alpha.projects.locations
- משאב REST: v1alpha.projects.locations.conversations
- משאב REST: v1alpha.projects.locations.conversations.messages
- משאב REST: v1alpha.projects.locations.dataAgents
- משאב REST: v1alpha.projects.locations.operations
- משאב REST: v1.a2a.projects.locations.agents.v1
- משאב REST: v1.a2a.projects.locations.agents.v1.message
- משאב REST: v1.a2a.projects.locations.dataAgents.v1
- משאב REST: v1.a2a.projects.locations.dataAgents.v1.message
- משאב REST: v1.projects.locations
- REST Resource: v1.projects.locations.conversations
- משאב REST: v1.projects.locations.conversations.messages
- משאב REST: v1.projects.locations.dataAgents
- משאב REST: v1.projects.locations.operations
שירות: geminidataanalytics.googleapis.com
כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה צריכה להשתמש בספריות משלה כדי לקרוא לשירות הזה, צריך להשתמש במידע הבא כשמבצעים את בקשות ה-API.
מסמך Discovery
Discovery Document הוא מפרט שניתן לקריאה על ידי מכונה, שמתאר ומאפשר שימוש בממשקי API ל-REST. היא משמשת לבניית ספריות לקוח, תוספים ל-IDE וכלים אחרים שמתקשרים עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמכי הגילוי הבאים:
נקודת קצה של שירות
נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. יכול להיות שלשירות אחד יהיו כמה נקודות קצה של שירות. לשירות הזה יש נקודת קצה שירות משלו, וכל כתובות ה-URI שבהמשך הן יחסיות לנקודת קצה השירות הזו:
https://geminidataanalytics.googleapis.com
משאב REST: v1beta.a2a.projects.locations.dataAgents.v1
| Methods | |
|---|---|
getCard |
GET /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/card הפונקציה GetAgentCard מחזירה את כרטיס הסוכן של הסוכן. |
משאב REST: v1beta.a2a.projects.locations.dataAgents.v1.message
| Methods | |
|---|---|
send |
POST /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:send שליחת הודעה לנציג. |
stream |
POST /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:stream SendStreamingMessage היא קריאה לשידור שתחזיר זרם של אירועי עדכון משימות עד שהמשימה תהיה במצב מופרע או סופי. |
משאב REST: v1beta.projects.locations
| Methods | |
|---|---|
chat |
POST /v1beta/{parent=projects/*/locations/*}:chat הפונקציה עונה על שאלה לגבי נתונים על ידי יצירת זרם של Message אובייקטים. |
get |
GET /v1beta/{name=projects/*/locations/*} קבלת מידע על מיקום. |
list |
GET /v1beta/{name=projects/*}/locations רשימת המיקומים שבהם השירות הזה נתמך. |
queryData |
POST /v1beta/{parent=projects/*/locations/*}:queryData שליפת נתונים משאילתת משתמש בשפה טבעית. |
משאב REST: v1beta.projects.locations.conversations
| Methods | |
|---|---|
create |
POST /v1beta/{parent=projects/*/locations/*}/conversations יוצר שיחה חדשה כדי לשמור את היסטוריית השיחה. |
delete |
DELETE /v1beta/{name=projects/*/locations/*/conversations/*} מחיקת שיחה. |
get |
GET /v1beta/{name=projects/*/locations/*/conversations/*} מקבל פרטים של שיחה יחידה באמצעות מזהה השיחה וההורה. |
list |
GET /v1beta/{parent=projects/*/locations/*}/conversations מציג רשימה של כל השיחות עבור הורה נתון. |
משאב REST: v1beta.projects.locations.conversations.messages
| Methods | |
|---|---|
list |
GET /v1beta/{parent=projects/*/locations/*/conversations/*}/messages מציג רשימה של כל ההודעות בשיחה מסוימת. |
משאב REST: v1beta.projects.locations.dataAgents
| Methods | |
|---|---|
create |
POST /v1beta/{parent=projects/*/locations/*}/dataAgents יוצר סוכן נתונים חדש בפרויקט ובמיקום נתונים נתונים. |
createSync |
POST /v1beta/{parent=projects/*/locations/*}/dataAgents:createSync יוצרת DataAgent חדש בפרויקט ובמיקום נתונים נתונים באופן סינכרוני. |
delete |
DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*} מוחק סוכן נתונים יחיד. |
deleteSync |
DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*}:deleteSync מוחק סוכן נתונים יחיד באופן סינכרוני. |
get |
GET /v1beta/{name=projects/*/locations/*/dataAgents/*} קבלת פרטים של DataAgent יחיד. |
getIamPolicy |
POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy קבלת מדיניות IAM עבור DataAgent |
list |
GET /v1beta/{parent=projects/*/locations/*}/dataAgents מציג רשימה של סוכני נתונים בפרויקט ובמיקום נתונים מסוימים. |
listAccessible |
GET /v1beta/{parent=projects/*/locations/*}/dataAgents:listAccessible מציגה רשימה של סוכני נתונים שהמתקשר יכול לגשת אליהם בפרויקט ובמיקום נתונים מסוימים. |
patch |
PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*} מעדכן את הפרמטרים של DataAgent יחיד. |
setIamPolicy |
POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy מגדיר את מדיניות ה-IAM עבור DataAgent. |
updateSync |
PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync מעדכן את הפרמטרים של DataAgent יחיד באופן סינכרוני. |
משאב REST: v1beta.projects.locations.operations
| Methods | |
|---|---|
cancel |
POST /v1beta/{name=projects/*/locations/*/operations/*}:cancel מתחילה ביטול אסינכרוני של פעולה ממושכת. |
delete |
DELETE /v1beta/{name=projects/*/locations/*/operations/*} מוחק פעולה ממושכת. |
get |
GET /v1beta/{name=projects/*/locations/*/operations/*} אחזור המצב העדכני של פעולה ממושכת. |
list |
GET /v1beta/{name=projects/*/locations/*}/operations רשימת פעולות שתואמות למסנן שצוין בבקשה. |
משאב REST: v1alpha.projects.locations
| Methods | |
|---|---|
chat |
POST /v1alpha/{parent=projects/*/locations/*}:chat הפונקציה עונה על שאלה לגבי נתונים על ידי יצירת זרם של Message אובייקטים. |
get |
GET /v1alpha/{name=projects/*/locations/*} קבלת מידע על מיקום. |
list |
GET /v1alpha/{name=projects/*}/locations רשימת המיקומים שבהם השירות הזה נתמך. |
queryData |
POST /v1alpha/{parent=projects/*/locations/*}:queryData שליפת נתונים משאילתת משתמש בשפה טבעית. |
משאב REST: v1alpha.projects.locations.conversations
| Methods | |
|---|---|
create |
POST /v1alpha/{parent=projects/*/locations/*}/conversations יוצר שיחה חדשה כדי לשמור את היסטוריית השיחה. |
delete |
DELETE /v1alpha/{name=projects/*/locations/*/conversations/*} מחיקת שיחה. |
get |
GET /v1alpha/{name=projects/*/locations/*/conversations/*} מקבל פרטים של שיחה יחידה באמצעות מזהה השיחה וההורה. |
list |
GET /v1alpha/{parent=projects/*/locations/*}/conversations מציג רשימה של כל השיחות עבור הורה נתון. |
משאב REST: v1alpha.projects.locations.conversations.messages
| Methods | |
|---|---|
list |
GET /v1alpha/{parent=projects/*/locations/*/conversations/*}/messages מציג רשימה של כל ההודעות בשיחה מסוימת. |
משאב REST: v1alpha.projects.locations.dataAgents
| Methods | |
|---|---|
create |
POST /v1alpha/{parent=projects/*/locations/*}/dataAgents יוצר סוכן נתונים חדש בפרויקט ובמיקום נתונים נתונים. |
createSync |
POST /v1alpha/{parent=projects/*/locations/*}/dataAgents:createSync יוצרת DataAgent חדש בפרויקט ובמיקום נתונים נתונים באופן סינכרוני. |
delete |
DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*} מוחק סוכן נתונים יחיד. |
deleteSync |
DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*}:deleteSync מוחק סוכן נתונים יחיד באופן סינכרוני. |
get |
GET /v1alpha/{name=projects/*/locations/*/dataAgents/*} קבלת פרטים של DataAgent יחיד. |
getIamPolicy |
POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy קבלת מדיניות IAM עבור DataAgent |
list |
GET /v1alpha/{parent=projects/*/locations/*}/dataAgents מציג רשימה של סוכני נתונים בפרויקט ובמיקום נתונים מסוימים. |
listAccessible |
GET /v1alpha/{parent=projects/*/locations/*}/dataAgents:listAccessible מציגה רשימה של סוכני נתונים שהמתקשר יכול לגשת אליהם בפרויקט ובמיקום נתונים מסוימים. |
patch |
PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*} מעדכן את הפרמטרים של DataAgent יחיד. |
setIamPolicy |
POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy מגדיר את מדיניות ה-IAM עבור DataAgent. |
updateSync |
PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync מעדכן את הפרמטרים של DataAgent יחיד באופן סינכרוני. |
משאב REST: v1alpha.projects.locations.operations
| Methods | |
|---|---|
cancel |
POST /v1alpha/{name=projects/*/locations/*/operations/*}:cancel מתחילה ביטול אסינכרוני של פעולה ממושכת. |
delete |
DELETE /v1alpha/{name=projects/*/locations/*/operations/*} מוחק פעולה ממושכת. |
get |
GET /v1alpha/{name=projects/*/locations/*/operations/*} אחזור המצב העדכני של פעולה ממושכת. |
list |
GET /v1alpha/{name=projects/*/locations/*}/operations רשימת פעולות שתואמות למסנן שצוין בבקשה. |
משאב REST: v1.a2a.projects.locations.agents.v1
| Methods | |
|---|---|
getCard |
GET /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/card הפונקציה GetAgentCard מחזירה את כרטיס הסוכן של הסוכן. |
משאב REST: v1.a2a.projects.locations.agents.v1.message
| Methods | |
|---|---|
send |
POST /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/message:send שליחת הודעה לנציג. |
stream |
POST /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/message:stream SendStreamingMessage היא קריאה לשידור שתחזיר זרם של אירועי עדכון משימות עד שהמשימה תהיה במצב מופרע או סופי. |
משאב REST: v1.a2a.projects.locations.dataAgents.v1
| Methods | |
|---|---|
getCard |
GET /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/card הפונקציה GetAgentCard מחזירה את כרטיס הסוכן של הסוכן. |
משאב REST: v1.a2a.projects.locations.dataAgents.v1.message
| Methods | |
|---|---|
send |
POST /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:send שליחת הודעה לנציג. |
stream |
POST /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:stream SendStreamingMessage היא קריאה לשידור שתחזיר זרם של אירועי עדכון משימות עד שהמשימה תהיה במצב מופרע או סופי. |
משאב REST: v1.projects.locations
| Methods | |
|---|---|
chat |
POST /v1/{parent=projects/*/locations/*}:chat הפונקציה עונה על שאלה לגבי נתונים על ידי יצירת זרם של Message אובייקטים. |
get |
GET /v1/{name=projects/*/locations/*} קבלת מידע על מיקום. |
list |
GET /v1/{name=projects/*}/locations רשימת המיקומים שבהם השירות הזה נתמך. |
משאב REST: v1.projects.locations.conversations
| Methods | |
|---|---|
create |
POST /v1/{parent=projects/*/locations/*}/conversations יוצר שיחה חדשה כדי לשמור את היסטוריית השיחה. |
delete |
DELETE /v1/{name=projects/*/locations/*/conversations/*} מחיקת שיחה. |
get |
GET /v1/{name=projects/*/locations/*/conversations/*} מקבל פרטים של שיחה יחידה באמצעות מזהה השיחה וההורה. |
list |
GET /v1/{parent=projects/*/locations/*}/conversations מציג רשימה של כל השיחות עבור הורה נתון. |
משאב REST: v1.projects.locations.conversations.messages
| Methods | |
|---|---|
list |
GET /v1/{parent=projects/*/locations/*/conversations/*}/messages מציג רשימה של כל ההודעות בשיחה מסוימת. |
משאב REST: v1.projects.locations.dataAgents
| Methods | |
|---|---|
create |
POST /v1/{parent=projects/*/locations/*}/dataAgents יוצר סוכן נתונים חדש בפרויקט ובמיקום נתונים נתונים. |
createSync |
POST /v1/{parent=projects/*/locations/*}/dataAgents:createSync יוצרת DataAgent חדש בפרויקט ובמיקום נתונים נתונים באופן סינכרוני. |
delete |
DELETE /v1/{name=projects/*/locations/*/dataAgents/*} מוחק סוכן נתונים יחיד. |
deleteSync |
DELETE /v1/{name=projects/*/locations/*/dataAgents/*}:deleteSync מוחק סוכן נתונים יחיד באופן סינכרוני. |
get |
GET /v1/{name=projects/*/locations/*/dataAgents/*} קבלת פרטים של DataAgent יחיד. |
getIamPolicy |
POST /v1/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy קבלת מדיניות IAM עבור DataAgent |
list |
GET /v1/{parent=projects/*/locations/*}/dataAgents מציג רשימה של סוכני נתונים בפרויקט ובמיקום נתונים מסוימים. |
listAccessible |
GET /v1/{parent=projects/*/locations/*}/dataAgents:listAccessible מציגה רשימה של סוכני נתונים שהמתקשר יכול לגשת אליהם בפרויקט ובמיקום נתונים מסוימים. |
patch |
PATCH /v1/{dataAgent.name=projects/*/locations/*/dataAgents/*} מעדכן את הפרמטרים של DataAgent יחיד. |
setIamPolicy |
POST /v1/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy מגדיר את מדיניות ה-IAM עבור DataAgent. |
updateSync |
PATCH /v1/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync מעדכן את הפרמטרים של DataAgent יחיד באופן סינכרוני. |
משאב REST: v1.projects.locations.operations
| Methods | |
|---|---|
cancel |
POST /v1/{name=projects/*/locations/*/operations/*}:cancel מתחילה ביטול אסינכרוני של פעולה ממושכת. |
delete |
DELETE /v1/{name=projects/*/locations/*/operations/*} מוחק פעולה ממושכת. |
get |
GET /v1/{name=projects/*/locations/*/operations/*} אחזור המצב העדכני של פעולה ממושכת. |
list |
GET /v1/{name=projects/*/locations/*}/operations רשימת פעולות שתואמות למסנן שצוין בבקשה. |