aws-sdk-personalizeevents 1.11.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdabd33d4876d4dc07e4ea82f8e9d4b0c1b8edb8eb4795180c3cb25f25ba8149
-  data.tar.gz: 0b1495a68a5f8406a1c22814786250b688bf5930152250bb33a13e483fa2832b
+  metadata.gz: fd0b533a3d346ed3c67f830a2c38cabdfc0511d066300b02da789f943d67bf09
+  data.tar.gz: f02cc1929f8f100e052bcd6f276c1989bb82f38bc91983692c7c2768eeaa8fa3
 SHA512:
-  metadata.gz: 75ce5ca7c7654eadf33328c3936000b929f44b68faf14f8282e5ad27342e3ba84016d4760fa7affc6fa96cd0536b870a66fd50c185ae544c2f33b3d0f966dec4
-  data.tar.gz: 3959f6f2ac5d74e804932bbb5345c886f08d87363114b46a1c5eec10bed7541a983b480b8bd0095e586d162f36075bd58db3d17db050c7aca2bf52db65508616
+  metadata.gz: ac25c1b66a5c3581e5d6f000e632fe170b19916820159a731913a8775e0f7a79293873bbe8b94fc43cdba4e715fd04903be3b1a49d50972e8cfe0ecb1764ff1b
+  data.tar.gz: 0a6ee1743805f2e12e0407d7c737dc6803592e7f1e135b64dae43ca54a67821d5145ba90efc4c96bea78eef25d2095ffc96f09df899f62b1e30ad6a54179e648

data/lib/aws-sdk-personalizeevents.rb

@@ -7,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
@@ -47,6 +48,6 @@ require_relative 'aws-sdk-personalizeevents/customizations'
 # @!group service
 module Aws::PersonalizeEvents
 
-  GEM_VERSION = '1.11.0'
+  GEM_VERSION = '1.16.0'
 
 end

data/lib/aws-sdk-personalizeevents/client.rb

@@ -328,7 +328,11 @@ module Aws::PersonalizeEvents
     # @!group API Operations
 
     # Records user interaction event data. For more information see
-    # event-record-api.
+    # [Recording Events][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html
     #
     # @option params [required, String] :tracking_id
     #   The tracking ID for the event. The ID is generated by a call to the
@@ -345,8 +349,12 @@ module Aws::PersonalizeEvents
     #   The session ID associated with the user's visit. Your application
     #   generates the sessionId when a user first visits your website or uses
     #   your application. Amazon Personalize uses the sessionId to associate
-    #   events with the user before they log in. For more information see
-    #   event-record-api.
+    #   events with the user before they log in. For more information, see
+    #   [Recording Events][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html
     #
     # @option params [required, Array<Types::Event>] :event_list
     #   A list of event data from the session.
@@ -382,6 +390,80 @@ module Aws::PersonalizeEvents
       req.send_request(options)
     end
 
