Bulk import of user events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events.
Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.
HTTP request
POST https://discoveryengine.googleapis.com/v1/{parent=projects/*/locations/*/collections/*/dataStores/*}/userEvents:import
Required. Parent DataStore resource name, of the form projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}
Request body
The request body contains data with the following structure:
JSON representation
{"errorConfig": {object (ImportErrorConfig)},// Union field source can be only one of the following:"inlineSource": {object (InlineSource)},"gcsSource": {object (GcsSource)},"bigquerySource": {object (BigQuerySource)}// End of list of possible types for union field source.}
[[["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-06-27 UTC."],[[["\u003cp\u003eThis API facilitates bulk importing of user events, allowing for backfilling of historical data while skipping events that already exist.\u003c/p\u003e\n"],["\u003cp\u003eThe API uses a POST request to a URL with a required \u003ccode\u003eparent\u003c/code\u003e path parameter specifying the DataStore resource location.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires an input \u003ccode\u003esource\u003c/code\u003e specified as either \u003ccode\u003einlineSource\u003c/code\u003e, \u003ccode\u003egcsSource\u003c/code\u003e, or \u003ccode\u003ebigquerySource\u003c/code\u003e, along with an optional \u003ccode\u003eerrorConfig\u003c/code\u003e for error logging.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns an \u003ccode\u003eOperation\u003c/code\u003e object, and it's possible that only some items will be successfully imported, but also requires the \u003ccode\u003ediscoveryengine.userEvents.import\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eThe API uses the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,[]]