{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-cloud-data-catalog/json-schema/google-cloud-data-catalog-google-cloud-datacatalog-v1-taxonomy-schema.json",
  "title": "GoogleCloudDatacatalogV1Taxonomy",
  "description": "A taxonomy is a collection of hierarchical policy tags that classify data along a common axis. For example, a \"data sensitivity\" taxonomy might contain the following policy tags: ``` + PII + Account number + Age + SSN + Zipcode + Financials + Revenue ``` A \"data origin\" taxonomy might contain the following policy tags: ``` + User data + Employee data + Partner data + Public data ```",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-cloud-data-catalog-datacatalog-projects-api-openapi.yml#/components/schemas/GoogleCloudDatacatalogV1Taxonomy",
  "type": "object",
  "properties": {
    "activatedPolicyTypes": {
      "type": "array",
      "items": {
        "enum": [
          "POLICY_TYPE_UNSPECIFIED",
          "FINE_GRAINED_ACCESS_CONTROL"
        ],
        "type": "string"
      },
      "description": "Optional. A list of policy types that are activated for this taxonomy. If not set, defaults to an empty list."
    },
    "policyTagCount": {
      "readOnly": true,
      "type": "integer",
      "format": "int32",
      "description": "Output only. Number of policy tags in this taxonomy."
    },
    "taxonomyTimestamps": {
      "$ref": "#/$defs/GoogleCloudDatacatalogV1SystemTimestamps",
      "description": "Output only. Creation and modification timestamps of this taxonomy."
    },
    "service": {
      "$ref": "#/$defs/GoogleCloudDatacatalogV1TaxonomyService",
      "description": "Output only. Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a Google Cloud service. Currently only 'DATAPLEX' is supported."
    },
    "description": {
      "description": "Optional. Description of this taxonomy. If not set, defaults to empty. The description must contain only Unicode characters, tabs, newlines, carriage returns, and page breaks, and be at most 2000 bytes long when encoded in UTF-8.",
      "type": "string"
    },
    "displayName": {
      "type": "string",
      "description": "Required. User-defined name of this taxonomy. The name can't start or end with spaces, must contain only Unicode letters, numbers, underscores, dashes, and spaces, and be at most 200 bytes long when encoded in UTF-8. The taxonomy display name must be unique within an organization."
    },
    "name": {
      "type": "string",
      "description": "Identifier. Resource name of this taxonomy in URL format. Note: Policy tag manager generates unique taxonomy IDs."
    }
  },
  "$defs": {
    "GoogleCloudDatacatalogV1SystemTimestamps": {
      "description": "Timestamps associated with this resource in a particular system.",
      "type": "object",
      "properties": {
        "createTime": {
          "type": "string",
          "format": "google-datetime",
          "description": "Creation timestamp of the resource within the given system."
        },
        "updateTime": {
          "description": "Timestamp of the last modification of the resource or its metadata within a given system. Note: Depending on the source system, not every modification updates this timestamp. For example, BigQuery timestamps every metadata modification but not data or permission changes.",
          "format": "google-datetime",
          "type": "string"
        },
        "expireTime": {
          "format": "google-datetime",
          "description": "Output only. Expiration timestamp of the resource within the given system. Currently only applicable to BigQuery resources.",
          "type": "string",
          "readOnly": true
        }
      }
    },
    "GoogleCloudDatacatalogV1TaxonomyService": {
      "type": "object",
      "properties": {
        "identity": {
          "type": "string",
          "description": "The service agent for the service."
        },
        "name": {
          "type": "string",
          "enum": [
            "MANAGING_SYSTEM_UNSPECIFIED",
            "MANAGING_SYSTEM_DATAPLEX",
            "MANAGING_SYSTEM_OTHER"
          ],
          "description": "The Google Cloud service name."
        }
      },
      "description": "The source system of the Taxonomy."
    }
  }
}