# BrowseNodes

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

La risorsa BrowseNodes è strettamente associata all'operazione GetBrowseNodes. Restituisce i figli (Children) e la scala degli antenati (Ancestry ladder) associati ai BrowseNodeId richiesti. L'antenato e i figli restituiti contengono le informazioni Id, DisplayName e ContextFreeName.

Le informazioni sui browse node restituite come parte della risorsa `BrowseNodes` possono essere usate per:
* Ottenere informazioni sul BrowseNode come DisplayName, ContextFreeName, la sua scala degli antenati e i suoi figli.

## Disponibilità

Tutti i locale.

## Elementi di risposta

| Nome | 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. |
| Children | Elenco dei figli del BrowseNode per un particolare BrowseNode. Ogni figlio contiene le informazioni BrowseNodeId, DisplayName e ContextFreeName associate al figlio. Nota che un browse node foglia non ha figli. |
| 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. |

La struttura del contenitore BrowseNodes è la seguente:

```json
{
  "browseNodes": [
    {
      "ancestor": "Scala degli antenati del BrowseNode fino al nodo radice",
      "children": "Elenco dei figli del browse node richiesto",
      "contextFreeName": "Context Free Name del BrowseNode",
      "displayName": "Display Name del BrowseNode",
      "id": "L'ID del BrowseNode",
      "isRoot": "Indica se il BrowseNode è un nodo radice"
    }
  ]
}
```

## Operazioni pertinenti

Le operazioni che possono usare queste risorse includono:

* [GetBrowseNodes](../operations/get-browse-nodes.md)

## Risorse

Le informazioni Id, DisplayName, ContextFreeName e IsRoot sono restituite per impostazione predefinita per ogni richiesta `GetBrowseNodes`. Ancestor e Children sono restituiti solo quando le rispettive risorse sono richieste esplicitamente. Aggiungi il nome della risorsa nel payload della richiesta per ottenere i dati corrispondenti nella risposta.

| Nome | Descrizione |
| :--- | :--- |
| BrowseNodes.Ancestor | Ottiene la scala degli antenati associata a ciascuno dei browse node. Usando solo questa risorsa viene restituita la scala degli antenati insieme a Id, DisplayName, ContextFreeName e IsRoot di ciascun browse node. Vengono restituiti anche Id, DisplayName e ContextFreeName di ciascun antenato. |
| BrowseNodes.Children | Ottiene l'elenco dei figli associati al browse node richiesto. Usando solo questa risorsa viene restituito l'elenco dei figli con Id, DisplayName, ContextFreeName e IsRoot di ciascun browse node. Vengono restituiti anche Id, DisplayName e ContextFreeName di ciascun figlio. |

## Casi d'uso di esempio

### Esempio 1

Ottenere i figli di un BrowseNode:

#### Payload della richiesta

```json
{
   "partnerTag": "associate-tag-20",
   "browseNodeIds": ["283155"],
   "resources": ["BrowseNodes.Children"]
}
```

#### Risposta

```json
{
  "browseNodesResult": {
    "browseNodes": [
      {
        "children": [
          {
            "contextFreeName": "Subjects",
            "displayName": "Subjects",
            "id": "1000"
          },
          {
            "contextFreeName": "Books Featured Categories",
            "displayName": "Books Featured Categories",
            "id": "51546011"
          },
          {
            "contextFreeName": "Specialty Boutique",
            "displayName": "Specialty Boutique",
            "id": "2349030011"
          }
        ],
        "contextFreeName": "Books",
        "displayName": "Books",
        "id": "283155",
        "isRoot": true
      }
    ]
  }
}
```

### Esempio 2

Ottenere la scala degli antenati associata a un browse node.

#### Payload della richiesta

```json
{
   "partnerTag": "associate-tag-20",
   "browseNodeIds": ["4"],
   "resources": ["BrowseNodes.Ancestor"]
}
```

#### Risposta

```json
{
  "browseNodesResult": {
    "browseNodes": [
      {
        "id": "4",
        "displayName": "Children's Books",
        "contextFreeName": "Children's Books",
        "isRoot": false,
        "ancestor": {
          "id": "1000",
          "displayName": "Subjects",
          "contextFreeName": "Subjects",
          "ancestor": {
            "contextFreeName": "Books",
            "displayName": "Books",
            "id": "283155"
          }
        }
      }
    ]
  }
}
```
