# BrowseNodeInfo

> **Traduzione italiana non ufficiale.** Originale: [BrowseNodeInfo](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/api-reference/resources/browse-node-info) · [sorgente EN](../../../en/api-reference/resources/browse-node-info.md) · [indice](../../../README.md)

La risorsa BrowseNodeInfo, in qualsiasi operazione su articoli, restituisce i BrowseNode sotto cui rientra l'articolo e la genealogia di quel browse node. I browse node restituiti contengono diverse proprietà come Id, DisplayName, ContextFreeName, Ancestor e IsRoot.
Le informazioni sui browse node restituite come parte della risorsa `BrowseNodeInfo` possono essere ulteriormente utilizzate per:
* Effettuare una richiesta di ricerca mirata a un browse node usando l'[operazione SearchItems](../operations/search-items.md), fornendo il BrowseNodeId desiderato.

## Disponibilità

Tutti i locale.

## Elementi di risposta

| Nome | Descrizione |
| :--- | :--- |
| BrowseNodes | Contenitore dei BrowseNode associati all'articolo. Include le informazioni BrowseNodeId, DisplayName, ContextFreeName, Ancestor, IsRoot e SalesRank. Per maggiori informazioni, vedi [Elemento di risposta BrowseNodes](#elemento-di-risposta-browsenodes) |
| WebsiteSalesRank | Contenitore del Website Sales Rank associato a un prodotto. Include le informazioni DisplayName, ContextFreeName e SalesRank. Per maggiori informazioni, vedi [Elemento di risposta WebsiteSalesRank](#elemento-di-risposta-websitesalesrank) |

Ecco come gli elementi di risposta della risorsa BrowseNodeInfo si mappano sulle informazioni disponibili nella pagina di dettaglio di Amazon:

![Mappatura di BrowseNodeInfo sulla pagina di dettaglio Amazon](../../../assets/images/browsenodeinfo.png)

* La riga più in alto che indica **Amazon Best Sellers Rank** si mappa sull'[elemento di risposta WebsiteSalesRank](#elemento-di-risposta-websitesalesrank).
  * WebsiteSalesRank è il sales rank dell'articolo nel browse node di livello più alto o radice.
  * Nota che non tutti gli articoli hanno informazioni di sales rank di livello più alto disponibili, quindi BrowseNodeInfo potrebbe non contenere le informazioni WebsiteSalesRank per tutti gli articoli.
* Tutti gli altri browse node nello snapshot si mappano sull'[elemento di risposta BrowseNodes](#elemento-di-risposta-browsenodes).
  * Ciascuno di questi browse node ha un rank associato. Questo rank è restituito nell'elemento `SalesRank` all'interno di `BrowseNodes` e indica il rank di vendita dell'articolo in quel particolare browse node.
  * Nota che il numero di browse node restituiti per un articolo è di solito maggiore del numero di browse node per cui è presente l'informazione di sales rank. Questo perché Amazon mostra solo i *sales rank altamente rilevanti* (cioè i primi).

#### Elemento di risposta BrowseNodes

La struttura del contenitore BrowseNodes all'interno della risorsa di alto livello BrowseNodeInfo è la seguente:

```json
{
  "browseNodes": [
    {
      "ancestor": "Scala degli antenati del BrowseNode fino al nodo radice",
      "contextFreeName": "Context Free Name del BrowseNode",
      "displayName": "Display Name del BrowseNode",
      "id": "L'ID del BrowseNode",
      "isRoot": "Indica se il BrowseNode è un nodo radice",
      "salesRank": "Il sales rank dell'articolo associato al BrowseNode"
    }
  ]
}
```

Consulta la tabella seguente per maggiori informazioni su ciascun elemento di risposta di `BrowseNodes`:

| Elemento di risposta | Descrizione |
| :--- | :--- |
| Ancestor | Contenitore delle informazioni sugli antenati del BrowseNode, che include BrowseNodeId, DisplayName, ContextFreeName e le informazioni sull'antenato, se esiste. Il contenitore è una scala che contiene le informazioni sugli antenati fino al browse node radice. Cioè, l'ultimo nodo nella scala sarà il nodo radice. Nota che un BrowseNode radice non ha antenati. |
| ContextFreeName | Indica un nome visualizzabile per un BrowseNode completamente indipendente dal contesto. Per esempio, il *DisplayName* di `BrowseNodeId: 3060` nel marketplace USA è ***Orphans & Foster Homes***. Non si può dedurre a quale categoria radice appartenga senza la scala degli antenati, cioè richiede un "contesto" per essere intuitivo. Tuttavia, il *ContextFreeName* di questo browse node è ***Children's Orphans & Foster Homes Books***. Nota che, per un BrowseNode il cui DisplayName è già indipendente dal contesto, il ContextFreeName coincide con il DisplayName. |
| DisplayName | Il nome visualizzato del BrowseNode così come appare sul sito retail di Amazon. |
| Id | Indica l'identificatore univoco del BrowseNode. |
| IsRoot | Indica se il BrowseNode corrente è una categoria radice. |
| SalesRank | Sales rank dell'articolo associato al browse node. |

> [!NOTE]
> Ciascuno di questi browse node ha un sales rank associato, che indica il rank di vendita dell'articolo in quel particolare browse node. Nota che il numero di browse node restituiti per un articolo è di solito maggiore del numero di browse node per cui è presente l'informazione di sales rank. Questo perché Amazon mostra solo i *sales rank altamente rilevanti* (cioè i primi).

#### Elemento di risposta WebsiteSalesRank

La struttura del contenitore `WebsiteSalesRank` all'interno della risorsa di alto livello `BrowseNodeInfo` è la seguente:

```json
{
  "websiteSalesRank": {
    "contextFreeName": "Context Free Name del BrowseNode",
    "displayName": "Display Name del BrowseNode",
    "salesRank": "Il website sales rank dell'articolo"
  }
}
```

> [!NOTE]
> Nota che non tutti gli articoli hanno informazioni di sales rank di livello più alto disponibili, quindi BrowseNodeInfo potrebbe non contenere le informazioni WebsiteSalesRank per tutti gli articoli.

## Operazioni pertinenti

Le operazioni che possono usare queste risorse includono:

* [GetItems](../operations/get-items.md)
* [GetVariations](../operations/get-variations.md)
* [SearchItems](../operations/search-items.md)

## Risorse

Aggiungi il nome della risorsa nel payload della richiesta per ottenere i dati corrispondenti nella risposta.

| Nome | Descrizione |
|:---| :--- |
| browseNodeInfo.browseNodes | Ottiene i browse node associati all'articolo. Usando solo questa risorsa vengono restituite le informazioni Id, DisplayName, ContextFreeName e IsRoot di ciascun browse node. |
| browseNodeInfo.browseNodes.ancestor | Ottiene la scala degli antenati associata a ciascuno dei browse node sotto cui rientra l'articolo. Usando solo questa risorsa viene restituita la scala degli antenati insieme a Id, DisplayName, ContextFreeName e IsRoot di ciascun browse node. |
| browseNodeInfo.browseNodes.salesRank | Ottiene le informazioni SalesRank per ciascuno dei browse node sotto cui rientra l'articolo. Usando solo questa risorsa viene restituito il sales rank insieme a Id, DisplayName, ContextFreeName e IsRoot di ciascun browse node. |
| browseNodeInfo.websiteSalesRank | Ottiene le informazioni WebsiteSalesRank associate all'articolo. Usando solo questa risorsa viene restituito il [contenitore WebsiteSalesRank](#elemento-di-risposta-websitesalesrank) per l'articolo. |

### BrowseNodeInfo BrowseNodes

Richiedere questa risorsa restituisce i browse node associati all'articolo. Per ciascuno vengono restituite le informazioni Id, DisplayName, ContextFreeName e IsRoot.

#### Risposta di esempio

Lo snippet seguente presuppone una richiesta [GetItems](../operations/get-items.md) per l'ItemId `059035342X`.

```json
{
  "itemsResult": {
    "items": [
      {
        "asin": "059035342X",
        "browseNodeInfo": {
          "browseNodes": [
            { "id": "3060", "displayName": "Orphans & Foster Homes", "contextFreeName": "Children's Orphans & Foster Homes Books", "isRoot": false },
            { "id": "3153", "displayName": "Friendship", "contextFreeName": "Children's Friendship Books", "isRoot": false },
            { "id": "15356791", "displayName": "School", "contextFreeName": "Children's School Issues", "isRoot": false }
          ]
        }
      }
    ]
  }
}
```

### BrowseNodeInfo.browseNodes.ancestor

Richiedere questa risorsa restituisce la scala degli antenati insieme a Id, DisplayName, ContextFreeName e IsRoot di ciascun browse node.

#### Risposta di esempio

Lo snippet seguente presuppone una richiesta [GetItems](../operations/get-items.md) per l'ItemId `059035342X`. Ogni browse node include un contenitore `ancestor` annidato che risale fino al nodo radice `Books` (283155). Di seguito il primo browse node come esempio; gli altri hanno la stessa struttura. Vedi il [sorgente EN](../../../en/api-reference/resources/browse-node-info.md) per il payload completo.

```json
{
  "itemsResult": {
    "items": [
      {
        "asin": "059035342X",
        "browseNodeInfo": {
          "browseNodes": [
            {
              "id": "3060",
              "displayName": "Orphans & Foster Homes",
              "contextFreeName": "Children's Orphans & Foster Homes Books",
              "isRoot": false,
              "ancestor": {
                "id": "3045",
                "displayName": "Family Life",
                "contextFreeName": "Children's Family Life Books",
                "ancestor": {
                  "id": "1084192",
                  "displayName": "Growing Up & Facts of Life",
                  "contextFreeName": "Children's Growing Up & Facts of Life Books",
                  "ancestor": {
                    "id": "4",
                    "displayName": "Children's Books",
                    "contextFreeName": "Children's Books",
                    "ancestor": {
                      "id": "1000",
                      "displayName": "Subjects",
                      "contextFreeName": "Subjects",
                      "ancestor": {
                        "id": "283155",
                        "displayName": "Books",
                        "contextFreeName": "Books"
                      }
                    }
                  }
                }
              }
            }
          ]
        }
      }
    ]
  }
}
```

### BrowseNodeInfo.browseNodes.salesRank

Richiedere questa risorsa restituisce le informazioni di sales rank insieme a Id, DisplayName, ContextFreeName e IsRoot di ciascun browse node.

#### Risposta di esempio

Lo snippet seguente presuppone una richiesta [GetItems](../operations/get-items.md) per l'ItemId `059035342X`.

```json
{
  "itemsResult": {
    "items": [
      {
        "asin": "059035342X",
        "browseNodeInfo": {
          "browseNodes": [
            { "id": "3060", "displayName": "Orphans & Foster Homes", "contextFreeName": "Children's Orphans & Foster Homes Books", "isRoot": false, "salesRank": 2 },
            { "id": "3153", "displayName": "Friendship", "contextFreeName": "Children's Friendship Books", "isRoot": false, "salesRank": 4 },
            { "id": "15356791", "displayName": "School", "contextFreeName": "Children's School Issues", "isRoot": false, "salesRank": 15 }
          ]
        }
      }
    ]
  }
}
```

### BrowseNodeInfo.websiteSalesRank

Richiedere questa risorsa restituisce le informazioni di website sales rank associate all'articolo.

#### Risposta di esempio

```json
{
  "itemsResult": {
    "items": [
      {
        "asin": "059035342X",
        "browseNodeInfo": {
          "websiteSalesRank": {
            "displayName": "Books",
            "contextFreeName": "Books",
            "salesRank": 197
          }
        }
      }
    ]
  }
}
```

## Casi d'uso di esempio

### Esempio 1

Ottenere il WebsiteSalesRank di un articolo:

#### Payload della richiesta

```json
{
        "itemIds": ["059035342X"],
        "itemIdType": "ASIN",
        "marketplace": "www.amazon.com",
        "partnerTag": "associate-tag-20",
        "resources": ["browseNodeInfo.websiteSalesRank"]
}
```

#### Risposta

```json
{
  "itemsResult": {
    "items": [
      {
        "asin": "059035342X",
        "browseNodeInfo": {
          "websiteSalesRank": { "displayName": "Books", "contextFreeName": "Books", "salesRank": 197 }
        },
        "detailPageURL": "https://www.amazon.com/dp/059035342X?tag=associate-tag-20&linkCode=ogi&th=1&psc=1"
      }
    ]
  }
}
```

### Esempio 2

Ottenere tutti i BrowseNode associati all'articolo senza le informazioni di genealogia e di sales rank.

#### Payload della richiesta

```json
{
        "itemIds": ["059035342X"],
        "itemIdType": "ASIN",
        "marketplace": "www.amazon.com",
        "partnerTag": "associate-tag-20",
        "resources": ["browseNodeInfo.browseNodes"]
}
```

#### Risposta

```json
{
  "itemsResult": {
    "items": [
      {
        "asin": "059035342X",
        "browseNodeInfo": {
          "browseNodes": [
            { "id": "3060", "displayName": "Orphans & Foster Homes", "contextFreeName": "Children's Orphans & Foster Homes Books", "isRoot": false },
            { "id": "3153", "displayName": "Friendship", "contextFreeName": "Children's Friendship Books", "isRoot": false },
            { "id": "15356791", "displayName": "School", "contextFreeName": "Children's School Issues", "isRoot": false }
          ]
        },
        "detailPageURL": "https://www.amazon.com/dp/059035342X?tag=associate-tag-20&linkCode=ogi&th=1&psc=1"
      }
    ]
  }
}
```

### Esempio 3

Ottenere tutte le informazioni BrowseNodeInfo per un articolo, combinando `browseNodes`, `browseNodes.ancestor`, `browseNodes.salesRank` e `websiteSalesRank`.

#### Payload della richiesta

```json
{
        "itemIds": ["059035342X"],
        "itemIdType": "ASIN",
        "marketplace": "www.amazon.com",
        "partnerTag": "associate-tag-20",
        "resources": ["browseNodeInfo.browseNodes", "browseNodeInfo.browseNodes.ancestor", "browseNodeInfo.browseNodes.salesRank", "browseNodeInfo.websiteSalesRank"]
}
```

#### Risposta

La risposta combina `websiteSalesRank` e, per ogni browse node, i campi `salesRank` e la scala `ancestor` completa (come mostrato nella sezione [browseNodes.ancestor](#browsenodeinfobrowsenodesancestor) sopra). Vedi il [sorgente EN](../../../en/api-reference/resources/browse-node-info.md) per il payload completo di questo esempio.
