Method: projects.locations.conversations.create

יוצר שיחה חדשה כדי לשמור את היסטוריית השיחה. לכל שיחה יש כמה הודעות שמשויכות אליה.

בקשת HTTP

POST https://geminidataanalytics.googleapis.com/v1beta/{parent=projects/*/locations/*}/conversations

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. ערך ההורה של CreateConversationRequest. פורמט: projects/{project}/locations/{location}

פרמטרים של שאילתה

פרמטרים
conversationId

string

זה שינוי אופציונלי. מזהה השיחה שרוצים ליצור. המזהה חייב להיות ייחודי במסגרת פריט האב. הפורמט המותר הוא: ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$. אם לא מספקים ערך, השרת יוצר ערך למזהה באופן אוטומטי.
requestId

string

זה שינוי אופציונלי. מזהה בקשה אופציונלי לזיהוי בקשות. צריך לציין מזהה בקשה ייחודי, כדי שאם תצטרכו לנסות שוב לשלוח את הבקשה, השרת ידע להתעלם ממנה אם היא כבר הושלמה. השרת יבטיח זאת למשך 60 דקות לפחות מאז הבקשה הראשונה.

גוף הבקשה

גוף הבקשה מכיל מופע של Conversation.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Conversation.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

ניתן למצוא מידע נוסף כאן: Authentication Overview.