翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# アクションの個別のインポート
<a name="importing-actions"></a>

[スキーマとデータセットの作成](data-prep-creating-datasets.md) を完了して [Actions データセット](actions-datasets.md)を作成したら、1 つ以上の新しいアクションをデータセットに個別にインポートできます。アクションを個別インポートすると、カタログの拡大に合わせて Actions データセットを小さなバッチインポートで最新の状態に保つことができます。一度に最大 10 のアクションをインポートできます。新しいアクションが大量にある場合は、最初にデータを一括でインポートしてから、必要に応じてアクションデータを個別にインポートすることをお勧めします。「[データセットインポートジョブを使用してバルクデータを Amazon Personalize にインポートする](bulk-data-import-step.md)」を参照してください。

Amazon Personalize コンソール、 AWS Command Line Interface (AWS CLI)、または AWS SDKsを使用してアクションをインポートできます。Actions データセットに既に存在するアクションと同じ `actionId` でアクションをインポートすると、Amazon Personalize はそのアクションを新しいアクションに置き換えます。

新しいレコードがレコメンデーションにどのように影響するかについては、「[トレーニング後のデータセット内のデータの更新](updating-datasets.md)」を参照してください。

**Topics**
+ [アクションの個別インポート (コンソール)](#importing-actions-console)
+ [アクションの個別のインポート (AWS CLI)](#importing-actions-cli)
+ [アクションを個別にインポートAWS SDKs)](#importing-actions-cli-sdk)

## アクションの個別インポート (コンソール)
<a name="importing-actions-console"></a>

一度に最大 10 個のアクションを Actions データセットにインポートできます。このセクションでは、Actions データセットが既に作成されていることを前提としています。データセットの作成については、「[スキーマとデータセットの作成](data-prep-creating-datasets.md)」を参照してください。

**アクションを個別にインポートするには (コンソール)**

1. [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home) で Amazon Personalize コンソールを開き、アカウントにサインインします。

1. **[データセットグループ]** ページで、追加する Actions データセットを含むデータセットグループを選択します。

1. ナビゲーションペインで、**[データセット]** を選択します。

1. **[データセット]** ページで、Actions データセットを選択します。

1. データセットの詳細のページの右上で、**[Modify dataset]** (データセットを変更) を選択し、**[Create record]** (レコードを作成) を選択します。

1. **[アクションレコードを作成]** ページの **[レコードの入力]** で、アクションの詳細を JSON 形式で入力します。アクションのフィールドの名前と値は、Actions データセットを作成したときに使用したスキーマと一致する必要があります。Amazon Personalize は、このスキーマのフィールド名とデータ型を含む JSON テンプレートを提供します。

1. **[Create record(s)]** (レコードを作成) を選択します。**[レスポンス]** では、インポートの結果が一覧表示され、成功または失敗のメッセージが表示されます。

## アクションの個別のインポート (AWS CLI)
<a name="importing-actions-cli"></a>

`PutActions` API 操作を使用して、1 つ以上のアクションを Actions データセットに追加します。一度に最大 10 個のアクションをインポートできます。このセクションでは、Actions データセットが既に作成されていることを前提としています。データセットの作成については、「[スキーマとデータセットの作成](data-prep-creating-datasets.md)」を参照してください。

次の `put-actions` コマンドを使用して、 AWS CLIで 1 つ以上のアクションを追加します。`dataset arn` をデータセットの Amazon リソースネーム (ARN) に、`actionId` をアクションの ID に、それぞれ置き換えます。同じ `actionId` を持つアクションが既に Actions データセットにある場合、Amazon Personalize はそれを新しいものに置き換えます。

`properties` の場合、Actions データセットの各フィールドについて、`propertyName` を、スキーマのフィールド名 (キャメルケース) に置き換えます。例えば、ACTION\$1EXPIRATION\$1TIMESTAMP は `actionExpirationTimestamp` になり、CREATION\$1TIMESTAMP は creationTimestamp になります。`property data` をプロパティのデータに置き換えます。

```
aws personalize-events put-actions \
  --dataset-arn dataset arn \
  --actions '[{
      "actionId": "actionId", 
      "properties": "{\"propertyName\": "\property data\"}" 
    }, 
    {
      "actionId": "actionId", 
      "properties": "{\"propertyName\": "\property data\"}" 
    }]'
```

## アクションを個別にインポートAWS SDKs)
<a name="importing-actions-cli-sdk"></a>

PutActions 操作を使用して、1 つ以上のアクションを Actions データセットに追加します。1 回の `PutActions` 呼び出しで最大 10 のアクションをインポートできます。同じ `actionId` を持つアクションが既に Actions データセットにある場合、Amazon Personalize はそれを新しいものに置き換えます。このセクションでは、Actions データセットが既に作成されていることを前提としています。データセットの作成については、「[スキーマとデータセットの作成](data-prep-creating-datasets.md)」を参照してください。

 次のコードは、1 つ以上のアクションを Actions データセットに追加する方法を示しています。アクションごとに、`actionId` を指定します。同じ `actionId` を持つアクションが既に Actions データセットにある場合、Amazon Personalize はそれを新しいものに置き換えます。`properties` の場合、Actions データセットの各追加フィールドについて、`propertyName` を、スキーマのフィールド名 (キャメルケース) に置き換えます。例えば、ACTION\$1EXPIRATION\$1TIMESTAMP は `actionExpirationTimestamp` になり、CREATION\$1TIMESTAMP は creationTimestamp になります。`property data` をプロパティのデータに置き換えます。

```
import boto3

personalize_events = boto3.client(service_name='personalize-events')

personalize_events.put_actions(
    datasetArn = 'dataset arn',
    actions = [{
      'actionId': 'actionId',
      'properties': "{\"propertyName\": \"property value\"}"   
      },
      {
      'actionId': 'actionId',
      'properties': "{\"propertyName\": \"property value\"}"   
      }]
)
```