Required. The name of the agent to update or create entity types in. Supported formats: - projects/<Project ID>/agent - projects/<Project ID>/locations/<Location ID>/agent
Authorization requires the following IAM permission on the specified resource parent:
dialogflow.entityTypes.batchUpdate
Request body
The request body contains data with the following structure:
JSON representation
{"languageCode": string,"updateMask": string,// Union field entity_type_batch can be only one of the following:"entityTypeBatchUri": string,"entityTypeBatchInline": {object (EntityTypeBatch)}// End of list of possible types for union field entity_type_batch.}
Fields
languageCode
string
Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see Multilingual intent and entity data.
Optional. The mask to control which fields get updated.
This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".
Union field entity_type_batch. The source of the entity type batch.
For each entity type in the batch:
If name is specified, we update an existing entity type.
If name is not specified, we create a new entity type. entity_type_batch can be only one of the following:
entityTypeBatchUri
string
The URI to a Google Cloud Storage file containing entity types to update or create. The file format can either be a serialized proto (of EntityBatch type) or a JSON object. Note: The URI must start with "gs://".
[[["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 updates or creates multiple entity types within a specified agent through a long-running operation.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a \u003ccode\u003ePOST\u003c/code\u003e to a specific endpoint with a path parameter \u003ccode\u003eparent\u003c/code\u003e which defines the agent to be updated, and requires \u003ccode\u003edialogflow.entityTypes.batchUpdate\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eThe request body includes options for specifying the \u003ccode\u003elanguageCode\u003c/code\u003e, an \u003ccode\u003eupdateMask\u003c/code\u003e to control field updates, and provides two options \u003ccode\u003eentityTypeBatchUri\u003c/code\u003e or \u003ccode\u003eentityTypeBatchInline\u003c/code\u003e to define the source of entity types for update or creation.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns an \u003ccode\u003eOperation\u003c/code\u003e object, and this method requires either \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e OAuth scopes for authorization.\u003c/p\u003e\n"],["\u003cp\u003eIt's recommended to train the agent before sending queries, as detailed in the provided training documentation.\u003c/p\u003e\n"]]],[],null,["# Method: projects.agent.entityTypes.batchUpdate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates/Creates multiple entity types in the specified agent.\n\nThis method is a [long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations). The returned `Operation` type has the following method-specific fields:\n\n- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)\n- `response`: [BatchUpdateEntityTypesResponse](/dialogflow/es/docs/reference/rest/v2beta1/BatchUpdateEntityTypesResponse)\n\nNote: You should always train an agent prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/es/docs/training).\n\n### HTTP request\n\n`POST https://{endpoint}/v2beta1/{parent=projects/*/agent}/entityTypes:batchUpdate`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/dialogflow/es/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.operations#Operation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/dialogflow`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