+    # Adds one or more items to an Items dataset. For more information see
+    # [Importing Items Incrementally][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html
+    #
+    # @option params [required, String] :dataset_arn
+    #   The Amazon Resource Name (ARN) of the Items dataset you are adding the
+    #   item or items to.
+    #
+    # @option params [required, Array<Types::Item>] :items
+    #   A list of item data.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_items({
+    #     dataset_arn: "Arn", # required
+    #     items: [ # required
+    #       {
+    #         item_id: "StringType", # required
+    #         properties: "ItemProperties",
+    #       },
+    #     ],
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-events-2018-03-22/PutItems AWS API Documentation
+    #
+    # @overload put_items(params = {})
+    # @param [Hash] params ({})
+    def put_items(params = {}, options = {})
+      req = build_request(:put_items, params)
+      req.send_request(options)
+    end
+
+    # Adds one or more users to a Users dataset. For more information see
+    # [Importing Users Incrementally][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/importing-users.html
+    #
+    # @option params [required, String] :dataset_arn
+    #   The Amazon Resource Name (ARN) of the Users dataset you are adding the
+    #   user or users to.
+    #
+    # @option params [required, Array<Types::User>] :users
+    #   A list of user data.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_users({
+    #     dataset_arn: "Arn", # required
+    #     users: [ # required
+    #       {
+    #         user_id: "StringType", # required
+    #         properties: "UserProperties",
+    #       },
+    #     ],
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-events-2018-03-22/PutUsers AWS API Documentation
+    #
+    # @overload put_users(params = {})
+    # @param [Hash] params ({})
+    def put_users(params = {}, options = {})
+      req = build_request(:put_users, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -395,7 +477,7 @@ module Aws::PersonalizeEvents
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalizeevents'
-      context[:gem_version] = '1.11.0'
+      context[:gem_version] = '1.16.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-personalizeevents/client_api.rb

@@ -13,6 +13,7 @@ module Aws::PersonalizeEvents
 
     include Seahorse::Model
 
+    Arn = Shapes::StringShape.new(name: 'Arn')
     Date = Shapes::TimestampShape.new(name: 'Date')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
     Event = Shapes::StructureShape.new(name: 'Event')
@@ -21,11 +22,21 @@ module Aws::PersonalizeEvents
     FloatType = Shapes::FloatShape.new(name: 'FloatType')
     Impression = Shapes::ListShape.new(name: 'Impression')
     InvalidInputException = Shapes::StructureShape.new(name: 'InvalidInputException')
+    Item = Shapes::StructureShape.new(name: 'Item')
     ItemId = Shapes::StringShape.new(name: 'ItemId')
+    ItemList = Shapes::ListShape.new(name: 'ItemList')
+    ItemProperties = Shapes::StringShape.new(name: 'ItemProperties')
     PutEventsRequest = Shapes::StructureShape.new(name: 'PutEventsRequest')
+    PutItemsRequest = Shapes::StructureShape.new(name: 'PutItemsRequest')
+    PutUsersRequest = Shapes::StructureShape.new(name: 'PutUsersRequest')
     RecommendationId = Shapes::StringShape.new(name: 'RecommendationId')
+    ResourceInUseException = Shapes::StructureShape.new(name: 'ResourceInUseException')
+    ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     StringType = Shapes::StringShape.new(name: 'StringType')
+    User = Shapes::StructureShape.new(name: 'User')
     UserId = Shapes::StringShape.new(name: 'UserId')
+    UserList = Shapes::ListShape.new(name: 'UserList')
+    UserProperties = Shapes::StringShape.new(name: 'UserProperties')
 
     Event.add_member(:event_id, Shapes::ShapeRef.new(shape: StringType, location_name: "eventId"))
     Event.add_member(:event_type, Shapes::ShapeRef.new(shape: StringType, required: true, location_name: "eventType"))
@@ -44,12 +55,38 @@ module Aws::PersonalizeEvents
     InvalidInputException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
     InvalidInputException.struct_class = Types::InvalidInputException
 
+    Item.add_member(:item_id, Shapes::ShapeRef.new(shape: StringType, required: true, location_name: "itemId"))
+    Item.add_member(:properties, Shapes::ShapeRef.new(shape: ItemProperties, location_name: "properties", metadata: {"jsonvalue"=>true}))
+    Item.struct_class = Types::Item
+
+    ItemList.member = Shapes::ShapeRef.new(shape: Item)
+
     PutEventsRequest.add_member(:tracking_id, Shapes::ShapeRef.new(shape: StringType, required: true, location_name: "trackingId"))
     PutEventsRequest.add_member(:user_id, Shapes::ShapeRef.new(shape: UserId, location_name: "userId"))
     PutEventsRequest.add_member(:session_id, Shapes::ShapeRef.new(shape: StringType, required: true, location_name: "sessionId"))
     PutEventsRequest.add_member(:event_list, Shapes::ShapeRef.new(shape: EventList, required: true, location_name: "eventList"))
     PutEventsRequest.struct_class = Types::PutEventsRequest
 
+    PutItemsRequest.add_member(:dataset_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "datasetArn"))
+    PutItemsRequest.add_member(:items, Shapes::ShapeRef.new(shape: ItemList, required: true, location_name: "items"))
+    PutItemsRequest.struct_class = Types::PutItemsRequest
+
+    PutUsersRequest.add_member(:dataset_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "datasetArn"))
+    PutUsersRequest.add_member(:users, Shapes::ShapeRef.new(shape: UserList, required: true, location_name: "users"))
+    PutUsersRequest.struct_class = Types::PutUsersRequest
+
+    ResourceInUseException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
+    ResourceInUseException.struct_class = Types::ResourceInUseException
+
+    ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
+    ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
+
+    User.add_member(:user_id, Shapes::ShapeRef.new(shape: StringType, required: true, location_name: "userId"))
+    User.add_member(:properties, Shapes::ShapeRef.new(shape: UserProperties, location_name: "properties", metadata: {"jsonvalue"=>true}))
+    User.struct_class = Types::User
+
+    UserList.member = Shapes::ShapeRef.new(shape: User)
+
 
     # @api private
     API = Seahorse::Model::Api.new.tap do |api|
