Taxonomy
  • 1 Minute to read

    Taxonomy


      Article summary

      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:

      1. 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.

      2. 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.

      3. GET /taxonomy: Use this API to fetch the currently active version. It also supports API to fetch a list of previously uploaded taxonomy metadata.

      4. 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

      Metadata

      Structure descriptions

      Taxonomy Representation

      Taxonomy JSON layouts

      POST /Upload New Taxonomy

      Create or refresh taxonomy nodes

      PUT /Append Taxonomy Node

      Update taxonomy data

      PUT /Replace Taxonomy Node

      Replace existing taxonomy nodes

      PUT /Move Node

      Move existing taxonomy nodes

      Delete Taxonomy Node

      Delete existing taxonomy nodes

      Get Taxonomy

      Retrieve latest taxonomy version

      Error Codes

      Taxonomy errors and descriptions


      Was this article helpful?

      What's Next