Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# GetPersonalizedRanking
<a name="API_RS_GetPersonalizedRanking"></a>

Riordina un elenco di elementi consigliati per un determinato utente. Il primo elemento dell'elenco è considerato quello con più probabilità di interesse per l'utente.

**Nota**  
La soluzione di supporto della campagna deve essere stata creata con una ricetta di tipo PERSONALIZED\$1RANKING.

## Sintassi della richiesta
<a name="API_RS_GetPersonalizedRanking_RequestSyntax"></a>

```
POST /personalize-ranking HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "context": { 
      "string" : "string" 
   },
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "inputList": [ "string" ],
   "metadataColumns": { 
      "string" : [ "string" ]
   },
   "userId": "string"
}
```

## Parametri della richiesta URI:
<a name="API_RS_GetPersonalizedRanking_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_RS_GetPersonalizedRanking_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [campaignArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-campaignArn"></a>
L'Amazon Resource Name (ARN) della campagna da utilizzare per generare il ranking personalizzato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [context](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-context"></a>
I metadati contestuali da utilizzare per ricevere consigli. I metadati contestuali includono tutte le informazioni di interazione che potrebbero essere rilevanti per ottenere i consigli di un utente, come la posizione corrente dell'utente o il tipo di dispositivo.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 150 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 150.  
Modello di chiave:`[A-Za-z\d_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [filterArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-filterArn"></a>
L'Amazon Resource Name (ARN) di un filtro che hai creato per includere o escludere articoli dai consigli per un determinato utente. Per ulteriori informazioni, consulta la pagina con le indicazioni per [filtrare le raccomandazioni](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [filterValues](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-filterValues"></a>
I valori da utilizzare per filtrare i consigli. Per ogni parametro segnaposto nell'espressione di filtro, fornite il nome del parametro (in caso di corrispondenza tra maiuscole e minuscole) come chiave e il valore o i valori del filtro come valore corrispondente. Separa più valori per un parametro con una virgola.   
Per le espressioni di filtro che utilizzano un `INCLUDE` elemento per includere elementi, è necessario fornire valori per tutti i parametri definiti nell'espressione. Per i filtri con espressioni che utilizzano un `EXCLUDE` elemento per escludere elementi, puoi omettere `filter-values` .In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.  
Per ulteriori informazioni, consulta la pagina con le indicazioni per [filtrare le raccomandazioni](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 25 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 50.  
Modello di chiave:`[A-Za-z0-9_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [inputList](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-inputList"></a>
Un elenco di elementi (per`itemId`) da classificare. Se un elemento non è stato incluso nel set di dati di addestramento, l'elemento viene aggiunto alla fine dell'elenco riclassificato. Se includi i metadati nei consigli, il massimo è 50. Altrimenti, il massimo è 500.  
Tipo: array di stringhe  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: sì

 ** [metadataColumns](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-metadataColumns"></a>
Se hai abilitato i metadati nei consigli quando hai creato o aggiornato la campagna, specifica le colonne di metadati del set di dati Items da includere nella classifica personalizzata. La chiave della mappa è `ITEMS` e il valore è un elenco di nomi di colonne dal set di dati Items. Il numero massimo di colonne che puoi fornire è 10.  
 Per informazioni sull'abilitazione dei metadati per una campagna, consulta [Attivazione dei metadati nei consigli per una](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata) campagna.   
Tipo: mappatura da stringa a matrice di stringhe  
Voci sulla mappa: numero massimo di 1 elemento.  
Limiti di lunghezza della chiave: lunghezza massima di 256.  
Membri dell'array: numero massimo di 99 elementi.  
Vincoli di lunghezza: lunghezza massima di 150.  
Obbligatorio: no

 ** [userId](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-userId"></a>
L'utente per il quale desideri che la campagna fornisca un posizionamento personalizzato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_RS_GetPersonalizedRanking_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "personalizedRanking": [ 
      { 
         "itemId": "string",
         "metadata": { 
            "string" : "string" 
         },
         "promotionName": "string",
         "reason": [ "string" ],
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

## Elementi di risposta
<a name="API_RS_GetPersonalizedRanking_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [personalizedRanking](#API_RS_GetPersonalizedRanking_ResponseSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-response-personalizedRanking"></a>
Un elenco di elementi in ordine di maggiore probabile interesse per l'utente. Il massimo è 500.  
Tipo: matrice di oggetti [PredictedItem](API_RS_PredictedItem.md)

 ** [recommendationId](#API_RS_GetPersonalizedRanking_ResponseSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-response-recommendationId"></a>
L'ID della raccomandazione.  
Tipo: String

## Errori
<a name="API_RS_GetPersonalizedRanking_Errors"></a>

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_RS_GetPersonalizedRanking_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetPersonalizedRanking)