Method: projects.conversations.messages.list

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

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

string

Optional. Filter on message fields. Currently predicates on createTime and create_time_epoch_microseconds are supported. createTime only support milliseconds accuracy. E.g., create_time_epoch_microseconds > 1551790877964485 or createTime > 2017-01-15T01:30:15.01Z .

For more information about filtering, see API Filtering .

pageSize

integer

Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.

pageToken

string

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 .

Design a Mobile Site
View Site in Mobile | Classic
Share by: