View a markdown version of this page

GetRecommendations - Amazon Personalize
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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à.

GetRecommendations

Restituisce un elenco di articoli consigliati. Per le campagne, è richiesto l'Amazon Resource Name (ARN) della campagna e l'immissione richiesta di utenti e articoli dipende dal tipo di ricetta utilizzata per creare la soluzione a supporto della campagna, come segue:

  • USER_PERSONALIZATION: obbligatorio, non utilizzato userId itemId

  • RELATED_ITEMS - obbligatorio, non utilizzato itemId userId

Nota

Le campagne supportate da una soluzione creata utilizzando una ricetta di tipo PERSONALIZED_RANKING utilizzano l'API. GetPersonalizedRanking

Per i consiglieri, l'ARN del consigliatore è obbligatorio e l'elemento richiesto e l'input dell'utente dipendono dal caso d'uso (ricetta basata sul dominio) che supporta il suggerimento. Per informazioni sui requisiti dei casi d'uso, consulta Scelta dei casi d'uso consigliati. https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html

Sintassi della richiesta

POST /recommendations HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "context": { 
      "string" : "string" 
   },
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "itemId": "string",
   "metadataColumns": { 
      "string" : [ "string" ]
   },
   "numResults": number,
   "promotions": [ 
      { 
         "filterArn": "string",
         "filterValues": { 
            "string" : "string" 
         },
         "name": "string",
         "percentPromotedItems": number
      }
   ],
   "recommenderArn": "string",
   "userId": "string"
}

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

campaignArn

L'Amazon Resource Name (ARN) della campagna da utilizzare per ottenere consigli.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):personalize:.*:.*:.+

Obbligatorio: no

context

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 della mappa: numero massimo di 150 elementi.

Vincoli di lunghezza chiave: lunghezza massima di 150.

Modello di chiave:[A-Za-z\d_]+

Vincoli di lunghezza del valore: lunghezza massima di 1000.

Obbligatorio: no

filterArn

L'ARN del filtro da applicare ai consigli restituiti. Per ulteriori informazioni, consulta la pagina con le indicazioni per filtrare le raccomandazioni.

Quando usi questo parametro, assicurati che la risorsa del filtro siaACTIVE.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):personalize:.*:.*:.+

Obbligatorio: no

filterValues

I valori da utilizzare per filtrare i consigli. Per ogni parametro segnaposto nell'espressione del filtro, fornisci il nome del parametro (in maiuscole e minuscole) come chiave e 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 articoli, puoi omettere il filter-values valore .In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.

Per ulteriori informazioni, consulta Filtrare consigli e segmenti di utenti.

Tipo: mappatura stringa a stringa

Voci della mappa: numero massimo di 25 elementi.

Vincoli di lunghezza chiave: lunghezza massima di 50.

Modello di chiave:[A-Za-z0-9_]+

Vincoli di lunghezza del valore: lunghezza massima di 1000.

Obbligatorio: no

itemId

L'ID dell'articolo per cui fornire consigli.

Richiesto per il tipo di RELATED_ITEMS ricetta.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Obbligatorio: no

metadataColumns

Se hai abilitato i metadati nei consigli quando hai creato o aggiornato la campagna o il suggerimento, specifica le colonne di metadati del set di dati Items da includere nei consigli sugli articoli. La chiave della mappa è ITEMS e il valore è un elenco di nomi di colonne del set di dati Items. Il numero massimo di colonne che puoi fornire è 10.

Per informazioni sull'attivazione dei metadati per una campagna, consulta Abilitazione dei metadati nei consigli per una campagna. Per informazioni sull'attivazione dei metadati per un consigliatore, consulta Abilitazione dei metadati nei consigli per un consigliatore.

Tipo: mappatura da stringa a matrice di stringhe

Voci della mappa: numero massimo di 1 elemento.

Vincoli di lunghezza chiave: lunghezza massima di 256.

Membri dell'array: numero massimo di 99 elementi.

Vincoli di lunghezza: lunghezza massima di 150.

Obbligatorio: no

numResults

Il numero di risultati da restituire. Il valore predefinito è 25. Se includi metadati nei consigli, il numero massimo è 50. Altrimenti, il massimo è 500.

Tipo: numero intero

Intervallo valido: valore minimo di 0.

Obbligatorio: no

promotions

Le promozioni da applicare alla richiesta di raccomandazione. Una promozione definisce regole aziendali aggiuntive che si applicano a un sottoinsieme configurabile di articoli consigliati.

Tipo: matrice di oggetti Promotion

Membri dell'array: numero massimo di 1 elementi.

Obbligatorio: no

recommenderArn

L'Amazon Resource Name (ARN) del referente da utilizzare per ottenere consigli. Fornisci un ARN consigliato se hai creato un gruppo di set di dati di dominio con un suggeritore per un caso d'uso del dominio.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):personalize:.*:.*:.+

Obbligatorio: no

userId

L'ID utente per cui fornire consigli.

Richiesto per il tipo di USER_PERSONALIZATION ricetta.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Obbligatorio: no

Sintassi della risposta

HTTP/1.1 200
Content-type: application/json

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

Elementi di risposta

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

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

itemList

Un elenco di raccomandazioni ordinate in ordine decrescente in base al punteggio di previsione. L'elenco può contenere un massimo di 500 elementi.

Tipo: matrice di oggetti PredictedItem

recommendationId

L'ID della raccomandazione.

Tipo: stringa

Errori

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

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: