PersonalizeEvents / Client / put_users

put_users#

PersonalizeEvents.Client.put_users(**kwargs)#

Adds one or more users to a Users dataset. For more information see Importing Users Incrementally.

See also: AWS API Documentation

Request Syntax

response = client.put_users(
    datasetArn='string',
    users=[
        {
            'userId': 'string',
            'properties': 'string'
        },
    ]
)
Parameters:
  • datasetArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the Users dataset you are adding the user or users to.

  • users (list) –

    [REQUIRED]

    A list of user data.

    • (dict) –

      Represents user metadata added to a Users dataset using the PutUsers API. For more information see Importing Users Incrementally.

      • userId (string) – [REQUIRED]

        The ID associated with the user.

      • properties (string) –

        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\".

Returns:

None

Exceptions

  • PersonalizeEvents.Client.exceptions.InvalidInputException

  • PersonalizeEvents.Client.exceptions.ResourceNotFoundException

  • PersonalizeEvents.Client.exceptions.ResourceInUseException