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.
Creates new taxonomies (including their policy tags) in a given project by importing from inlined or cross-regional sources.
For a cross-regional source, new taxonomies are created by copying from a source in another region.
For an inlined source, taxonomies and policy tags are created in bulk using nested protocol buffer structures.
HTTP request
POST https://datacatalog.googleapis.com/v1/{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)},"crossRegionalSource": {object (CrossRegionalSource)}// End of list of possible types for union field source.}
Fields
Union field source. Source taxonomies to import. 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 page details how to import new taxonomies, including their policy tags, into a project using the Data Catalog API.\u003c/p\u003e\n"],["\u003cp\u003eTaxonomies can be imported from either an inlined source, where they are created in bulk using nested structures, or from a cross-regional source, copying an existing taxonomy from another region.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request to import taxonomies is a POST request to \u003ccode\u003ehttps://datacatalog.googleapis.com/v1/{parent}/taxonomies:import\u003c/code\u003e, and it requires the \u003ccode\u003edatacatalog.taxonomies.create\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must specify the \u003ccode\u003esource\u003c/code\u003e, which can be either \u003ccode\u003einlineSource\u003c/code\u003e or \u003ccode\u003ecrossRegionalSource\u003c/code\u003e, and each of them contains specific information.\u003c/p\u003e\n"],["\u003cp\u003eThe response body will contain a \u003ccode\u003etaxonomies\u003c/code\u003e field that contains an array of the imported taxonomies, as well as their detailed data.\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- [CrossRegionalSource](#CrossRegionalSource)\n - [JSON representation](#CrossRegionalSource.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nCreates new taxonomies (including their policy tags) in a given project by importing from inlined or cross-regional sources.\n\nFor a cross-regional source, new taxonomies are created by copying from a source in another region.\n\nFor an inlined source, taxonomies and policy tags are created in bulk using nested protocol buffer structures.\n\n### HTTP request\n\n`POST https://datacatalog.googleapis.com/v1/{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/v1/projects.locations.taxonomies/import#google.cloud.datacatalog.v1.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 containing taxonomies to import.\n\nCrossRegionalSource\n-------------------\n\nCross-regional source used to import an existing taxonomy into a different region."]]
