Data Catalog API methods that are related to Data Catalog search and metadata are deprecated and will be discontinued on January 30, 2026. See Transition from Data Catalog to Dataplex Universal Catalog. Methods that are related to policy tags and policy tag taxonomies are not deprecated.
Imports all taxonomies and their policy tags to a project as new taxonomies.
This method provides a bulk taxonomy / policy tag creation using nested proto structure.
HTTP request
POST https://datacatalog.googleapis.com/v1beta1/{parent}/taxonomies:import
Path parameters
Parameters
parent
string
Required. Resource name of project that the imported taxonomies will belong to. It takes the form projects/{project}/locations/{location}.
Authorization requires the following IAM permission on the specified resource parent:
datacatalog.taxonomies.create
Request body
The request body contains data with the following structure:
JSON representation
{// Union field source can be only one of the following:"inlineSource": {object (InlineSource)}// End of list of possible types for union field source.}
Fields
Union field source. Source taxonomies to be imported. source can be only one of the following:
[[["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-07-17 UTC."],[[["\u003cp\u003eThis document describes the process of importing multiple taxonomies and their policy tags into a project using a single request, leveraging a nested proto structure.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request to import taxonomies is a \u003ccode\u003ePOST\u003c/code\u003e operation to \u003ccode\u003ehttps://datacatalog.googleapis.com/v1beta1/{parent}/taxonomies:import\u003c/code\u003e, with the \u003ccode\u003eparent\u003c/code\u003e path parameter specifying the project and location for the import.\u003c/p\u003e\n"],["\u003cp\u003eThe request body utilizes a union field \u003ccode\u003esource\u003c/code\u003e that can be specifically an \u003ccode\u003einlineSource\u003c/code\u003e, which contains the structure of the taxonomies that will be imported, within the request.\u003c/p\u003e\n"],["\u003cp\u003eThe response body, if successful, returns a list of the imported \u003ccode\u003etaxonomies\u003c/code\u003e, each containing detailed taxonomy information.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this operation requires the \u003ccode\u003edatacatalog.taxonomies.create\u003c/code\u003e IAM permission on the specified \u003ccode\u003eparent\u003c/code\u003e resource and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.taxonomies.import\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 - [JSON representation](#body.ImportTaxonomiesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [InlineSource](#InlineSource)\n - [JSON representation](#InlineSource.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nImports all taxonomies and their policy tags to a project as new taxonomies.\n\nThis method provides a bulk taxonomy / policy tag creation using nested proto structure.\n\n### HTTP request\n\n`POST https://datacatalog.googleapis.com/v1beta1/{parent}/taxonomies:import`\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nResponse message for [taxonomies.import](/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies/import#google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization.ImportTaxonomies).\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\nInlineSource\n------------\n\nInline source used for taxonomies import."]]
