# GetVariations

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

## Descrizione

Dato un ASIN, l'operazione `GetVariations` restituisce un insieme di articoli che sono lo stesso prodotto ma differiscono secondo un tema coerente, per esempio taglia e colore. Questi articoli che differiscono secondo un tema coerente si chiamano varianti (variations). Una variante è un ASIN figlio (child ASIN). L'ASIN padre (parent ASIN) è un'astrazione degli articoli figli. Per esempio, una camicia è un ASIN padre e gli ASIN padre non possono essere venduti. Un ASIN figlio sarebbe una camicia blu, taglia 16, venduta da MyApparelStore. Questo ASIN figlio è una delle potenzialmente molte varianti. I modi in cui le varianti differiscono si chiamano dimensioni (dimensions). Nell'esempio precedente, taglia e colore sono le dimensioni.

`GetVariations` 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)
* [VariationSummary](../resources/variation-summary.md)

## 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 `GetVariations` sono elencati di seguito:

| Nome | Descrizione | Obbligatorio |
| :--- | :--- | :--- |
| asin | Amazon Standard Identification Number. <ul><li>Tipo: *stringa non vuota*</li><li>Valore predefinito: nessuno</li><li>Uso: `{"asin" : "B0199980K4"}`</li></ul> | Sì |
| condition | Il parametro condition filtra offersV2 per tipo di condizione. Per esempio, `Condition:New` restituisce gli articoli con 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. 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 |
| 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, 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 |
| variationCount | Numero di varianti da restituire per pagina in GetVariations. Per impostazione predefinita, GetVariations restituisce 10 varianti per pagina. <ul><li>Tipo: *intero positivo minore di 10*</li><li>Valore predefinito: `10`</li><li>Uso: `{"variationCount":10}`</li></ul> | No |
| variationPage | Numero di pagina delle varianti restituite da GetVariations. Per impostazione predefinita, GetVariations restituisce 10 varianti. Usa VariationPage per restituire una sottosezione della risposta. Per impostazione predefinita ci sono 10 varianti per pagina. <ul><li>Tipo: *intero positivo*</li><li>Valore predefinito: `1`</li><li>Uso: `{"variationPage":1}`</li></ul> | No |

#### Parametro Condition

Nota che una richiesta `GetVariations` 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 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) |
| variationSummary.price.highestPrice | Restituisce il prezzo più alto tra gli ASIN figli. Per maggiori informazioni, vedi [Risorsa VariationSummary](../resources/variation-summary.md) |
| variationSummary.price.lowestPrice | Restituisce il prezzo più basso tra gli ASIN figli. Per maggiori informazioni, vedi [Risorsa VariationSummary](../resources/variation-summary.md) |
| variationSummary.variationDimension | Restituisce i dettagli sulle dimensioni secondo cui varia l'attributo. Per maggiori informazioni, vedi [Risorsa VariationSummary](../resources/variation-summary.md) |

## Elementi di risposta

| Nome | Descrizione |
| :--- | :--- |
| errors | Array opzionale di oggetti errore per le varianti che non hanno superato la validazione o il lookup. Presente solo quando si verificano fallimenti parziali. |
| variationsResult | Contenitore del risultato delle varianti. Contiene il contenitore items e il contenitore variationSummary. |
| items | Contenitore delle informazioni dell'articolo, inclusi ASIN, titolo e altri attributi a seconda delle risorse richieste. |
| variationSummary | Contenitore della risorsa variationSummary. |

## Casi d'uso di esempio

### Esempio 1

Ottenere le varianti per un ASIN padre.

#### Payload della richiesta

```json
{
 "asin": "B00422MCUS",
 "resources": [
  "itemInfo.title",
  "variationSummary.price.highestPrice",
  "variationSummary.price.lowestPrice",
  "variationSummary.variationDimension"
 ],
 "variationPage": 1,
 "partnerTag": "xyz-20",
 "marketplace": "www.amazon.co.uk",
 "Operation": "GetVariations"
}
```

#### Risposta

