REST Resource: networks.taxonomyCategories
Stay organized with collections
Save and categorize content based on your preferences.
Resource: TaxonomyCategory
The TaxonomyCategory resource.
| JSON representation |
{
"name": string,
"ancestorNames": [
string
],
"ancestorTaxonomyCategoryIds": [
string
],
"taxonomyCategoryId": string,
"displayName": string,
"groupingOnly": boolean,
"parentTaxonomyCategoryId": string,
"taxonomyType": enum (TaxonomyType)
} |
| Fields |
name |
string
Identifier. The resource name of the TaxonomyCategory. Format: networks/{networkCode}/taxonomyCategories/{taxonomyCategoryId}
|
ancestorNames[] |
string
Output only. The list of names of the ancestors of this TaxonomyCategory.
|
ancestorTaxonomyCategoryIds[] |
string (int64 format)
Output only. The list of IDs of the ancestors of this TaxonomyCategory.
|
taxonomyCategoryId |
string (int64 format)
Output only. TaxonomyCategory ID.
|
displayName |
string
Output only. Display name of the TaxonomyCategory.
|
groupingOnly |
boolean
Output only. Whether this TaxonomyCategory only serves to group its children.
|
parentTaxonomyCategoryId |
string (int64 format)
Output only. The ID of the parent category this TaxonomyCategory descends from.
|
taxonomyType |
enum (TaxonomyType)
Output only. The taxonomy that this TaxonomyCategory belongs to.
|
TaxonomyType
The taxonomy type of the IAB defined taxonomies. Used for Publisher provided signals.
| Enums |
TAXONOMY_TYPE_UNSPECIFIED |
Unspecified/not present |
TAXONOMY_IAB_AUDIENCE_1_1 |
The IAB Audience Taxonomy v1.1. |
TAXONOMY_IAB_CONTENT_2_1 |
The IAB Content Taxonomy v2.1. |
TAXONOMY_IAB_CONTENT_2_2 |
The IAB Content Taxonomy v2.2. |
TAXONOMY_IAB_CONTENT_3_0 |
The IAB Content Taxonomy v3.0. |
TAXONOMY_GOOGLE_STRUCTURED_VIDEO_1_0 |
The PPS structured video signals taxonomy. |
Methods |
|
|
API to retrieve a TaxonomyCategory object. |
|
|
API to retrieve a list of TaxonomyCategory objects. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[null,null,["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThis documentation details the \u003ccode\u003eTaxonomyCategory\u003c/code\u003e resource in Google Ad Manager, including its JSON representation and available methods.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eTaxonomyCategory\u003c/code\u003e objects represent categories within a taxonomy, such as the IAB Content Taxonomy or Google Structured Video taxonomy, and include properties like display name, parent category, and ancestors.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use the provided API methods to retrieve individual \u003ccode\u003eTaxonomyCategory\u003c/code\u003e objects or lists of them.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eTaxonomyType\u003c/code\u003e defines the available taxonomy types, encompassing options like IAB Audience, IAB Content, and Google Structured Video.\u003c/p\u003e\n"]]],["The core content defines the `TaxonomyCategory` resource, detailing its structure and attributes. A `TaxonomyCategory` has properties like `name`, `taxonomyCategoryId`, `displayName`, and indicates if it's for grouping only. It also contains information about its parent and ancestors (`parentTaxonomyCategoryId`, `ancestorNames`, `ancestorTaxonomyCategoryIds`). The `taxonomyType` is defined by IAB taxonomies or Google structured video taxonomy. There are API methods available to `get` or `list` `TaxonomyCategory` objects.\n"],null,["# REST Resource: networks.taxonomyCategories\n\n- [Resource: TaxonomyCategory](#TaxonomyCategory)\n - [JSON representation](#TaxonomyCategory.SCHEMA_REPRESENTATION)\n- [TaxonomyType](#TaxonomyType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: TaxonomyCategory\n--------------------------\n\nThe `TaxonomyCategory` resource.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"ancestorNames\": [ string ], \"ancestorTaxonomyCategoryIds\": [ string ], \"taxonomyCategoryId\": string, \"displayName\": string, \"groupingOnly\": boolean, \"parentTaxonomyCategoryId\": string, \"taxonomyType\": enum (/ad-manager/api/beta/reference/rest/v1/networks.taxonomyCategories#TaxonomyType) } ``` |\n\n| Fields ||\n|---------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Identifier. The resource name of the `TaxonomyCategory`. Format: `networks/{networkCode}/taxonomyCategories/{taxonomyCategoryId}` |\n| `ancestorNames[]` | `string` Output only. The list of names of the ancestors of this `TaxonomyCategory`. |\n| `ancestorTaxonomyCategoryIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The list of IDs of the ancestors of this `TaxonomyCategory`. |\n| `taxonomyCategoryId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. `TaxonomyCategory` ID. |\n| `displayName` | `string` Output only. Display name of the `TaxonomyCategory`. |\n| `groupingOnly` | `boolean` Output only. Whether this `TaxonomyCategory` only serves to group its children. |\n| `parentTaxonomyCategoryId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The ID of the parent category this `TaxonomyCategory` descends from. |\n| `taxonomyType` | `enum (`[TaxonomyType](/ad-manager/api/beta/reference/rest/v1/networks.taxonomyCategories#TaxonomyType)`)` Output only. The taxonomy that this `TaxonomyCategory` belongs to. |\n\nTaxonomyType\n------------\n\nThe taxonomy type of the IAB defined taxonomies. Used for Publisher provided signals.\n\n| Enums ||\n|----------------------------------------|--------------------------------------------|\n| `TAXONOMY_TYPE_UNSPECIFIED` | Unspecified/not present |\n| `TAXONOMY_IAB_AUDIENCE_1_1` | The IAB Audience Taxonomy v1.1. |\n| `TAXONOMY_IAB_CONTENT_2_1` | The IAB Content Taxonomy v2.1. |\n| `TAXONOMY_IAB_CONTENT_2_2` | The IAB Content Taxonomy v2.2. |\n| `TAXONOMY_IAB_CONTENT_3_0` | The IAB Content Taxonomy v3.0. |\n| `TAXONOMY_GOOGLE_STRUCTURED_VIDEO_1_0` | The PPS structured video signals taxonomy. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------------|-------------------------------------------------------|\n| ### [get](/ad-manager/api/beta/reference/rest/v1/networks.taxonomyCategories/get) | API to retrieve a `TaxonomyCategory` object. |\n| ### [list](/ad-manager/api/beta/reference/rest/v1/networks.taxonomyCategories/list) | API to retrieve a list of `TaxonomyCategory` objects. |"]]
