# GetBrowseNodes

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

## Descrizione

Dato un BrowseNodeId, l'operazione `GetBrowseNodes` restituisce le informazioni del browse node specificato, come nome, figli e antenati, a seconda delle risorse indicate nella richiesta. Vengono restituiti anche i nomi e i browse node ID dei browse node figli e antenati. GetBrowseNodes ti permette di percorrere la gerarchia dei browse node per trovare un browse node.

L'operazione GetBrowseNodes restituisce per impostazione predefinita gli elementi di risposta Id, DisplayName, ContextFreeName e SalesRank. Per gli altri elementi di risposta associati, GetBrowseNodes supporta la seguente risorsa di alto livello:

* [BrowseNodes](../resources/browse-nodes.md)

## Disponibilità

Tutti i locale.

## Parametri della richiesta

Consulta [Header e parametri comuni di richiesta](../../concepts/common-request-headers-and-parameters.md) per maggiori informazioni sui parametri di input comuni. Per informazioni dettagliate su come creare e inviare una richiesta, vedi [Usare cURL](../../get-started/using-curl.md). Tutti i parametri di input di GetBrowseNodes sono elencati di seguito:

| Nome | Descrizione | Obbligatorio |
| :--- | :--- | :--- |
| browseNodeIds | Elenco di BrowseNodeId. Un BrowseNodeId è un ID univoco assegnato da Amazon che identifica una categoria/sottocategoria di prodotto. Il BrowseNodeId è un Long positivo con valore massimo fino a Long.MAX_VALUE, cioè 9223372036854775807 (incluso). <ul><li>Tipo: *elenco di stringhe (solo Long positivi) (fino a 10)*</li><li>Valore predefinito: nessuno</li><li>Uso: `{"browseNodeIds": ["3040", "3045"]}`</li></ul> | Sì |
| languagesOfPreference | Lingue preferite in cui restituire le informazioni nella risposta. Per impostazione predefinita le informazioni sono restituite nella lingua predefinita del marketplace. Il formato locale atteso è il codice lingua ISO 639 seguito da underscore seguito dal codice paese ISO 3166 (es. en_US, fr_CA, ecc.). Per informazioni sulla lingua predefinita e sulle lingue valide di un marketplace, vedi [Riferimento dei locale](../../locale-reference.md). Attualmente è supportata una sola lingua preferita. <ul><li>Tipo: *elenco di stringhe (non vuoto)*</li><li>Valore predefinito: nessuno</li><li>Uso: `{"languagesOfPreference":["en_US"]}`</li></ul> | No |
| marketplace | Locale Amazon di destinazione. Per maggiori informazioni, vedi [Header e parametri comuni di richiesta](../../concepts/common-request-headers-and-parameters.md). <ul><li>Tipo: *stringa*</li><li>Valore predefinito: nessuno</li><li>Uso: `{"marketplace":"www.amazon.com"}`</li></ul> | No |
| partnerTag | ID univoco di un partner. Per maggiori informazioni, vedi [Header e parametri comuni di richiesta](../../concepts/common-request-headers-and-parameters.md). <ul><li>Tipo: *stringa (non vuota)*</li><li>Valore predefinito: nessuno</li><li>Uso: `{"partnerTag":"xyz-20"}`</li></ul> | Sì |
| resources | Specifica i tipi di valori da restituire. Puoi specificare più risorse in una sola richiesta. Per l'elenco delle risorse valide per l'operazione GetBrowseNodes, vedi [Parametro Resources](#parametro-resources). <ul><li>Tipo: *elenco di stringhe*</li><li>Valore predefinito: `itemInfo.title`</li><li>Uso: `{"resources":["browseNodes.ancestor", "browseNodes.children"]}`</li></ul> | No |

#### Parametro Resources

| Valore della risorsa | Descrizione |
| :--- | :--- |
| browseNodes.ancestor | Restituisce la scala degli antenati del BrowseNodeId richiesto fino al nodo radice, ovvero l'ultimo browse node nella scala degli antenati sarà il nodo radice. Per maggiori informazioni, vedi [Risorsa BrowseNodes](../resources/browse-nodes.md) |
| browseNodes.children | Restituisce l'elenco dei figli del BrowseNodeId richiesto. Per maggiori informazioni, vedi [Risorsa BrowseNodes](../resources/browse-nodes.md) |

## Elementi di risposta

Di seguito gli elementi di risposta comuni restituiti:

| Nome | Descrizione |
| :--- | :--- |
| errors | Array opzionale di oggetti errore per i browse node che non hanno superato la validazione o il lookup. Presente solo quando si verificano fallimenti parziali. |
| browseNodesResult | Il contenitore della risposta di GetBrowseNodes. Contiene i BrowseNode risultanti per la richiesta GetBrowseNodes. |
| browseNodes | Contenitore delle informazioni sul BrowseNode, che include BrowseNodeId, Name, Ancestor, Children, SalesRank associato, ecc. |
| 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 del BrowseNode 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 questo browse node 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. |

> [!NOTE]
> Quando i BrowseNodeId richiesti non sono validi, compariranno nel contenitore Errors della GetBrowseNodesResponse. Di conseguenza, l'ordine dei BrowseNodeId nella risposta può cambiare. È quindi consigliato recuperare le informazioni del BrowseNodeId richiesto controllando il valore Id del BrowseNode.

## Casi d'uso di esempio

### Esempio 1

Ottenere tutte le informazioni dei browse node per un elenco di browse node validi.

#### Payload della richiesta

```json
{
   "partnerTag": "xyz-20",
   "browseNodeIds": ["283155", "3040"],
   "resources": ["browseNodes.ancestor", "browseNodes.children"]
}
```

#### Risposta

```json
{
  "browseNodesResult": {
    "browseNodes": [
      {
        "ancestor": {
          "ancestor": {
            "ancestor": {
              "ancestor": {
                "ancestor": {
                  "contextFreeName": "Books",
                  "displayName": "Books",
                  "id": "283155"
                },
                "contextFreeName": "Subjects",
                "displayName": "Subjects",
                "id": "1000"
              },
              "contextFreeName": "Children's Books",
              "displayName": "Children's Books",
              "id": "4"
            },
            "contextFreeName": "Children's Geography & Cultures Books",
            "displayName": "Geography & Cultures",
            "id": "3344091011"
          },
          "contextFreeName": "Children's Explore the World Books",
          "displayName": "Explore the World",
          "id": "3023"
        },
        "contextFreeName": "Children's Mexico Books",
        "displayName": "Mexico",
        "id": "3040",
        "isRoot": false
      },
      {
        "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

Caso d'uso in cui l'elenco di `browseNodeIds` contiene un browse node id non valido.

#### Payload della richiesta

```json
{
   "partnerTag": "xyz-20",
   "browseNodeIds": ["283155", "0"],
   "resources": ["browseNodes.ancestor", "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
      }
    ]
  },
  "errors": [
    {
      "code": "InvalidParameterValue",
      "message": "The BrowseNodeId 0 provided in the request is invalid."
    }
  ]
}
```
