ブラウズノードの検索

Product Advertising API では、次の方法でブラウズノードIDを知ることができます。

BrowseNodes レスポンスグループは、商品が属するブラウズノードと、そのブラウズノードの親を返します。次のレスポンスでは、High School の上位のブラウズノードを示しています。このレスポンスでは、ブラウズノード階層が下から上に向かって記述されています。レスポンス内の最後のブラウズノードである "Books"はルートブラウズノードです。

<Item>
  <ASIN>0976925524</ASIN> 
  <BrowseNodes>
    <BrowseNode>
      <BrowseNodeId>69825</BrowseNodeId> 
      <Name>High School</Name> 
      <Ancestors>
        <BrowseNode>
          <BrowseNodeId>10605</BrowseNodeId> 
          <Name>Education</Name> 
          <Ancestors>
            <BrowseNode>
            <BrowseNodeId>53</BrowseNodeId> 
            <Name>Nonfiction</Name> 
            <Ancestors>
              <BrowseNode>
              <BrowseNodeId>1000</BrowseNodeId> 
              <Name>Subjects</Name> 
              <Ancestors>
                <BrowseNode>
                <BrowseNodeId>283155</BrowseNodeId> 
                <Name>Books</Name>

ただし、1つだけ注意があります。ノードに複数の親ノードがある場合、BrowseNodes レスポンスグループでは1つの親ノードしか返しません。ツリー上のどの親ノードをさかのぼるのかを決めるロジックはありません。そのため、リクエストを複数回実行することで、1つのノードに対して異なる親ノードが返される可能性があります。

BrowseNodes レスポンスグループは、 ItemLookup, ItemSearch, ListLookup, および SimilarityLookupで使用できます。

次のレスポンス例に示すように、 BrowseNodeInfo レスポンスグループは、次のブラウズノード名、ID、子と親のブラウズノードを返します。

<BrowseNodeId>11232</BrowseNodeId>
<Name> Social Sciences</Name>
<Ancestors>
  <BrowseNode>
    <BrowseNodeId>53</BrowseNodeId>
    <Name>Nonfiction</Name>
    <Ancestors>
      <BrowseNode>
        <BrowseNodeId>1000</BrowseNodeId>
        <Name>Subjects</Name>
        <Ancestors>
          <BrowseNode>
            <BrowseNodeId>283155</BrowseNodeId>
            <Name>Books</Name>
          </BrowseNode>
        </Ancestors>
      </BrowseNode>
    </Ancestors>
  </BrowseNode>
</Ancestors>
<Children>
  <BrowseNode>
    <BrowseNodeId>11233</BrowseNodeId> 
    <Name>Anthropology</Name> 
  </BrowseNode>
  <BrowseNode>
    <BrowseNodeId>11242</BrowseNodeId> 
    <Name>Archaeology</Name> 
  </BrowseNode>
  <BrowseNode>
    <BrowseNodeId>3048861</BrowseNodeId> 
    <Name>Children's Studies</Name> 
  </BrowseNode>
</Children>

このレスポンスは、Social Sciencesブラウズノードに、Anthropology、Archaeology、Children's Studies の3つの子ブラウズノードがある、ブラウズノードNonfiction で始まる親ノードがあり、ルートブラウズノード Books で終わることを示しています。

このレスポンスグループは、 BrowseNodeLookupだけで使用できます。一般に、ブラウズノードツリーを検索するには BrowseNodeLookup を使用します。全てのレスポンスで、返されたブラウズノードIDを使用して、目的のブラウズノードに到達するまで検索を調整できます。例えば、ツリーを下にたどって検索を絞り込んだり、ルートブラウズノードを使用して、対象の製品カテゴリー内のベストセラーを返したりできます。そのためには、BrowseNodeInfoレスポンス中のルートブラウズノードのIDを、BrowseNode パラメータの値として ItemSearch リクエストで使用します。対象の製品カテゴリーのベストセラーが返されるように、リクエストにはTopSellersレスポンスグループを含めます。

注意:ブラウズノードに複数の親ノードがある場合、そのうちの1つしかレスポンスで返されません。

これに対し、 BrowseNodeLookup は、リクエストで指定されたブラウズノードの直接の子ブラウズノードだけを返します。いずれかのブラウズノードIDを使用し、 BrowseNodeLookup リクエストを使用して追加の関連ブラウズノードを検索するか ItemSearch リクエストを絞り込むことができます。

ItemSearch および ItemLookup を使用し、BrowseNodesレスポンスグループを指定します。

必要なブラウズノードIDに類似したブラウズノードIDを検索し、 BrowseNodeLookup を使用してその子および親のブラウズノードに移動します。