Taxonomy¶
Abstract¶
Taxonomy helps Yahoo import the hierarchical (or flat) organization of its partners’ data and its associated metadata. Uploading taxonomy is a prerequisite for uploading user/audience data.
Important
A partner must maintain a Taxonomy for its entire data set across all segments and attributes for the data that it provides through DataX.
Methods to Manage Taxonomy¶
DataX exposes these methods for managing Taxonomy:
POST /taxonomy: Use this API to create a new version of your Yahoo taxonomy. If successful, the new taxonomy replaces and supercedes the currently active taxonomy.
PUT /taxonomy: Use this API to send incremental taxonomy data that would be merged with the currently active taxonomy. It supports options to insert, replace, move taxonomy nodes and its sub-tree to an existing taxonomy.
GET /taxonomy: Use this API to fetch the currently active version. It also supports API to fetch a list of previously uploaded taxonomy metadata.
Delete /taxonomy: Use this API to delete taxonomy node/s and its sub-tree from currently active taxonomy.
Topics to Navigate¶
Explore these topics to better under Taxonomy JSON layouts and methods.
Topic |
Description |
---|---|
Structure descriptions |
|
Taxonomy JSON layouts |
|
Create or refresh taxonomy nodes |
|
Update taxonomy data |
|
Replace existing taxonomy nodes |
|
Move existing taxonomy nodes |
|
Delete existing taxonomy nodes |
|
Retrieve latest taxonomy version |
|
Taxonomy errors and descriptions |