This preview documentation is deprecated as of October 27, 2023. For GA documentation, go to the Vertex AI Search documentation.

Changes in GA:

Name: Discovery for Media is renamed to Vertex AI Search for media. Vertex AI Search includes media recommendations and media search.
Google Cloud Console page: Use the Agent Builder page in the console. The Discovery Engine console page is deprecated.
API reference: Continue to use the discoveryengine.googleapis.com service. The API remains the same but the documentation has moved. Go to the up-to-date, GA version of the Discovery Engine API reference in the Vertex AI Search documentation.
All changes: To see what else changed between preview and GA, see Switch from Discovery for Media to media recommendations in the Vertex AI Search documentation.

Method: projects.locations.collections.dataStores.conversations.list

Lists all Conversations by their parent DataStore.

GET https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/conversations

The URL uses gRPC Transcoding syntax.

Parameters

Parameters
`parent`	`string` Required. The data store resource name. Format: `projects/{projectNumber}/locations/{locationId}/collections/{collection}/dataStores/{dataStoreId}`

parent

string

Required. The data store resource name. Format: projects/{projectNumber}/locations/{locationId}/collections/{collection}/dataStores/{dataStoreId}

Parameters
`pageSize`	`integer` Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
`pageToken`	`string` A page token, received from a previous `conversations.list` call. Provide this to retrieve the subsequent page.
`filter`	`string` A filter to apply on the list results. The supported features are: userPseudoId, state. Example: "userPseudoId = some_id"
`orderBy`	`string` A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `updateTime` * `createTime` * `conversation_name` Example: "updateTime desc" "createTime"

The request body must be empty.

If successful, the response body contains an instance of ListConversationsResponse.

Requires the following OAuth scope:

For more information, see the Authentication Overview.

Requires the following IAM permission on the parent resource:

For more information, see the IAM documentation.