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.

Method: projects.locations.taxonomies.import

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

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` . }

 { 
 // 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:

inlineSource

object ( InlineSource )

Inline source taxonomy to import.

crossRegionalSource

object ( CrossRegionalSource )

Cross-regional source taxonomy to import.

Response body

Response message for taxonomies.import .

If successful, the response body contains data with the following structure:

JSON representation
{ "taxonomies" : [ { object ( `Taxonomy` ) } ] }

Fields

Fields
`taxonomies[]`	`object ( Taxonomy )` Imported taxonomies.

taxonomies[]

object ( Taxonomy )

Imported taxonomies.

Authorization scopes

Requires the following OAuth scope:

https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview .

InlineSource

Inline source containing taxonomies to import.

JSON representation
{ "taxonomies" : [ { object ( `SerializedTaxonomy` ) } ] }

Fields

Fields
`taxonomies[]`	`object ( SerializedTaxonomy )` Required. Taxonomies to import.

taxonomies[]

object ( SerializedTaxonomy )

Required. Taxonomies to import.

CrossRegionalSource

Cross-regional source used to import an existing taxonomy into a different region.

JSON representation
{ "taxonomy" : string }

Fields

Fields
`taxonomy`	`string` Required. The resource name of the source taxonomy to import.

taxonomy

string

Required. The resource name of the source taxonomy to import.