カテゴリ
Yahoo!カテゴリの構造
Yahoo!カテゴリWeb APIを利用するには、Yahoo!カテゴリの構造がどのように管理されているかをあらかじめ理解しておく必要があります。
カテゴリを特定する要素
Yahoo!カテゴリには、各カテゴリを特定する2つの要素があります。ひとつは「id」、もうひとつが「path」です。「id」は各カテゴリページに一意につけられた番号(数値)で、「path」は各カテゴリページを文字列で表現したものです。pathは、Yahoo!カテゴリではURLに使用され、例えば「http://dir.yahoo.co.jp/Health/Nutrition/」で表されるページの場合、このURLから「http://dir.yahoo.co.jp」を取り除いた「/Health/Nutrition/」がpathに相当します。
ディレクトリツリーAPIを呼び出す際には、「id」もしくは「path」のいずれかを指定します。両方が指定された場合には、「id」による呼び出しが有効となります。
ディレクトリサーチAPIでは、レスポンスとして、「id」および「path」が返されます。
カテゴリのツリー構造
Yahoo!カテゴリはツリー構造を持ち、最上位のノードは、id=2075000001、path="/"で特定されます。最上位のノード直下には、Yahoo!カテゴリの14分類に相当する14のノードがあります。すべてのカテゴリは、この14のノードのいずれかに所属しています。
Yahoo!カテゴリ内の要素
Yahoo!カテゴリには、登録サイトと、ツリーの下位階層カテゴリのデータが含まれています。また、カテゴリは、属性によって2つに分けられます。
指定されたカテゴリ直下のノードに存在するカテゴリ
Yahoo!カテゴリにおいては、
のアイコンで表されるカテゴリです。
指定されたカテゴリより下のノードに存在しないカテゴリ(「ショートカット」)
Yahoo!カテゴリにおいては、
のアイコンで表されるカテゴリで、「ショートカット」または「ショートカットカテゴリ」と呼ばれます。このカテゴリの実体は、指定されたカテゴリより下のノードには存在しません。このようなカテゴリは、指定されたカテゴリ内では、実体とは別(エイリアス)のidを持ち、そのidは実体となるカテゴリのidと関連付けられています。
例)
- http://dir.yahoo.co.jp/Entertainment/に表示されている、「
演劇」カテゴリ。 - エイリアスとしてのid=2075190738
- 実体(リンク先)のid=2075037428
登録サイトとして扱われたカテゴリ
企業名やタレント名などの名前がついたカテゴリは、Yahoo!カテゴリでは、登録サイトとして扱われます。このようなカテゴリは、Typeが「leaf」としてレスポンスが返されます。
登録サイトの特定方法
カテゴリ内に登録されたサイトに対しても、カテゴリ同様、一意の番号(数値)が与えられています。ディレクトリサーチAPIを利用し、登録サイトの検索を行った場合に、検索結果として返される登録サイトの情報に、この番号(「id」)が付加されます。