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."],[[["This document describes the process of importing multiple taxonomies and their policy tags into a project using a single request, leveraging a nested proto structure."],["The HTTP request to import taxonomies is a `POST` operation to `https://datacatalog.googleapis.com/v1beta1/{parent}/taxonomies:import`, with the `parent` path parameter specifying the project and location for the import."],["The request body utilizes a union field `source` that can be specifically an `inlineSource`, which contains the structure of the taxonomies that will be imported, within the request."],["The response body, if successful, returns a list of the imported `taxonomies`, each containing detailed taxonomy information."],["Authorization for this operation requires the `datacatalog.taxonomies.create` IAM permission on the specified `parent` resource and the `https://www.googleapis.com/auth/cloud-platform` OAuth scope."]]],[]]
