Immutable. Fully qualified name projects/{project}/locations/global/collections/{collection}/dataStore/*/conversations/* or projects/{project}/locations/global/collections/{collection}/engines/*/conversations/*.
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-26 UTC."],[[["\u003cp\u003eThis document defines the "Conversation" resource, which represents an external conversation proto definition within a data store or engine.\u003c/p\u003e\n"],["\u003cp\u003eThe Conversation resource includes fields like \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003estate\u003c/code\u003e, \u003ccode\u003euserPseudoId\u003c/code\u003e, \u003ccode\u003emessages\u003c/code\u003e, \u003ccode\u003estartTime\u003c/code\u003e, and \u003ccode\u003eendTime\u003c/code\u003e, with \u003ccode\u003estartTime\u003c/code\u003e and \u003ccode\u003eendTime\u003c/code\u003e using the Timestamp format.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation of a Conversation includes the same key fields as the resource itself, like the name, state, user id, message, and start and end time.\u003c/p\u003e\n"],["\u003cp\u003eThere are six methods associated with Conversations, including creating, deleting, getting, listing, updating, and conversing.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e field uniquely identifies a Conversation and follows the format: \u003ccode\u003eprojects/{project}/locations/global/collections/{collection}/dataStore/*/conversations/*\u003c/code\u003e or \u003ccode\u003eprojects/{project}/locations/global/collections/{collection}/engines/*/conversations/*\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["- [Resource: Conversation](#Conversation)\n - [JSON representation](#Conversation.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Conversation External conversation proto definition.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"state\": enum (/generative-ai-app-builder/docs/reference/rest/v1beta/projects.locations.collections.dataStores.conversations#Conversation.State), \"userPseudoId\": string, \"messages\": [ { object (/generative-ai-app-builder/docs/reference/rest/v1beta/projects.locations.collections.dataStores.conversations#Conversation.ConversationMessage) } ], \"startTime\": string, \"endTime\": string } ``` |\n\n| Fields ||\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/dataStore/*/conversations/*` or `projects/{project}/locations/global/collections/{collection}/engines/*/conversations/*`. |\n| `state` | `enum (`[State](/generative-ai-app-builder/docs/reference/rest/v1beta/projects.locations.collections.dataStores.conversations#Conversation.State)`)` The state of the Conversation. |\n| `userPseudoId` | `string` A unique identifier for tracking users. |\n| `messages[]` | `object (`[ConversationMessage](/generative-ai-app-builder/docs/reference/rest/v1beta/projects.locations.collections.dataStores.conversations#Conversation.ConversationMessage)`)` Conversation messages. |\n| `startTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. The time the conversation started. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `endTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. The time the conversation finished. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n\n| Methods ||\n|---------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [converse](/generative-ai-app-builder/docs/reference/rest/v1beta/projects.locations.collections.engines.conversations/converse) | Converses a conversation. |\n| [create](/generative-ai-app-builder/docs/reference/rest/v1beta/projects.locations.collections.engines.conversations/create) | Creates a Conversation. |\n| [delete](/generative-ai-app-builder/docs/reference/rest/v1beta/projects.locations.collections.engines.conversations/delete) | Deletes a Conversation. |\n| [get](/generative-ai-app-builder/docs/reference/rest/v1beta/projects.locations.collections.engines.conversations/get) | Gets a Conversation. |\n| [list](/generative-ai-app-builder/docs/reference/rest/v1beta/projects.locations.collections.engines.conversations/list) | Lists all Conversations by their parent [DataStore](/generative-ai-app-builder/docs/reference/rest/v1beta/projects.locations.collections.dataStores#DataStore). |\n| [patch](/generative-ai-app-builder/docs/reference/rest/v1beta/projects.locations.collections.engines.conversations/patch) | Updates a Conversation. |"]]