# GetItems

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

## Descrizione

Dato un identificatore di articolo, l'operazione `GetItems` restituisce alcuni o tutti gli attributi dell'articolo, a seconda delle risorse specificate nella richiesta.

`GetItems` supporta le seguenti risorse di alto livello:

* [BrowseNodeInfo](../resources/browse-node-info.md)
* [Images](../resources/images.md)
* [ItemInfo](../resources/item-info.md)
* [OffersV2](../resources/offersV2.md)

Per cercare più di un articolo alla volta, separa gli identificatori con virgole.

## Disponibilità

Tutti i locale; tuttavia il supporto dei parametri varia in base al 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 `GetItems` sono elencati di seguito:

| Nome | Descrizione | Obbligatorio |
| :--- | :--- | :--- |
| condition | Il parametro condition filtra le offerte per tipo di condizione. Per esempio, `Condition:New` restituisce gli articoli che hanno almeno un'offerta di tipo New. Per maggiori informazioni e valori validi, vedi [Parametro Condition](#parametro-condition). <ul><li>Tipo: *stringa*</li><li>Valore predefinito: `Any`</li><li>Uso: `{"condition":"New"}`</li></ul> | No |
| currencyOfPreference | Valuta preferita in cui restituire le informazioni sui prezzi nella risposta. Per impostazione predefinita i prezzi sono restituiti nella valuta predefinita del marketplace. Il formato del codice valuta atteso è il codice ISO 4217 (es. USD, EUR, ecc.). Per informazioni sulla valuta predefinita e sulle valute valide di un marketplace, vedi [Riferimento dei locale](../../locale-reference.md). <ul><li>Tipo: *stringa (non vuota)*</li><li>Valore predefinito: nessuno</li><li>Uso: `{"currencyOfPreference":"USD"}`</li></ul> | No |
| itemIdType | Tipo di identificatore usato per cercare un articolo. Per maggiori informazioni sui valori validi, vedi [Parametro ItemIdType](#parametro-itemidtype). <ul><li>Tipo: *stringa*</li><li>Valore predefinito: `ASIN`</li><li>Uso: `{"itemIdType":"ASIN"}`</li></ul> | No |
| itemIds | Uno o più ItemId (come l'ASIN) che identificano univocamente un articolo. Il significato del valore è specificato da `itemIdType`. Cioè, se `itemIdType` è ASIN, il valore di `itemId` è un ASIN. <ul><li>Tipo: *elenco di stringhe non vuote (fino a 10)*</li><li>Valore predefinito: nessuno</li><li>Uso: `"itemIds" : ["B0199980K4" , "B000HZD168"]`</li></ul> | Sì |
| languagesOfPreference | Lingue, in ordine di preferenza, in cui restituire le informazioni dell'articolo 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_ES"]}`</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 GetItems, vedi [Parametro Resources](#parametro-resources). <ul><li>Tipo: *elenco di stringhe*</li><li>Valore predefinito: `["itemInfo.title"]`</li><li>Uso: `"resources" : [ "images.primary.small", "itemInfo.productInfo"]`</li></ul> | No |

#### Parametro Condition

Nota che una richiesta `GetItems` con un particolare parametro Condition può restituire 0 offerte se non ci sono offerte con la condizione specificata.

| Valore Condition | Descrizione |
| :--- | :--- |
| Any | Listini di offerte per articoli in qualsiasi condizione. Include New e Used. |
| New | Listini di offerte per articoli New (nuovi) |

#### Parametro ItemIdType

| Valore ItemIdType | Descrizione |
| :--- | :--- |
| ASIN | Amazon Standard Identification Number: identificatore univoco alfanumerico di 10 caratteri assegnato da Amazon. Per maggiori dettagli, vedi [ASIN](https://en.wikipedia.org/wiki/Amazon_Standard_Identification_Number) |

#### Parametro Resources

| Valore della risorsa | Descrizione |
|:---|:---|
| browseNodeInfo.browseNodes | Ottiene i browse node associati all'articolo. Usando solo questa risorsa vengono restituite le informazioni Id, DisplayName, ContextFreeName e IsRoot associate a ciascun browse node. Per maggiori informazioni, vedi [Risorsa BrowseNodeInfo](../resources/browse-node-info.md). |
| browseNodeInfo.browseNodes.ancestor | Ottiene la scala degli antenati associata a ciascuno dei browse node sotto cui rientra l'articolo. Usando questa risorsa viene restituita la scala degli antenati insieme a Id, DisplayName, ContextFreeName e IsRoot di ciascun browse node. Per maggiori informazioni, vedi [Risorsa BrowseNodeInfo](../resources/browse-node-info.md). |
| browseNodeInfo.browseNodes.salesRank | Ottiene le informazioni SalesRank per ciascuno dei browse node sotto cui rientra l'articolo. Usando questa risorsa viene restituito il sales rank insieme a Id, DisplayName, ContextFreeName e IsRoot di ciascun browse node. Per maggiori informazioni, vedi [Risorsa BrowseNodeInfo](../resources/browse-node-info.md). |
| browseNodeInfo.websiteSalesRank | Ottiene le informazioni WebsiteSalesRank associate all'articolo. Per maggiori informazioni, vedi [Risorsa BrowseNodeInfo](../resources/browse-node-info.md). |
| images.primary.small | Restituisce l'immagine principale in formato piccolo per ciascun articolo. Per maggiori informazioni, vedi [Risorsa Images](../resources/images.md) |
| images.primary.medium | Restituisce l'immagine principale in formato medio per ciascun articolo. Per maggiori informazioni, vedi [Risorsa Images](../resources/images.md) |
| images.primary.large | Restituisce l'immagine principale in formato grande per ciascun articolo. Per maggiori informazioni, vedi [Risorsa Images](../resources/images.md) |
| images.variants.small | Restituisce le immagini delle varianti in formato piccolo per ciascun articolo. Per maggiori informazioni, vedi [Risorsa Images](../resources/images.md) |
| images.variants.medium | Restituisce le immagini delle varianti in formato medio per ciascun articolo. Per maggiori informazioni, vedi [Risorsa Images](../resources/images.md) |
| images.variants.large | Restituisce le immagini delle varianti in formato grande per ciascun articolo. Per maggiori informazioni, vedi [Risorsa Images](../resources/images.md) |
| itemInfo.byLineInfo | Restituisce l'insieme di attributi che specifica le informazioni di base dell'articolo. Per maggiori informazioni, vedi [Risorsa ItemInfo](../resources/item-info.md) |
| itemInfo.classifications | Restituisce l'insieme di attributi usati per classificare un articolo in una particolare categoria. Per maggiori informazioni, vedi [Risorsa ItemInfo](../resources/item-info.md) |
| itemInfo.contentInfo | Restituisce l'insieme di attributi specifici del contenuto, come libri, film, ecc. Per maggiori informazioni, vedi [Risorsa ItemInfo](../resources/item-info.md) |
| itemInfo.contentRating | Restituisce l'insieme di attributi che specifica quale fascia d'età è adatta a visualizzare il contenuto. Per maggiori informazioni, vedi [Risorsa ItemInfo](../resources/item-info.md) |
| itemInfo.externalIds | Restituisce l'insieme di identificatori usati globalmente per identificare un particolare prodotto. Per maggiori informazioni, vedi [Risorsa ItemInfo](../resources/item-info.md) |
| itemInfo.features | Restituisce l'insieme di attributi che specifica le caratteristiche chiave di un articolo. Per maggiori informazioni, vedi [Risorsa ItemInfo](../resources/item-info.md) |
| itemInfo.manufactureInfo | Restituisce l'insieme di attributi che specifica le informazioni relative alla produzione di un articolo. Per maggiori informazioni, vedi [Risorsa ItemInfo](../resources/item-info.md) |
| itemInfo.productInfo | Restituisce l'insieme di attributi che descrive gli aspetti non tecnici di un articolo. Per maggiori informazioni, vedi [Risorsa ItemInfo](../resources/item-info.md) |
| itemInfo.technicalInfo | Restituisce l'insieme di attributi che descrive gli aspetti tecnici dell'articolo. Per maggiori informazioni, vedi [Risorsa ItemInfo](../resources/item-info.md) |
| itemInfo.title | Restituisce il titolo del prodotto. Per maggiori informazioni, vedi [Risorsa ItemInfo](../resources/item-info.md) |
| itemInfo.tradeInInfo | Restituisce l'insieme di attributi che specifica le informazioni di trade-in di un articolo. Per maggiori informazioni, vedi [Risorsa ItemInfo](../resources/item-info.md) |
| offersV2.listings.availability | Restituisce la quantità massima acquistabile per un prodotto. Per maggiori informazioni, vedi [Risorsa OffersV2](../resources/offersV2.md) |
| offersV2.listings.condition | Restituisce la condizione del prodotto. Per maggiori informazioni, vedi [Risorsa OffersV2](../resources/offersV2.md) |
| offersV2.listings.dealDetails | Restituisce le informazioni sull'offerta promozionale (deal). Per maggiori informazioni, vedi [Risorsa OffersV2](../resources/offersV2.md) |
| offersV2.listings.isBuyBoxWinner | Restituisce se la data offerta del prodotto è vincitrice della buy box nella pagina di dettaglio del prodotto. Per maggiori informazioni, vedi [Risorsa OffersV2](../resources/offersV2.md) |
| offersV2.listings.loyaltyPoints | Restituisce le informazioni sui punti fedeltà per un'offerta (attualmente supportato solo nel marketplace del Giappone). Per maggiori informazioni, vedi [Risorsa OffersV2](../resources/offersV2.md) |
| offersV2.listings.merchantInfo | Restituisce le informazioni sul venditore per l'offerta del prodotto. Per maggiori informazioni, vedi [Risorsa OffersV2](../resources/offersV2.md) |
| offersV2.listings.price | Restituisce il prezzo di acquisto dell'offerta di un prodotto. Per maggiori informazioni, vedi [Risorsa OffersV2](../resources/offersV2.md) |
| offersV2.listings.type | Restituisce il tipo di offerta. Per maggiori informazioni, vedi [Risorsa OffersV2](../resources/offersV2.md) |
| parentASIN | Restituisce l'ASIN padre di un dato articolo. Per maggiori informazioni, vedi [Risorsa ParentASIN](../resources/parent-asin.md) |

## Elementi di risposta

| Nome | Descrizione |
| :--- | :--- |
| errors | Array opzionale di oggetti errore per gli articoli che non hanno superato la validazione o il lookup. Presente solo quando alcuni articoli hanno successo e altri falliscono. |
| itemResults | Contenitore degli articoli. |
| items | Elenco di Item. |
| item | Contenitore delle informazioni dell'articolo, inclusi ASIN, Detail Page URL e altri attributi a seconda delle risorse richieste. |

> [!NOTE]
> Quando gli ItemId richiesti non sono validi o non sono accessibili tramite la Creators API, compariranno nel contenitore Errors della GetItemsResponse. Di conseguenza, l'ordine degli ItemId nella risposta può cambiare. È quindi consigliato recuperare le informazioni dell'articolo richiesto controllando il valore ASIN dell'articolo.

## Esempi

Di seguito il payload JSON di esempio per una richiesta `GetItems`.

```json
{
        "itemIds": ["B0199980K4","B000HZD168","B01180YUXS","B00BKQTA4A"],
        "itemIdType": "ASIN",
        "languagesOfPreference": ["en_US"],
        "marketplace": "www.amazon.com",
        "partnerTag": "xyz-20",
        "resources": ["images.primary.small","itemInfo.title","itemInfo.features","parentASIN"]
}
```

## Risposta di esempio

Lo snippet seguente è una risposta alla prima richiesta. Mostra tutti gli attributi dell'articolo restituiti per impostazione predefinita.

```json
{
  "errors": [
    {
      "code": "ItemNotAccessible",
      "message": "The ItemId B01180YUXS is not accessible through the Creators API."
    }
  ],
  "itemResults": {
    "items": [
      {
        "asin": "B0199980K4",
        "detailPageURL": "https://www.amazon.com/dp/B0199980K4?tag=xyz-20&linkCode=ogi&language=en_US&th=1&psc=1",
        "images": {
          "primary": {
            "small": {
              "height": 75,
              "url": "https://m.media-amazon.com/images/I/61s4tTAizUL._SL75_.jpg",
              "width": 56
            }
          }
        },
        "itemInfo": {
          "title": {
            "displayValue": "Genghis: The Legend of the Ten",
            "label": "Title",
            "locale": "en_US"
          }
        },
        "parentASIN": "B07QGKM68X"
      },
      {
        "asin": "B00BKQTA4A",
        "detailPageURL": "https://www.amazon.com/dp/B00BKQTA4A?tag=xyz-20&linkCode=ogi&language=en_US&th=1&psc=1",
        "images": {
          "primary": {
            "small": {
              "height": 75,
              "url": "https://m.media-amazon.com/images/I/41OiLOcQVJL._SL75_.jpg",
              "width": 46
            }
          }
        },
        "itemInfo": {
          "features": {
            "displayValues": [
              "Round watch featuring logoed white dial with stick indices",
              "36 mm stainless steel case with mineral dial window",
              "Quartz movement with analog display",
              "Leather calfskin band with buckle closure",
              "Water resistant to 30 m (99 ft): In general, withstands splashes or brief immersion in water, but not suitable for swimming"
            ],
            "label": "Features",
            "locale": "en_US"
          },
          "title": {
            "displayValue": "Daniel Wellington Women's 0608DW Sheffield Stainless Steel Watch",
            "label": "Title",
            "locale": "en_US"
          }
        },
        "parentASIN": "B07L5N7P32"
      },
      {
        "asin": "B000HZD168",
        "detailPageURL": "https://www.amazon.com/dp/B000HZD168?tag=xyz-20&linkCode=ogi&language=en_US&th=1&psc=1",
        "images": {
          "primary": {
            "small": {
              "height": 75,
              "url": "https://m.media-amazon.com/images/I/61ZRPpZoBvL._SL75_.jpg",
              "width": 56
            }
          }
        },
        "itemInfo": {
          "title": {
            "displayValue": "Star Trek II: The Wrath of Khan",
            "label": "Title",
            "locale": "en_US"
          }
        },
        "parentASIN": "B07G9PHJJH"
      }
    ]
  }
}
```
