Data Catalog API methods that are related to Data Catalog search and metadata are deprecated and will be discontinued on January 30, 2026. SeeTransition from Data Catalog to Dataplex Universal Catalog. Methods that are related to policy tags and policy tag taxonomies are not deprecated.
You must enable the Data Catalog API in the project identified by theparentparameter. For more information, seeData Catalog resource project.
HTTP request
POST https://datacatalog.googleapis.com/v1/{parent}/tagTemplates
Path parameters
Parameters
parent
string
Required. The name of the project and the template locationregion. It takes the formprojects/{project}/locations/{location}.
Query parameters
Parameters
tagTemplateId
string
Required. The ID of the tag template to create.
The ID must contain only lowercase letters (a-z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum size is 64 bytes when encoded in UTF-8.
Request body
The request body contains an instance ofTagTemplate.
Response body
If successful, the response body contains a newly created instance ofTagTemplate.
[[["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 how to create a tag template using the Data Catalog API, which has been deprecated in favor of Dataplex Catalog.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves sending a POST request to a specific URL, including a parent project and location within the path parameters.\u003c/p\u003e\n"],["\u003cp\u003eA required \u003ccode\u003etagTemplateId\u003c/code\u003e must be provided within the query parameters, which must adhere to specific character and size restrictions.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003eTagTemplate\u003c/code\u003e instance, and a successful response will return a newly created \u003ccode\u003eTagTemplate\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eThe API requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.tagTemplates.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\n| Data Catalog is deprecated. Please use Dataplex Universal Catalog instead.\nCreates a tag template.\n\nYou must enable the Data Catalog API in the project identified by the `parent` parameter. For more information, see [Data Catalog resource project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).\n\n### HTTP request\n\n`POST https://datacatalog.googleapis.com/v1/{parent}/tagTemplates`\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [TagTemplate](/data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates#TagTemplate).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [TagTemplate](/data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates#TagTemplate).\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)."]]
