Show Menu
トピック×

分類 API メソッド

Audience Manager の一般的な分類を表示するためのメソッド。このオプションの分類スキームでは、特性を業界標準のカテゴリに整理します。
これらのメソッドで新しい分類カテゴリを作成したり、特性を分類することはできません。特性を分類するには、特性の作成または更新メソッドで適切な categoryId を指定します。

特定の分類を返す

指定した分類カテゴリに関する詳細を返すための GET メソッド。

リクエスト

GET https://api.demdex.com/v1/taxonomies/0/ <categoryId>

応答

成功すると、 200 OK と、指定した ID のカテゴリが返されます。ID が存在せずリクエストが失敗した場合、 404 No Content が返されます。
{
    "crUID": 158,
    "name": "Arts & Entertainment",
    "upUID": 158,
    "description": "Arts & Entertainment",
    "categoryID": 1,
    "parentCategoryID": 0
}

すべての分類カテゴリを返す

トップレベルのカテゴリのリストを配列で返すための GET メソッド。

リクエスト

GET https://api.demdex.com/v1/taxonomies/0/

応答

簡潔になるよう一部省略されています。
[
    {
        "crUID": 158,
        "name": "Arts & Entertainment",
        "upUID": 158,
        "description": "Arts & Entertainment",
        "categoryID": 1,
        "parentCategoryID": 0
    },
    {
        "crUID": 158,
        "name": "Automotive",
        "upUID": 158,
        "description": "Automotive",
        "categoryID": 2,
        "parentCategoryID": 0
    },
    {
        "crUID": 158,
        "name": "Business",
        "upUID": 158,
        "description": "Business",
        "categoryID": 3,
        "parentCategoryID": 0
    }
]

分類サブカテゴリを返す

指定した親カテゴリのサブカテゴリを配列で返すための GET メソッド。

リクエスト

GET https://api.demdex.com/v1/taxonomies/0/ <categoryId> /childCategories/

応答

成功すると、 200 OK と、指定した ID のカテゴリが返されます。ID が存在せずリクエストが失敗した場合、 404 No Content が返されます。簡潔になるよう一部省略されています。
[
    {
        "crUID": 158,
        "name": "Books & Literature",
        "upUID": 158,
        "description": "Books & Literature",
        "categoryID": 25,
        "parentCategoryID": 1
    },
    {
        "crUID": 158,
        "name": "Celebrity Fan/Gossip",
        "upUID": 158,
        "description": "Celebrity Fan/Gossip",
        "categoryID": 49,
        "parentCategoryID": 1
    },
    {
        "crUID": 158,
        "name": "Fine Art",
        "upUID": 158,
        "description": "Fine Art",
        "categoryID": 72,
        "parentCategoryID": 1
    }
]