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/v1beta/{parent=projects/*/locations/*}/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 method allows for the bulk import of user events, primarily for backfilling historical data, while skipping events that already exist.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses a \u003ccode\u003ePOST\u003c/code\u003e method to a specific URL that follows gRPC Transcoding syntax, targeting a DataStore resource using a specified parent parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body accepts user event data from various sources, including inline data, Cloud Storage (\u003ccode\u003egcsSource\u003c/code\u003e), or BigQuery, and supports configuring an \u003ccode\u003eerrorConfig\u003c/code\u003e for the location of errors during import.\u003c/p\u003e\n"],["\u003cp\u003eThe successful response body returns an \u003ccode\u003eOperation\u003c/code\u003e object, and it's important to note that partial success (some items imported, others not) is possible.\u003c/p\u003e\n"],["\u003cp\u003eThis method requires OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the \u003ccode\u003ediscoveryengine.userEvents.import\u003c/code\u003e IAM permission on the parent resource for proper authorization.\u003c/p\u003e\n"]]],[],null,[]]