- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Lists messages that belong to a given conversation. messages
are ordered by createTime
in descending order. To fetch updates without duplication, send request with filter create_time_epoch_microseconds >
[first item's createTime of previous request]
and empty pageToken.
HTTP request
GET https://{endpoint}/v2/{parent=projects/*/conversations/*}/messages
Where {endpoint}
is one of the supported service endpoints
.
The URLs use gRPC Transcoding syntax.
Path parameters
parent
string
Required. The name of the conversation to list messages for. Format: projects/<Project ID>/locations/<Location
ID>/conversations/<Conversation ID>
Authorization requires the following IAM
permission on the specified resource parent
:
-
dialogflow.messages.list
Query parameters
| Parameters | |
|---|---|
filter
|
Optional. Filter on message fields. Currently predicates on For more information about filtering, see API Filtering . |
pageSize
|
Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. |
pageToken
|
Optional. The nextPageToken value returned from a previous list request. |
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of ListMessagesResponse
.
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/cloud-platform -
https://www.googleapis.com/auth/dialogflow
For more information, see the Authentication Overview .
