# Images

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

La risorsa Images restituisce gli URL di tutte le immagini disponibili di un articolo in tre dimensioni: `Small`, `Medium` e `Large`. Per esempio, se un Kindle ha quattro immagini, la risorsa Images restituisce gli URL di 12 immagini: quattro immagini, ciascuna in tre dimensioni.

Oltre a restituire gli URL delle immagini, queste risorse restituiscono anche le dimensioni (altezza e larghezza) di ciascuna immagine. Usa questi valori per visualizzare correttamente le immagini.

## Disponibilità

Tutti i locale.

## Elementi di risposta

| Nome | Descrizione |
| :--- | :--- |
| Primary | Contenitore per le immagini principali. Include le dimensioni Large, Medium e Small a seconda delle risorse richieste. Ogni dimensione contiene tre valori: URL, altezza e larghezza dell'immagine. Per maggiori informazioni, vedi [Elemento di risposta ImageType](#elemento-di-risposta-imagetype) |
| Variants | Contenitore per le immagini delle varianti. Include le dimensioni Large, Medium e Small a seconda delle risorse richieste. Ogni dimensione contiene tre valori: URL, altezza e larghezza dell'immagine. Per maggiori informazioni, vedi [Elemento di risposta ImageType](#elemento-di-risposta-imagetype) |

#### Elemento di risposta ImageType

La struttura del contenitore ImageType (Primary / Variants) all'interno della risorsa di alto livello Images è la seguente:

```json
{
  "imageType": {
    "imageSize": {
      "url": "URL dell'immagine",
      "height": "Numero che rappresenta l'altezza dell'immagine",
      "width": "Numero che rappresenta la larghezza dell'immagine"
    }
  }
}
```

* Ogni `ImageType` (Primary / Variant) può contenere tre sotto-risorse: Small, Medium e Large.
* Ogni `ImageSize` (Small / Medium / Large) contiene tre valori: URL, altezza e larghezza dell'immagine.

> [!NOTE]
> L'immagine `Primary` indica l'immagine mostrata nei risultati di ricerca e nella pagina di dettaglio. **Variants** include tutto il resto. Le dimensioni delle immagini sono specificate dal suffisso `_SLXXX_` nell'URL, dove `XXX` è il numero di pixel del lato più lungo dell'immagine. Per esempio, un'immagine di dimensione media ha 160 pixel sul lato più lungo, quindi ha il suffisso `_SL160_`. Questo è il modo preferito per referenziare le immagini.

## 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 dell'API.

| Nome | Descrizione |
| :--- | :--- |
| images.primary.small | Ottiene l'immagine principale di un articolo in formato piccolo. |
| images.primary.medium | Ottiene l'immagine principale di un articolo in formato medio. |
| images.primary.large | Ottiene l'immagine principale di un articolo in formato grande. |
| images.variants.small | Ottiene le immagini delle varianti di un articolo in formato piccolo. |
| images.variants.medium | Ottiene le immagini delle varianti di un articolo in formato medio. |
| images.variants.large | Ottiene le immagini delle varianti di un articolo in formato grande. |

## Casi d'uso di esempio

### Esempio 1

Ottenere l'immagine principale di un articolo, in formato grande.

#### Payload della richiesta

```json
{
    "associateTag": "xyz-20",
    "itemIds": ["B00TSUGXKE"],
    "resources": ["images.primary.large"]
}
```

#### Risposta

```json
{
 "asin": "B00TSUGXKE",
 "images": {
  "primary": {
   "large": {
    "url": "https://m.media-amazon.com/images/I/41FYkVPzrIL.jpg",
    "height": 500,
    "width": 500
   }
  }
 }
}
```

### Esempio 2

Ottenere l'immagine principale di un articolo in formato grande e le immagini delle varianti in formato piccolo.

#### Payload della richiesta

```json
{
    "associateTag": "xyz-20",
    "itemIds": ["B00TSUGXKE"],
    "resources": ["images.primary.large", "images.variants.small"]
}
```

#### Risposta

```json
{
 "asin": "B00TSUGXKE",
 "images": {
  "primary": {
   "large": {
    "url": "https://m.media-amazon.com/images/I/41FYkVPzrIL.jpg",
    "height": 500,
    "width": 500
   }
  },
  "variants": [{
   "small": {
    "url": "https://m.media-amazon.com/images/I/51CjYz4iQHL._SL75_.jpg",
    "height": 75,
    "width": 75
   }
  }, ...]
 }
}
```

### Esempio 3

Ottenere tutte le immagini di un articolo, in tutte le dimensioni.

#### Payload della richiesta

```json
{
    "associateTag": "xyz-20",
    "itemIds": ["B00TSUGXKE"],
    "resources": ["images.primary.small", "images.primary.medium", "images.primary.large", "images.variants.small", "images.variants.medium", "images.variants.large"]
}
```

#### Risposta

```json
{
 "asin": "B00TSUGXKE",
 "images": {
  "primary": {
   "small": {
    "url": "https://m.media-amazon.com/images/I/41FYkVPzrIL._SL75_.jpg",
    "height": 75,
    "width": 75
   },
   "medium": {
    "url": "https://m.media-amazon.com/images/I/41FYkVPzrIL._SL160_.jpg",
    "height": 160,
    "width": 160
   },
   "large": {
    "url": "https://m.media-amazon.com/images/I/41FYkVPzrIL.jpg",
    "height": 500,
    "width": 500
   }
  },
  "variants": [{
   "small": {
    "url": "https://m.media-amazon.com/images/I/51CjYz4iQHL._SL75_.jpg",
    "height": 75,
    "width": 75
   },
   "medium": {
    "url": "https://m.media-amazon.com/images/I/51CjYz4iQHL._SL160_.jpg",
    "height": 160,
    "width": 160
   },
   "large": {
    "url": "https://m.media-amazon.com/images/I/51CjYz4iQHL.jpg",
    "height": 500,
    "width": 500
   }
  }, ...]
 }
}
```
