Method: projects.locations.conversations.messages.list

רשימה של כל ההודעות בשיחה מסוימת.

בקשת HTTP

GET https://geminidataanalytics.googleapis.com/v1alpha/{parent=projects/*/locations/*/conversations/*}/messages

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

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

פרמטרים
parent

string

חובה. השיחה שרוצים להציג את ההודעות שלה. פורמט: projects/{project}/locations/{location}/conversations/{conversationId}

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

פרמטרים
pageSize

integer

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

string

זה שינוי אופציונלי. אסימון שמזהה איזה דף תוצאות השרת צריך להחזיר.
filter

string

זה שינוי אופציונלי. סינון התוצאות. כללי התחביר מפורטים ב-AIP-160.

השיטה messages.list מאפשרת סינון לפי: * createTime (לדוגמה, createTime > "2025-01-28T06:51:56-08:00") * updateTime

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

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

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "messages": [
    {
      object (StorageMessage)
    }
  ],
  "nextPageToken": string
}
שדות
messages[]

object (StorageMessage)

רשימת ההודעות בצ'אט.
nextPageToken

string

אסימון שמזהה איזה דף תוצאות השרת צריך להחזיר.

היקפי הרשאות

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

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

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

StorageMessage

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

ייצוג ב-JSON 
{
  "messageId": string,
  "message": {
    object (Message)
  }
}
שדות
messageId

string

שם המשאב הייחודי של הודעה בצ'אט.
message

object (Message)

תוכן ההודעה.