@@ -76,6 +113,28 @@ module Aws::PersonalizeEvents
         o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
         o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
       end)
+
+      api.add_operation(:put_items, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutItems"
+        o.http_method = "POST"
+        o.http_request_uri = "/items"
+        o.input = Shapes::ShapeRef.new(shape: PutItemsRequest)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
+      end)
+
+      api.add_operation(:put_users, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutUsers"
+        o.http_method = "POST"
+        o.http_request_uri = "/users"
+        o.input = Shapes::ShapeRef.new(shape: PutUsersRequest)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
+      end)
     end
 
   end

data/lib/aws-sdk-personalizeevents/errors.rb

@@ -28,6 +28,8 @@ module Aws::PersonalizeEvents
   #
   # ## Error Classes
   # * {InvalidInputException}
+  # * {ResourceInUseException}
+  # * {ResourceNotFoundException}
   #
   # Additionally, error classes are dynamically generated for service errors based on the error code
   # if they are not defined above.
@@ -50,5 +52,35 @@ module Aws::PersonalizeEvents
       end
     end
 
+    class ResourceInUseException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::PersonalizeEvents::Types::ResourceInUseException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
+    class ResourceNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::PersonalizeEvents::Types::ResourceNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
   end
 end

data/lib/aws-sdk-personalizeevents/types.rb

@@ -36,8 +36,9 @@ module Aws::PersonalizeEvents
     #   @return [String]
     #
     # @!attribute [rw] event_type
-    #   The type of event. This property corresponds to the `EVENT_TYPE`
-    #   field of the Interactions schema.
+    #   The type of event, such as click or download. This property
+    #   corresponds to the `EVENT_TYPE` field of your Interactions schema
+    #   and depends on the types of events you are tracking.
     #   @return [String]
     #
     # @!attribute [rw] event_value
@@ -108,6 +109,48 @@ module Aws::PersonalizeEvents
       include Aws::Structure
     end
 
+    # Represents item metadata added to an Items dataset using the
+    # `PutItems` API. For more information see [Importing Items
+    # Incrementally][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html
+    #
+    # @note When making an API call, you may pass Item
+    #   data as a hash:
+    #
+    #       {
+    #         item_id: "StringType", # required
+    #         properties: "ItemProperties",
+    #       }
+    #
+    # @!attribute [rw] item_id
+    #   The ID associated with the item.
+    #   @return [String]
+    #
+    # @!attribute [rw] properties
+    #   A string map of item-specific metadata. Each element in the map
+    #   consists of a key-value pair. For example, `\{"numberOfRatings":
+    #   "12"\}`.
+    #
+    #   The keys use camel case names that match the fields in the schema
+    #   for the Items dataset. In the previous example, the
+    #   `numberOfRatings` matches the 'NUMBER\_OF\_RATINGS' field defined
+    #   in the Items schema. For categorical string data, to include
+    #   multiple categories for a single item, separate each category with a
+    #   pipe separator (`|`). For example, `"Horror|Action"`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-events-2018-03-22/Item AWS API Documentation
+    #
+    class Item < Struct.new(
+      :item_id,
+      :properties)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass PutEventsRequest
     #   data as a hash:
     #