```json
{
  "variationsResult": {
    "items": [
      {
        "asin": "B019MNBMS4",
        "detailPageURL": "https://www.amazon.co.uk/dp/B019MNBMS4?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "itemInfo": {
          "title": {
            "displayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Navy,One Size",
            "label": "title",
            "locale": "en_GB"
          }
        },
        "variationAttributes": [
          { "name": "size_name", "value": "One Size" },
          { "name": "color_name", "value": "Navy" }
        ]
      },
      {
        "asin": "B073211XCB",
        "detailPageURL": "https://www.amazon.co.uk/dp/B073211XCB?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "itemInfo": {
          "title": {
            "displayValue": "Tommy Hilfiger mens Rfid Blocking 100% Leather Passcase Wallet Wallet - Brown -",
            "label": "title",
            "locale": "en_GB"
          }
        },
        "variationAttributes": [
          { "name": "size_name", "value": "One Size" },
          { "name": "color_name", "value": "Logan - Tan" }
        ]
      },
      {
        "asin": "B00422MCW6",
        "detailPageURL": "https://www.amazon.co.uk/dp/B00422MCW6?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "itemInfo": {
          "title": {
            "displayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Black,One Size",
            "label": "title",
            "locale": "en_GB"
          }
        },
        "variationAttributes": [
          { "name": "size_name", "value": "One Size" },
          { "name": "color_name", "value": "Black" }
        ]
      }
    ],
    "variationSummary": {
      "pageCount": 2,
      "price": {
        "highestPrice": { "amount": 30.87, "currency": "GBP", "displayAmount": "£30.87" },
        "lowestPrice": { "amount": 17.03, "currency": "GBP", "displayAmount": "£17.03" }
      },
      "variationCount": 13,
      "variationDimensions": [
        { "displayName": "Size", "name": "size_name", "values": ["One Size"] },
        {
          "displayName": "Colour",
          "name": "color_name",
          "values": ["Brown","Navy","Black","Burgundy","Cognac","Gray","Green","Logan - Tan","Navy/Black","Red","Rfid-black","Rfid-navy","Tan"]
        }
      ]
    }
  }
}
```

> La risposta originale elenca tutte e 10 le varianti della pagina; sopra ne sono riportate alcune a titolo esemplificativo. La struttura è identica per ogni elemento dell'array `items`. Consulta il [sorgente EN](../../../en/api-reference/operations/get-variations.md) per il payload completo.

### Esempio 2

Ottenere le varianti per un ASIN figlio. La richiesta è identica all'Esempio 1 ma con l'ASIN di un figlio (es. `B01M2C97VG`): la risposta contiene comunque l'intero set di varianti del prodotto padre, perché GetVariations risale al padre a partire da qualsiasi figlio.

#### Payload della richiesta

```json
{
 "asin": "B01M2C97VG",
 "resources": [
  "itemInfo.title",
  "variationSummary.price.highestPrice",
  "variationSummary.price.lowestPrice",
  "variationSummary.variationDimension"
 ],
 "variationPage": 1,
 "partnerTag": "xyz-20",
 "marketplace": "www.amazon.co.uk",
 "Operation": "GetVariations"
}
```

La risposta ha la stessa struttura dell'Esempio 1 (stesso `variationSummary`, stesso set di `items`). Vedi il [sorgente EN](../../../en/api-reference/operations/get-variations.md) per il payload completo.

### Esempio 3

Ottenere il set successivo di varianti per un ASIN usando il parametro `variationPage`.

#### Payload della richiesta

```json
{
 "asin": "B00422MCUS",
 "resources": [
  "itemInfo.title",
  "variationSummary.price.highestPrice",
  "variationSummary.price.lowestPrice",
  "variationSummary.variationDimension"
 ],
 "variationPage": 2,
 "partnerTag": "xyz-20",
 "marketplace": "www.amazon.co.uk",
 "Operation": "GetVariations"
}
```

#### Risposta

