Method: projects.locations.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/*/locations/*/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.