@@ -147,7 +190,11 @@ module Aws::PersonalizeEvents
     #   generates the sessionId when a user first visits your website or
     #   uses your application. Amazon Personalize uses the sessionId to
     #   associate events with the user before they log in. For more
-    #   information see event-record-api.
+    #   information, see [Recording Events][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html
     #   @return [String]
     #
     # @!attribute [rw] event_list
@@ -165,5 +212,135 @@ module Aws::PersonalizeEvents
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass PutItemsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         dataset_arn: "Arn", # required
+    #         items: [ # required
+    #           {
+    #             item_id: "StringType", # required
+    #             properties: "ItemProperties",
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] dataset_arn
+    #   The Amazon Resource Name (ARN) of the Items dataset you are adding
+    #   the item or items to.
+    #   @return [String]
+    #
+    # @!attribute [rw] items
+    #   A list of item data.
+    #   @return [Array<Types::Item>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-events-2018-03-22/PutItemsRequest AWS API Documentation
+    #
+    class PutItemsRequest < Struct.new(
+      :dataset_arn,
+      :items)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass PutUsersRequest
+    #   data as a hash:
+    #
+    #       {
+    #         dataset_arn: "Arn", # required
+    #         users: [ # required
+    #           {
+    #             user_id: "StringType", # required
+    #             properties: "UserProperties",
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] dataset_arn
+    #   The Amazon Resource Name (ARN) of the Users dataset you are adding
+    #   the user or users to.
+    #   @return [String]
+    #
+    # @!attribute [rw] users
+    #   A list of user data.
+    #   @return [Array<Types::User>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-events-2018-03-22/PutUsersRequest AWS API Documentation
+    #
+    class PutUsersRequest < Struct.new(
+      :dataset_arn,
+      :users)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The specified resource is in use.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-events-2018-03-22/ResourceInUseException AWS API Documentation
+    #
+    class ResourceInUseException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Could not find the specified resource.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-events-2018-03-22/ResourceNotFoundException AWS API Documentation
+    #
+    class ResourceNotFoundException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Represents user metadata added to a Users dataset using the `PutUsers`
+    # API. For more information see [Importing Users Incrementally][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/importing-users.html
+    #
+    # @note When making an API call, you may pass User
+    #   data as a hash:
+    #
+    #       {
+    #         user_id: "StringType", # required
+    #         properties: "UserProperties",
+    #       }
+    #
+    # @!attribute [rw] user_id
+    #   The ID associated with the user.
+    #   @return [String]
+    #
+    # @!attribute [rw] properties
+    #   A string map of user-specific metadata. Each element in the map
+    #   consists of a key-value pair. For example,
+    #   `\{"numberOfVideosWatched": "45"\}`.
+    #
+    #   The keys use camel case names that match the fields in the schema
+    #   for the Users dataset. In the previous example, the
+    #   `numberOfVideosWatched` matches the 'NUMBER\_OF\_VIDEOS\_WATCHED'
+    #   field defined in the Users schema. For categorical string data, to
+    #   include multiple categories for a single user, separate each
+    #   category with a pipe separator (`|`). For example,
+    #   `"Member|Frequent shopper"`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-events-2018-03-22/User AWS API Documentation
+    #
+    class User < Struct.new(
+      :user_id,
+      :properties)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-personalizeevents
 version: !ruby/object:Gem::Version
-  version: 1.11.0
+  version: 1.16.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-08-25 00:00:00.000000000 Z
+date: 2021-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.99.0
+        version: 3.112.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.99.0
+        version: 3.112.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement