:doc:`PersonalizeEvents <../../personalize-events>` / Client / put_items

*********
put_items
*********



.. py:method:: PersonalizeEvents.Client.put_items(**kwargs)

  

  Adds one or more items to an Items dataset. For more information see `Importing items individually <https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/personalize-events-2018-03-22/PutItems>`_  


  **Request Syntax**
  ::

    response = client.put_items(
        datasetArn='string',
        items=[
            {
                'itemId': 'string',
                'properties': 'string'
            },
        ]
    )
    
  :type datasetArn: string
  :param datasetArn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the Items dataset you are adding the item or items to.

    

  
  :type items: list
  :param items: **[REQUIRED]** 

    A list of item data.

    

  
    - *(dict) --* 

      Represents item metadata added to an Items dataset using the ``PutItems`` API. For more information see `Importing items individually <https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html>`__.

      

    
      - **itemId** *(string) --* **[REQUIRED]** 

        The ID associated with the item.

        

      
      - **properties** *(string) --* 

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

        

      
    

  
  :returns: None
  **Exceptions**
  
  *   :py:class:`PersonalizeEvents.Client.exceptions.InvalidInputException`

  
  *   :py:class:`PersonalizeEvents.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`PersonalizeEvents.Client.exceptions.ResourceInUseException`

  