Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Waktu Aktif Amazon Personalize
<a name="API_Operations_Amazon_Personalize_Runtime"></a>

Tindakan berikut didukung oleh Amazon Personalize Runtime:
+  [GetActionRecommendations](API_RS_GetActionRecommendations.md) 
+  [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) 
+  [GetRecommendations](API_RS_GetRecommendations.md) 

# GetActionRecommendations
<a name="API_RS_GetActionRecommendations"></a>

Mengembalikan daftar tindakan yang direkomendasikan diurutkan dalam urutan menurun berdasarkan skor prediksi. Gunakan `GetActionRecommendations` API jika Anda memiliki kampanye khusus yang menerapkan versi solusi yang dilatih dengan resep PERSONALIZED\$1ACTIONS. 

[Untuk informasi selengkapnya tentang resep PERSONALIZED\$1ACTIONS, lihat resep PERSONALIZED\$1ACTIONS.](https://docs.aws.amazon.com/personalize/latest/dg/nexts-best-action-recipes.html) Untuk informasi selengkapnya tentang mendapatkan rekomendasi tindakan, lihat [Mendapatkan rekomendasi tindakan](https://docs.aws.amazon.com/personalize/latest/dg/get-action-recommendations.html).

## Minta Sintaks
<a name="API_RS_GetActionRecommendations_RequestSyntax"></a>

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

{
   "campaignArn": "string",
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "numResults": number,
   "userId": "string"
}
```

## Parameter Permintaan URI
<a name="API_RS_GetActionRecommendations_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_RS_GetActionRecommendations_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [campaignArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-campaignArn"></a>
Nama Sumber Daya Amazon (ARN) kampanye yang akan digunakan untuk mendapatkan rekomendasi tindakan. Kampanye ini harus menerapkan versi solusi yang dilatih dengan resep PERSONALIZED\$1ACTIONS.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Tidak

 ** [filterArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterArn"></a>
ARN filter untuk diterapkan pada rekomendasi yang dikembalikan. Untuk informasi selengkapnya, lihat [Memfilter Rekomendasi](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Saat menggunakan parameter ini, pastikan sumber daya filternya`ACTIVE`.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Tidak

 ** [filterValues](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterValues"></a>
Nilai yang digunakan saat memfilter rekomendasi. Untuk setiap parameter placeholder dalam ekspresi filter Anda, berikan nama parameter (dalam kasus yang cocok) sebagai kunci dan nilai filter sebagai nilai yang sesuai. Pisahkan beberapa nilai untuk satu parameter dengan koma.   
Untuk ekspresi filter yang menggunakan `INCLUDE` elemen untuk menyertakan tindakan, Anda harus memberikan nilai untuk semua parameter yang ditentukan dalam ekspresi. Untuk filter dengan ekspresi yang menggunakan `EXCLUDE` elemen untuk mengecualikan tindakan, Anda dapat menghilangkan. `filter-values` Dalam kasus ini, Amazon Personalize tidak menggunakan bagian ekspresi tersebut untuk memfilter rekomendasi.  
Untuk informasi selengkapnya, lihat [Memfilter rekomendasi dan segmen pengguna](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipe: Peta string ke string  
Entri Peta: Jumlah maksimum 25 item.  
Kendala Panjang Kunci: Panjang maksimum 50.  
Pola Kunci: `[A-Za-z0-9_]+`   
Kendala Panjang Nilai: Panjang maksimum 1000.  
Wajib: Tidak

 ** [numResults](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-numResults"></a>
Jumlah hasil yang akan dikembalikan. Default-nya adalah 5. Maksimal adalah 100.  
Jenis: Integer  
Rentang yang Valid: Nilai minimum 0.  
Wajib: Tidak

 ** [userId](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-userId"></a>
ID pengguna pengguna untuk memberikan rekomendasi tindakan untuk.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Wajib: Tidak

## Sintaksis Respons
<a name="API_RS_GetActionRecommendations_ResponseSyntax"></a>

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

{
   "actionList": [ 
      { 
         "actionId": "string",
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

## Elemen Respons
<a name="API_RS_GetActionRecommendations_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [actionList](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-actionList"></a>
Daftar rekomendasi tindakan yang diurutkan dalam urutan menurun berdasarkan skor prediksi. Bisa ada maksimal 100 tindakan dalam daftar. Untuk informasi tentang skor aksi, lihat [Cara kerja penilaian rekomendasi tindakan](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html).  
Tipe: Array objek [PredictedAction](API_RS_PredictedAction.md)

 ** [recommendationId](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-recommendationId"></a>
ID rekomendasi.  
Tipe: String

## Kesalahan
<a name="API_RS_GetActionRecommendations_Errors"></a>

 ** InvalidInputException **   
Berikan nilai yang valid untuk bidang atau parameter.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang ditentukan tidak ada.  
Kode Status HTTP: 404

## Lihat Juga
<a name="API_RS_GetActionRecommendations_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetActionRecommendations) 

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

Memberi peringkat ulang daftar item yang direkomendasikan untuk pengguna yang diberikan. Item pertama dalam daftar dianggap sebagai item yang paling mungkin menarik bagi pengguna.

**catatan**  
Solusi yang mendukung kampanye harus dibuat menggunakan resep tipe PERSONALIZED\$1RANKING.

## Minta Sintaks
<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"
}
```

## Parameter Permintaan URI
<a name="API_RS_GetPersonalizedRanking_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_RS_GetPersonalizedRanking_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [campaignArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-campaignArn"></a>
Nama Sumber Daya Amazon (ARN) kampanye yang akan digunakan untuk menghasilkan peringkat yang dipersonalisasi.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Ya

 ** [context](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-context"></a>
Metadata kontekstual yang digunakan saat mendapatkan rekomendasi. Metadata kontekstual mencakup informasi interaksi apa pun yang mungkin relevan saat mendapatkan rekomendasi pengguna, seperti lokasi pengguna saat ini atau jenis perangkat.  
Tipe: Peta string ke string  
Entri Peta: Jumlah maksimum 150 item.  
Kendala Panjang Kunci: Panjang maksimum 150.  
Pola Kunci: `[A-Za-z\d_]+`   
Kendala Panjang Nilai: Panjang maksimum 1000.  
Wajib: Tidak

 ** [filterArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-filterArn"></a>
Nama Sumber Daya Amazon (ARN) dari filter yang Anda buat untuk menyertakan item atau mengecualikan item dari rekomendasi untuk pengguna tertentu. Untuk informasi selengkapnya, lihat [Memfilter Rekomendasi](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Tidak

 ** [filterValues](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-filterValues"></a>
Nilai yang digunakan saat memfilter rekomendasi. Untuk setiap parameter placeholder dalam ekspresi filter Anda, berikan nama parameter (dalam kasus yang cocok) sebagai kunci dan nilai filter sebagai nilai yang sesuai. Pisahkan beberapa nilai untuk satu parameter dengan koma.   
Untuk ekspresi filter yang menggunakan `INCLUDE` elemen untuk menyertakan item, Anda harus memberikan nilai untuk semua parameter yang ditentukan dalam ekspresi. Untuk filter dengan ekspresi yang menggunakan `EXCLUDE` elemen untuk mengecualikan item, Anda dapat menghilangkan `filter-values` .Dalam kasus ini, Amazon Personalize tidak menggunakan bagian ekspresi tersebut untuk memfilter rekomendasi.  
Untuk informasi selengkapnya, lihat [Memfilter Rekomendasi](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipe: Peta string ke string  
Entri Peta: Jumlah maksimum 25 item.  
Kendala Panjang Kunci: Panjang maksimum 50.  
Pola Kunci: `[A-Za-z0-9_]+`   
Kendala Panjang Nilai: Panjang maksimum 1000.  
Wajib: Tidak

 ** [inputList](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-inputList"></a>
Daftar item (oleh`itemId`) ke peringkat. Jika item tidak termasuk dalam kumpulan data pelatihan, item tersebut ditambahkan ke akhir daftar yang di-reanked. Jika Anda memasukkan metadata dalam rekomendasi, maksimumnya adalah 50. Kalau tidak, maksimumnya adalah 500.  
Tipe: Array string  
Batasan Panjang: Panjang maksimum 256.  
Wajib: Ya

 ** [metadataColumns](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-metadataColumns"></a>
Jika Anda mengaktifkan metadata dalam rekomendasi saat membuat atau memperbarui kampanye, tentukan kolom metadata dari kumpulan data Item untuk disertakan dalam peringkat yang dipersonalisasi. Kunci peta adalah `ITEMS` dan nilainya adalah daftar nama kolom dari kumpulan data Item Anda. Jumlah maksimum kolom yang dapat Anda berikan adalah 10.  
 Untuk informasi tentang mengaktifkan metadata untuk kampanye, lihat [Mengaktifkan metadata](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata) dalam rekomendasi untuk kampanye.   
Tipe: Peta string ke array string  
Entri Peta: Jumlah maksimum 1 item.  
Kendala Panjang Kunci: Panjang maksimum 256.  
Anggota Array: Jumlah maksimum 99 item.  
Kendala Panjang: Panjang maksimum 150.  
Wajib: Tidak

 ** [userId](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-userId"></a>
Pengguna yang Anda inginkan kampanyenya memberikan peringkat yang dipersonalisasi.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Wajib: Ya

## Sintaksis Respons
<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"
}
```

## Elemen Respons
<a name="API_RS_GetPersonalizedRanking_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [personalizedRanking](#API_RS_GetPersonalizedRanking_ResponseSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-response-personalizedRanking"></a>
Daftar item dalam urutan yang paling mungkin menarik bagi pengguna. Maksimal adalah 500.  
Tipe: Array objek [PredictedItem](API_RS_PredictedItem.md)

 ** [recommendationId](#API_RS_GetPersonalizedRanking_ResponseSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-response-recommendationId"></a>
ID rekomendasi.  
Tipe: String

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

 ** InvalidInputException **   
Berikan nilai yang valid untuk bidang atau parameter.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang ditentukan tidak ada.  
Kode Status HTTP: 404

## Lihat Juga
<a name="API_RS_GetPersonalizedRanking_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 

# GetRecommendations
<a name="API_RS_GetRecommendations"></a>

Mengembalikan daftar item yang direkomendasikan. Untuk kampanye, Nama Sumber Daya Amazon (ARN) kampanye diperlukan dan input pengguna dan item yang diperlukan bergantung pada jenis resep yang digunakan untuk membuat solusi yang mendukung kampanye sebagai berikut:
+ USER\$1PERSONALIZATION - `userId` diperlukan, tidak digunakan `itemId`
+ RELATED\$1ITEMS - `itemId` wajib, tidak digunakan `userId`

**catatan**  
Kampanye yang didukung oleh solusi yang dibuat menggunakan resep tipe PERSONALIZED\$1RANKING menggunakan API. [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md)

 Untuk pemberi rekomendasi, ARN pemberi rekomendasi diperlukan dan item yang diperlukan serta input pengguna tergantung pada kasus penggunaan (resep berbasis domain) yang mendukung pemberi rekomendasi. Untuk informasi tentang persyaratan kasus penggunaan, lihat [Memilih kasus penggunaan pemberi rekomendasi](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html). 

## Minta Sintaks
<a name="API_RS_GetRecommendations_RequestSyntax"></a>

```
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"
}
```

## Parameter Permintaan URI
<a name="API_RS_GetRecommendations_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_RS_GetRecommendations_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [campaignArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-campaignArn"></a>
Nama Sumber Daya Amazon (ARN) dari kampanye yang akan digunakan untuk mendapatkan rekomendasi.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Tidak

 ** [context](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-context"></a>
Metadata kontekstual yang digunakan saat mendapatkan rekomendasi. Metadata kontekstual mencakup informasi interaksi apa pun yang mungkin relevan saat mendapatkan rekomendasi pengguna, seperti lokasi pengguna saat ini atau jenis perangkat.  
Tipe: Peta string ke string  
Entri Peta: Jumlah maksimum 150 item.  
Kendala Panjang Kunci: Panjang maksimum 150.  
Pola Kunci: `[A-Za-z\d_]+`   
Kendala Panjang Nilai: Panjang maksimum 1000.  
Wajib: Tidak

 ** [filterArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-filterArn"></a>
ARN filter untuk diterapkan pada rekomendasi yang dikembalikan. Untuk informasi selengkapnya, lihat [Memfilter Rekomendasi](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Saat menggunakan parameter ini, pastikan sumber daya filternya`ACTIVE`.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Tidak

 ** [filterValues](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-filterValues"></a>
Nilai yang akan digunakan saat memfilter rekomendasi. Untuk setiap parameter placeholder dalam ekspresi filter Anda, berikan nama parameter (dalam kasus yang cocok) sebagai kunci dan nilai filter sebagai nilai yang sesuai. Pisahkan beberapa nilai untuk satu parameter dengan koma.   
Untuk ekspresi filter yang menggunakan `INCLUDE` elemen untuk menyertakan item, Anda harus memberikan nilai untuk semua parameter yang ditentukan dalam ekspresi. Untuk filter dengan ekspresi yang menggunakan `EXCLUDE` elemen untuk mengecualikan item, Anda dapat menghilangkan `filter-values` .Dalam kasus ini, Amazon Personalize tidak menggunakan bagian ekspresi tersebut untuk memfilter rekomendasi.  
Untuk informasi selengkapnya, lihat [Memfilter rekomendasi dan segmen pengguna](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipe: Peta string ke string  
Entri Peta: Jumlah maksimum 25 item.  
Kendala Panjang Kunci: Panjang maksimum 50.  
Pola Kunci: `[A-Za-z0-9_]+`   
Kendala Panjang Nilai: Panjang maksimum 1000.  
Wajib: Tidak

 ** [itemId](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-itemId"></a>
ID item untuk memberikan rekomendasi untuk.  
Diperlukan untuk jenis `RELATED_ITEMS` resep.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Wajib: Tidak

 ** [metadataColumns](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-metadataColumns"></a>
Jika Anda mengaktifkan metadata dalam rekomendasi saat membuat atau memperbarui kampanye atau pemberi rekomendasi, tentukan kolom metadata dari kumpulan data Item untuk disertakan dalam rekomendasi item. Kunci peta adalah `ITEMS` dan nilainya adalah daftar nama kolom dari kumpulan data Item Anda. Jumlah maksimum kolom yang dapat Anda berikan adalah 10.  
 Untuk informasi tentang mengaktifkan metadata untuk kampanye, lihat [Mengaktifkan metadata](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata) dalam rekomendasi untuk kampanye. Untuk informasi tentang mengaktifkan metadata untuk pemberi rekomendasi, lihat [Mengaktifkan metadata](https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata) dalam rekomendasi untuk pemberi rekomendasi.   
Tipe: Peta string ke array string  
Entri Peta: Jumlah maksimum 1 item.  
Kendala Panjang Kunci: Panjang maksimum 256.  
Anggota Array: Jumlah maksimum 99 item.  
Kendala Panjang: Panjang maksimum 150.  
Wajib: Tidak

 ** [numResults](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-numResults"></a>
Jumlah hasil yang akan dikembalikan. Default-nya adalah 25. Jika Anda memasukkan metadata dalam rekomendasi, maksimumnya adalah 50. Kalau tidak, maksimumnya adalah 500.  
Jenis: Integer  
Rentang yang Valid: Nilai minimum 0.  
Wajib: Tidak

 ** [promotions](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-promotions"></a>
Promosi untuk diterapkan pada permintaan rekomendasi. Promosi mendefinisikan aturan bisnis tambahan yang berlaku untuk subset item yang direkomendasikan yang dapat dikonfigurasi.  
Tipe: Array objek [Promotion](API_RS_Promotion.md)  
Anggota Array: Jumlah maksimum 1 item.  
Wajib: Tidak

 ** [recommenderArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-recommenderArn"></a>
Nama Sumber Daya Amazon (ARN) dari pemberi rekomendasi untuk digunakan untuk mendapatkan rekomendasi. Berikan ARN pemberi rekomendasi jika Anda membuat grup kumpulan data Domain dengan pemberi rekomendasi untuk kasus penggunaan domain.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Tidak

 ** [userId](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-userId"></a>
ID pengguna untuk memberikan rekomendasi untuk.  
Diperlukan untuk jenis `USER_PERSONALIZATION` resep.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Wajib: Tidak

## Sintaksis Respons
<a name="API_RS_GetRecommendations_ResponseSyntax"></a>

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

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

## Elemen Respons
<a name="API_RS_GetRecommendations_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [itemList](#API_RS_GetRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetRecommendations-response-itemList"></a>
Daftar rekomendasi yang diurutkan dalam urutan menurun berdasarkan skor prediksi. Bisa ada maksimal 500 item dalam daftar.  
Tipe: Array objek [PredictedItem](API_RS_PredictedItem.md)

 ** [recommendationId](#API_RS_GetRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetRecommendations-response-recommendationId"></a>
ID rekomendasi.  
Tipe: String

## Kesalahan
<a name="API_RS_GetRecommendations_Errors"></a>

 ** InvalidInputException **   
Berikan nilai yang valid untuk bidang atau parameter.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang ditentukan tidak ada.  
Kode Status HTTP: 404

## Lihat Juga
<a name="API_RS_GetRecommendations_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetRecommendations)