REST Resource: networks.taxonomyCategories

  • This documentation details the TaxonomyCategory resource in Google Ad Manager, including its JSON representation and available methods.

  • TaxonomyCategory 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.

  • Developers can use the provided API methods to retrieve individual TaxonomyCategory objects or lists of them.

  • TaxonomyType defines the available taxonomy types, encompassing options like IAB Audience, IAB Content, and Google Structured Video.

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

get

 API to retrieve a TaxonomyCategory object.

list

 API to retrieve a list of TaxonomyCategory objects.