Method: projects.locations.conversations.messages.list

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

בקשת HTTP

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

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

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

פרמטרים
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)

תוכן ההודעה.