```json
{
 "variationsResult": {
  "items": [
   {
    "asin": "B075TFCB3R",
    "detailPageURL": "https://www.amazon.co.uk/dp/B075TFCB3R?tag=xyz-20&linkCode=ogv&th=1&psc=1",
    "itemInfo": {
     "title": {
      "displayValue": "Tommy Hilfiger Men's RFID Blocking 100% Leather Ranger Passcase Wallet Bi-Fold, Navy/Black, One Size",
      "label": "title",
      "locale": "en_GB"
     }
    },
    "variationAttributes": [
     { "name": "size_name", "value": "One Size" },
     { "name": "color_name", "value": "Navy/Black" }
    ]
   },
   {
    "asin": "B0743JLQKT",
    "detailPageURL": "https://www.amazon.co.uk/dp/B0743JLQKT?tag=xyz-20&linkCode=ogv&th=1&psc=1",
    "itemInfo": {
     "title": {
      "displayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet, Gray",
      "label": "title",
      "locale": "en_GB"
     }
    },
    "variationAttributes": [
     { "name": "size_name", "value": "One Size" },
     { "name": "color_name", "value": "Gray" }
    ]
   },
   {
    "asin": "B0743JL719",
    "detailPageURL": "https://www.amazon.co.uk/dp/B0743JL719?tag=xyz-20&linkCode=ogv&th=1&psc=1",
    "itemInfo": {
     "title": {
      "displayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet, Burgundy",
      "label": "title",
      "locale": "en_GB"
     }
    },
    "variationAttributes": [
     { "name": "size_name", "value": "One Size" },
     { "name": "color_name", "value": "Burgundy" }
    ]
   }
  ],
  "variationSummary": {
   "pageCount": 2,
   "price": {
    "highestPrice": { "amount": 30.87, "currency": "GBP", "displayAmount": "£30.87" },
    "lowestPrice": { "amount": 17.03, "currency": "GBP", "displayAmount": "£17.03" }
   },
   "variationCount": 13,
   "variationDimensions": [
    { "displayName": "Size", "name": "size_name", "values": ["One Size"] },
    {
     "displayName": "Colour",
     "name": "color_name",
     "values": ["Brown","Navy","Black","Burgundy","Cognac","Gray","Green","Logan - Tan","Navy/Black","Red","Rfid-black","Rfid-navy","Tan"]
    }
   ]
  }
 }
}
```

### Esempio 4

Ottenere 3 varianti per un ASIN usando il parametro `variationCount`.

#### Payload della richiesta

```json
{
 "asin": "B00422MCUS",
 "resources": [
  "itemInfo.title",
  "variationSummary.price.highestPrice",
  "variationSummary.price.lowestPrice",
  "variationSummary.variationDimension"
 ],
 "variationCount": 3,
 "partnerTag": "xyz-20",
 "marketplace": "www.amazon.co.uk",
 "operation": "GetVariations"
}
```

#### Risposta

```json
{
  "variationsResult": {
    "items": [
      {
        "asin": "B00422MCVM",
        "detailPageURL": "https://www.amazon.co.uk/dp/B00422MCVM?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "itemInfo": {
          "title": {
            "displayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Tan,One Size",
            "label": "title",
            "locale": "en_GB"
          }
        },
        "variationAttributes": [
          { "name": "size_name", "value": "One Size" },
          { "name": "color_name", "value": "Tan" }
        ]
      },
      {
        "asin": "B00422MCW6",
        "detailPageURL": "https://www.amazon.co.uk/dp/B00422MCW6?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "itemInfo": {
          "title": {
            "displayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Black,One Size",
            "label": "title",
            "locale": "en_GB"
          }
        },
        "variationAttributes": [
          { "name": "size_name", "value": "One Size" },
          { "name": "color_name", "value": "Black" }
        ]
      },
      {
        "asin": "B00422MCVW",
        "detailPageURL": "https://www.amazon.co.uk/dp/B00422MCVW?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "itemInfo": {
          "title": {
            "displayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Brown,One Size",
            "label": "title",
            "locale": "en_GB"
          }
        },
        "variationAttributes": [
          { "name": "size_name", "value": "One Size" },
          { "name": "color_name", "value": "Brown" }
        ]
      }
    ],
    "variationSummary": {
      "pageCount": 5,
      "price": {
        "highestPrice": { "amount": 30.87, "currency": "GBP", "displayAmount": "£30.87" },
        "lowestPrice": { "amount": 17.03, "currency": "GBP", "displayAmount": "£17.03" }
      },
      "variationCount": 13,
      "variationDimensions": [
        { "displayName": "Size", "name": "size_name", "values": ["One Size"] },
        {
          "displayName": "Colour",
          "name": "color_name",
          "values": ["Brown","Navy","Black","Burgundy","Cognac","Gray","Green","Logan - Tan","Navy/Black","Red","Rfid-black","Rfid-navy","Tan"]
        }
      ]
    }
  }
}
```
