Amazon Personalize Events Update: Adds new APIs to write item and user records to Datasets.

Author: AWS

.changes/next-release/feature-AmazonPersonalizeEvents-2c148a3.json

@@ -0,0 +1,5 @@
+{
+    "type": "feature",
+    "category": "Amazon Personalize Events",
+    "description": "Adds new APIs to write item and user records to Datasets."
+}

services/personalizeevents/src/main/resources/codegen-resources/service-2.json

@@ -23,9 +23,40 @@
         {"shape":"InvalidInputException"}
       ],
       "documentation":"<p>Records user interaction event data. For more information see <a>event-record-api</a>.</p>"
+    },
+    "PutItems":{
+      "name":"PutItems",
+      "http":{
+        "method":"POST",
+        "requestUri":"/items"
+      },
+      "input":{"shape":"PutItemsRequest"},
+      "errors":[
+        {"shape":"InvalidInputException"},
+        {"shape":"ResourceNotFoundException"}
+      ],
+      "documentation":"<p>Adds one or more items to an Items dataset. For more information see <a>importing-items</a>.</p>"
+    },
+    "PutUsers":{
+      "name":"PutUsers",
+      "http":{
+        "method":"POST",
+        "requestUri":"/users"
+      },
+      "input":{"shape":"PutUsersRequest"},
+      "errors":[
+        {"shape":"InvalidInputException"},
+        {"shape":"ResourceNotFoundException"}
+      ],
+      "documentation":"<p>Adds one or more users to a Users dataset. For more information see <a>importing-users</a>.</p>"
     }
   },
   "shapes":{
+    "Arn":{
+      "type":"string",
+      "max":256,
+      "pattern":"arn:([a-z\\d-]+):personalize:.*:.*:.+"
+    },
     "Date":{"type":"timestamp"},
     "ErrorMessage":{"type":"string"},
     "Event":{
@@ -41,7 +72,7 @@
         },
         "eventType":{
           "shape":"StringType",
-          "documentation":"<p>The type of event. This property corresponds to the <code>EVENT_TYPE</code> field of the Interactions schema.</p>"
+          "documentation":"<p>The type of event, such as click or download. This property corresponds to the <code>EVENT_TYPE</code> field of your Interactions schema and depends on the types of events you are tracking.</p>"
         },
         "eventValue":{
           "shape":"FloatType",
@@ -98,11 +129,38 @@
       "error":{"httpStatusCode":400},
       "exception":true
     },
+    "Item":{
+      "type":"structure",
+      "required":["itemId"],
+      "members":{
+        "itemId":{
+          "shape":"StringType",
+          "documentation":"<p>The ID associated with the item.</p>"
+        },
+        "properties":{
+          "shape":"ItemProperties",
+          "documentation":"<p>A string map of item-specific metadata. Each element in the map consists of a key-value pair. For example, </p> <p> <code>{\"numberOfRatings\": \"12\"}</code> </p> <p>The keys use camel case names that match the fields in the Items schema. In the above example, the <code>numberOfRatings</code> would match the 'NUMBER_OF_RATINGS' field defined in the Items schema.</p>",
+          "jsonvalue":true
+        }
+      },
+      "documentation":"<p>Represents item metadata added to an Items dataset using the <code>PutItems</code> API.</p>"
+    },
     "ItemId":{
       "type":"string",
       "max":256,
       "min":1
     },
+    "ItemList":{
+      "type":"list",
+      "member":{"shape":"Item"},
+      "max":10,
+      "min":1
+    },
+    "ItemProperties":{
+      "type":"string",
+      "max":1024,
+      "min":1
+    },
     "PutEventsRequest":{
       "type":"structure",
       "required":[
@@ -129,20 +187,90 @@
         }
       }
     },
+    "PutItemsRequest":{
+      "type":"structure",
+      "required":[
+        "datasetArn",
+        "items"
+      ],
+      "members":{
+        "datasetArn":{
+          "shape":"Arn",
+          "documentation":"<p>The Amazon Resource Number (ARN) of the Items dataset you are adding the item or items to.</p>"
+        },
+        "items":{
+          "shape":"ItemList",
+          "documentation":"<p>A list of item data.</p>"
+        }
+      }
+    },
+    "PutUsersRequest":{
+      "type":"structure",
+      "required":[
+        "datasetArn",
+        "users"
+      ],
+      "members":{
+        "datasetArn":{
+          "shape":"Arn",
+          "documentation":"<p>The Amazon Resource Number (ARN) of the Users dataset you are adding the user or users to.</p>"
+        },
+        "users":{
+          "shape":"UserList",
+          "documentation":"<p>A list of user data.</p>"
+        }
+      }
+    },
     "RecommendationId":{
       "type":"string",
       "max":40,
       "min":1
     },
+    "ResourceNotFoundException":{
+      "type":"structure",
+      "members":{
+        "message":{"shape":"ErrorMessage"}
+      },
+      "documentation":"<p>Could not find the specified resource.</p>",
+      "error":{"httpStatusCode":404},
+      "exception":true
+    },
     "StringType":{
       "type":"string",
       "max":256,
       "min":1
     },
+    "User":{
+      "type":"structure",
+      "required":["userId"],
+      "members":{
+        "userId":{
+          "shape":"StringType",
+          "documentation":"<p>The ID associated with the user.</p>"
+        },
+        "properties":{
+          "shape":"UserProperties",
+          "documentation":"<p>A string map of user-specific metadata. Each element in the map consists of a key-value pair. For example, </p> <p> <code>{\"numberOfVideosWatched\": \"45\"}</code> </p> <p>The keys use camel case names that match the fields in the Users schema. In the above example, the <code>numberOfVideosWatched</code> would match the 'NUMBER_OF_VIDEOS_WATCHED' field defined in the Users schema.</p>",
+          "jsonvalue":true
+        }
+      },
+      "documentation":"<p>Represents user metadata added to a Users dataset using the <code>PutUsers</code> API.</p>"
+    },
     "UserId":{
       "type":"string",
       "max":256,
       "min":1
+    },
+    "UserList":{
+      "type":"list",
+      "member":{"shape":"User"},
+      "max":10,
+      "min":1
+    },
+    "UserProperties":{
+      "type":"string",
+      "max":1024,
+      "min":1
     }
   },
   "documentation":"<p>Amazon Personalize can consume real-time user event data, such as <i>stream</i> or <i>click</i> data, and use it for model training either alone or combined with historical data. For more information see <a>recording-events</a>.</p>"