:doc:`TranscribeService <../../transcribe>` / Client / update_call_analytics_category

******************************
update_call_analytics_category
******************************



.. py:method:: TranscribeService.Client.update_call_analytics_category(**kwargs)

  

  Updates the specified Call Analytics category with new rules. Note that the ``UpdateCallAnalyticsCategory`` operation overwrites all existing rules contained in the specified category. You cannot append additional rules onto an existing category.

   

  To create a new category, see .

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/UpdateCallAnalyticsCategory>`_  


  **Request Syntax**
  ::

    response = client.update_call_analytics_category(
        CategoryName='string',
        Rules=[
            {
                'NonTalkTimeFilter': {
                    'Threshold': 123,
                    'AbsoluteTimeRange': {
                        'StartTime': 123,
                        'EndTime': 123,
                        'First': 123,
                        'Last': 123
                    },
                    'RelativeTimeRange': {
                        'StartPercentage': 123,
                        'EndPercentage': 123,
                        'First': 123,
                        'Last': 123
                    },
                    'Negate': True|False
                },
                'InterruptionFilter': {
                    'Threshold': 123,
                    'ParticipantRole': 'AGENT'|'CUSTOMER',
                    'AbsoluteTimeRange': {
                        'StartTime': 123,
                        'EndTime': 123,
                        'First': 123,
                        'Last': 123
                    },
                    'RelativeTimeRange': {
                        'StartPercentage': 123,
                        'EndPercentage': 123,
                        'First': 123,
                        'Last': 123
                    },
                    'Negate': True|False
                },
                'TranscriptFilter': {
                    'TranscriptFilterType': 'EXACT',
                    'AbsoluteTimeRange': {
                        'StartTime': 123,
                        'EndTime': 123,
                        'First': 123,
                        'Last': 123
                    },
                    'RelativeTimeRange': {
                        'StartPercentage': 123,
                        'EndPercentage': 123,
                        'First': 123,
                        'Last': 123
                    },
                    'ParticipantRole': 'AGENT'|'CUSTOMER',
                    'Negate': True|False,
                    'Targets': [
                        'string',
                    ]
                },
                'SentimentFilter': {
                    'Sentiments': [
                        'POSITIVE'|'NEGATIVE'|'NEUTRAL'|'MIXED',
                    ],
                    'AbsoluteTimeRange': {
                        'StartTime': 123,
                        'EndTime': 123,
                        'First': 123,
                        'Last': 123
                    },
                    'RelativeTimeRange': {
                        'StartPercentage': 123,
                        'EndPercentage': 123,
                        'First': 123,
                        'Last': 123
                    },
                    'ParticipantRole': 'AGENT'|'CUSTOMER',
                    'Negate': True|False
                }
            },
        ],
        InputType='REAL_TIME'|'POST_CALL'
    )
    
  :type CategoryName: string
  :param CategoryName: **[REQUIRED]** 

    The name of the Call Analytics category you want to update. Category names are case sensitive.

    

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

    The rules used for the updated Call Analytics category. The rules you provide in this field replace the ones that are currently being used in the specified category.

    

  
    - *(dict) --* 

      A rule is a set of criteria that you can specify to flag an attribute in your Call Analytics output. Rules define a Call Analytics category.

       

      Rules can include these parameters: , , , and .

       

      To learn more about Call Analytics rules and categories, see `Creating categories for post-call transcriptions <https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-batch.html>`__ and `Creating categories for real-time transcriptions <https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-stream.html>`__.

       

      To learn more about Call Analytics, see `Analyzing call center audio with Call Analytics <https://docs.aws.amazon.com/transcribe/latest/dg/call-analytics.html>`__.

      .. note::    This is a Tagged Union structure. Only one of the     following top level keys can be set: ``NonTalkTimeFilter``, ``InterruptionFilter``, ``TranscriptFilter``, ``SentimentFilter``. 

    
      - **NonTalkTimeFilter** *(dict) --* 

        Flag the presence or absence of periods of silence in your Call Analytics transcription output. Refer to for more detail.

        

      
        - **Threshold** *(integer) --* 

          Specify the duration, in milliseconds, of the period of silence that you want to flag. For example, you can flag a silent period that lasts 30,000 milliseconds.

          

        
        - **AbsoluteTimeRange** *(dict) --* 

          Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for a period of silence. See for more detail.

          

        
          - **StartTime** *(integer) --* 

            The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include ``StartTime`` in your request, you must also include ``EndTime``.

            

          
          - **EndTime** *(integer) --* 

            The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include ``EndTime`` in your request, you must also include ``StartTime``.

            

          
          - **First** *(integer) --* 

            The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
          - **Last** *(integer) --* 

            The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
        
        - **RelativeTimeRange** *(dict) --* 

          Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for a period of silence. See for more detail.

          

        
          - **StartPercentage** *(integer) --* 

            The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include ``StartPercentage`` in your request, you must also include ``EndPercentage``.

            

          
          - **EndPercentage** *(integer) --* 

            The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include ``EndPercentage`` in your request, you must also include ``StartPercentage``.

            

          
          - **First** *(integer) --* 

            The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
          - **Last** *(integer) --* 

            The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
        
        - **Negate** *(boolean) --* 

          Set to ``TRUE`` to flag periods of speech. Set to ``FALSE`` to flag periods of silence

          

        
      
      - **InterruptionFilter** *(dict) --* 

        Flag the presence or absence of interruptions in your Call Analytics transcription output. Refer to for more detail.

        

      
        - **Threshold** *(integer) --* 

          Specify the duration of the interruptions in milliseconds. For example, you can flag speech that contains more than 10,000 milliseconds of interruptions.

          

        
        - **ParticipantRole** *(string) --* 

          Specify the interrupter that you want to flag. Omitting this parameter is equivalent to specifying both participants.

          

        
        - **AbsoluteTimeRange** *(dict) --* 

          Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for an interruption. See for more detail.

          

        
          - **StartTime** *(integer) --* 

            The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include ``StartTime`` in your request, you must also include ``EndTime``.

            

          
          - **EndTime** *(integer) --* 

            The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include ``EndTime`` in your request, you must also include ``StartTime``.

            

          
          - **First** *(integer) --* 

            The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
          - **Last** *(integer) --* 

            The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
        
        - **RelativeTimeRange** *(dict) --* 

          Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for an interruption. See for more detail.

          

        
          - **StartPercentage** *(integer) --* 

            The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include ``StartPercentage`` in your request, you must also include ``EndPercentage``.

            

          
          - **EndPercentage** *(integer) --* 

            The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include ``EndPercentage`` in your request, you must also include ``StartPercentage``.

            

          
          - **First** *(integer) --* 

            The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
          - **Last** *(integer) --* 

            The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
        
        - **Negate** *(boolean) --* 

          Set to ``TRUE`` to flag speech that does not contain interruptions. Set to ``FALSE`` to flag speech that contains interruptions.

          

        
      
      - **TranscriptFilter** *(dict) --* 

        Flag the presence or absence of specific words or phrases in your Call Analytics transcription output. Refer to for more detail.

        

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

          Flag the presence or absence of an exact match to the phrases that you specify. For example, if you specify the phrase "speak to a manager" as your ``Targets`` value, only that exact phrase is flagged.

           

          Note that semantic matching is not supported. For example, if your customer says "speak to *the* manager", instead of "speak to *a* manager", your content is not flagged.

          

        
        - **AbsoluteTimeRange** *(dict) --* 

          Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified key words or phrases. See for more detail.

          

        
          - **StartTime** *(integer) --* 

            The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include ``StartTime`` in your request, you must also include ``EndTime``.

            

          
          - **EndTime** *(integer) --* 

            The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include ``EndTime`` in your request, you must also include ``StartTime``.

            

          
          - **First** *(integer) --* 

            The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
          - **Last** *(integer) --* 

            The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
        
        - **RelativeTimeRange** *(dict) --* 

          Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified key words or phrases. See for more detail.

          

        
          - **StartPercentage** *(integer) --* 

            The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include ``StartPercentage`` in your request, you must also include ``EndPercentage``.

            

          
          - **EndPercentage** *(integer) --* 

            The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include ``EndPercentage`` in your request, you must also include ``StartPercentage``.

            

          
          - **First** *(integer) --* 

            The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
          - **Last** *(integer) --* 

            The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
        
        - **ParticipantRole** *(string) --* 

          Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.

          

        
        - **Negate** *(boolean) --* 

          Set to ``TRUE`` to flag the absence of the phrase that you specified in your request. Set to ``FALSE`` to flag the presence of the phrase that you specified in your request.

          

        
        - **Targets** *(list) --* **[REQUIRED]** 

          Specify the phrases that you want to flag.

          

        
          - *(string) --* 

          
      
      
      - **SentimentFilter** *(dict) --* 

        Flag the presence or absence of specific sentiments in your Call Analytics transcription output. Refer to for more detail.

        

      
        - **Sentiments** *(list) --* **[REQUIRED]** 

          Specify the sentiments that you want to flag.

          

        
          - *(string) --* 

          
      
        - **AbsoluteTimeRange** *(dict) --* 

          Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified sentiments. See for more detail.

          

        
          - **StartTime** *(integer) --* 

            The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include ``StartTime`` in your request, you must also include ``EndTime``.

            

          
          - **EndTime** *(integer) --* 

            The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include ``EndTime`` in your request, you must also include ``StartTime``.

            

          
          - **First** *(integer) --* 

            The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
          - **Last** *(integer) --* 

            The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
        
        - **RelativeTimeRange** *(dict) --* 

          Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified sentiments. See for more detail.

          

        
          - **StartPercentage** *(integer) --* 

            The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include ``StartPercentage`` in your request, you must also include ``EndPercentage``.

            

          
          - **EndPercentage** *(integer) --* 

            The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include ``EndPercentage`` in your request, you must also include ``StartPercentage``.

            

          
          - **First** *(integer) --* 

            The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
          - **Last** *(integer) --* 

            The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

            

          
        
        - **ParticipantRole** *(string) --* 

          Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.

          

        
        - **Negate** *(boolean) --* 

          Set to ``TRUE`` to flag the sentiments that you didn't include in your request. Set to ``FALSE`` to flag the sentiments that you specified in your request.

          

        
      
    

  :type InputType: string
  :param InputType: 

    Choose whether you want to update a real-time or a post-call category. The input type you specify must match the input type specified when the category was created. For example, if you created a category with the ``POST_CALL`` input type, you must use ``POST_CALL`` as the input type when updating this category.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'CategoryProperties': {
              'CategoryName': 'string',
              'Rules': [
                  {
                      'NonTalkTimeFilter': {
                          'Threshold': 123,
                          'AbsoluteTimeRange': {
                              'StartTime': 123,
                              'EndTime': 123,
                              'First': 123,
                              'Last': 123
                          },
                          'RelativeTimeRange': {
                              'StartPercentage': 123,
                              'EndPercentage': 123,
                              'First': 123,
                              'Last': 123
                          },
                          'Negate': True|False
                      },
                      'InterruptionFilter': {
                          'Threshold': 123,
                          'ParticipantRole': 'AGENT'|'CUSTOMER',
                          'AbsoluteTimeRange': {
                              'StartTime': 123,
                              'EndTime': 123,
                              'First': 123,
                              'Last': 123
                          },
                          'RelativeTimeRange': {
                              'StartPercentage': 123,
                              'EndPercentage': 123,
                              'First': 123,
                              'Last': 123
                          },
                          'Negate': True|False
                      },
                      'TranscriptFilter': {
                          'TranscriptFilterType': 'EXACT',
                          'AbsoluteTimeRange': {
                              'StartTime': 123,
                              'EndTime': 123,
                              'First': 123,
                              'Last': 123
                          },
                          'RelativeTimeRange': {
                              'StartPercentage': 123,
                              'EndPercentage': 123,
                              'First': 123,
                              'Last': 123
                          },
                          'ParticipantRole': 'AGENT'|'CUSTOMER',
                          'Negate': True|False,
                          'Targets': [
                              'string',
                          ]
                      },
                      'SentimentFilter': {
                          'Sentiments': [
                              'POSITIVE'|'NEGATIVE'|'NEUTRAL'|'MIXED',
                          ],
                          'AbsoluteTimeRange': {
                              'StartTime': 123,
                              'EndTime': 123,
                              'First': 123,
                              'Last': 123
                          },
                          'RelativeTimeRange': {
                              'StartPercentage': 123,
                              'EndPercentage': 123,
                              'First': 123,
                              'Last': 123
                          },
                          'ParticipantRole': 'AGENT'|'CUSTOMER',
                          'Negate': True|False
                      }
                  },
              ],
              'CreateTime': datetime(2015, 1, 1),
              'LastUpdateTime': datetime(2015, 1, 1),
              'Tags': [
                  {
                      'Key': 'string',
                      'Value': 'string'
                  },
              ],
              'InputType': 'REAL_TIME'|'POST_CALL'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **CategoryProperties** *(dict) --* 

        Provides you with the properties of the Call Analytics category you specified in your ``UpdateCallAnalyticsCategory`` request.

        
        

        - **CategoryName** *(string) --* 

          The name of the Call Analytics category. Category names are case sensitive and must be unique within an Amazon Web Services account.

          
        

        - **Rules** *(list) --* 

          The rules used to define a Call Analytics category. Each category can have between 1 and 20 rules.

          
          

          - *(dict) --* 

            A rule is a set of criteria that you can specify to flag an attribute in your Call Analytics output. Rules define a Call Analytics category.

             

            Rules can include these parameters: , , , and .

             

            To learn more about Call Analytics rules and categories, see `Creating categories for post-call transcriptions <https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-batch.html>`__ and `Creating categories for real-time transcriptions <https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-stream.html>`__.

             

            To learn more about Call Analytics, see `Analyzing call center audio with Call Analytics <https://docs.aws.amazon.com/transcribe/latest/dg/call-analytics.html>`__.

            .. note::    This is a Tagged Union structure. Only one of the     following top level keys will be set: ``NonTalkTimeFilter``, ``InterruptionFilter``, ``TranscriptFilter``, ``SentimentFilter``.     If a client receives an unknown member it will     set ``SDK_UNKNOWN_MEMBER`` as the top level key,     which maps to the name or tag of the unknown     member. The structure of ``SDK_UNKNOWN_MEMBER`` is     as follows::

                        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}


          
            

            - **NonTalkTimeFilter** *(dict) --* 

              Flag the presence or absence of periods of silence in your Call Analytics transcription output. Refer to for more detail.

              
              

              - **Threshold** *(integer) --* 

                Specify the duration, in milliseconds, of the period of silence that you want to flag. For example, you can flag a silent period that lasts 30,000 milliseconds.

                
              

              - **AbsoluteTimeRange** *(dict) --* 

                Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for a period of silence. See for more detail.

                
                

                - **StartTime** *(integer) --* 

                  The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include ``StartTime`` in your request, you must also include ``EndTime``.

                  
                

                - **EndTime** *(integer) --* 

                  The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include ``EndTime`` in your request, you must also include ``StartTime``.

                  
                

                - **First** *(integer) --* 

                  The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

                  
                

                - **Last** *(integer) --* 

                  The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

                  
            
              

              - **RelativeTimeRange** *(dict) --* 

                Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for a period of silence. See for more detail.

                
                

                - **StartPercentage** *(integer) --* 

                  The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include ``StartPercentage`` in your request, you must also include ``EndPercentage``.

                  
                

                - **EndPercentage** *(integer) --* 

                  The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include ``EndPercentage`` in your request, you must also include ``StartPercentage``.

                  
                

                - **First** *(integer) --* 

                  The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

                  
                

                - **Last** *(integer) --* 

                  The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

                  
            
              

              - **Negate** *(boolean) --* 

                Set to ``TRUE`` to flag periods of speech. Set to ``FALSE`` to flag periods of silence

                
          
            

            - **InterruptionFilter** *(dict) --* 

              Flag the presence or absence of interruptions in your Call Analytics transcription output. Refer to for more detail.

              
              

              - **Threshold** *(integer) --* 

                Specify the duration of the interruptions in milliseconds. For example, you can flag speech that contains more than 10,000 milliseconds of interruptions.

                
              

              - **ParticipantRole** *(string) --* 

                Specify the interrupter that you want to flag. Omitting this parameter is equivalent to specifying both participants.

                
              

              - **AbsoluteTimeRange** *(dict) --* 

                Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for an interruption. See for more detail.

                
                

                - **StartTime** *(integer) --* 

                  The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include ``StartTime`` in your request, you must also include ``EndTime``.

                  
                

                - **EndTime** *(integer) --* 

                  The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include ``EndTime`` in your request, you must also include ``StartTime``.

                  
                

                - **First** *(integer) --* 

                  The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

                  
                

                - **Last** *(integer) --* 

                  The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

                  
            
              

              - **RelativeTimeRange** *(dict) --* 

                Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for an interruption. See for more detail.

                
                

                - **StartPercentage** *(integer) --* 

                  The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include ``StartPercentage`` in your request, you must also include ``EndPercentage``.

                  
                

                - **EndPercentage** *(integer) --* 

                  The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include ``EndPercentage`` in your request, you must also include ``StartPercentage``.

                  
                

                - **First** *(integer) --* 

                  The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

                  
                

                - **Last** *(integer) --* 

                  The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

                  
            
              

              - **Negate** *(boolean) --* 

                Set to ``TRUE`` to flag speech that does not contain interruptions. Set to ``FALSE`` to flag speech that contains interruptions.

                
          
            

            - **TranscriptFilter** *(dict) --* 

              Flag the presence or absence of specific words or phrases in your Call Analytics transcription output. Refer to for more detail.

              
              

              - **TranscriptFilterType** *(string) --* 

                Flag the presence or absence of an exact match to the phrases that you specify. For example, if you specify the phrase "speak to a manager" as your ``Targets`` value, only that exact phrase is flagged.

                 

                Note that semantic matching is not supported. For example, if your customer says "speak to *the* manager", instead of "speak to *a* manager", your content is not flagged.

                
              

              - **AbsoluteTimeRange** *(dict) --* 

                Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified key words or phrases. See for more detail.

                
                

                - **StartTime** *(integer) --* 

                  The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include ``StartTime`` in your request, you must also include ``EndTime``.

                  
                

                - **EndTime** *(integer) --* 

                  The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include ``EndTime`` in your request, you must also include ``StartTime``.

                  
                

                - **First** *(integer) --* 

                  The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

                  
                

                - **Last** *(integer) --* 

                  The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

                  
            
              

              - **RelativeTimeRange** *(dict) --* 

                Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified key words or phrases. See for more detail.

                
                

                - **StartPercentage** *(integer) --* 

                  The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include ``StartPercentage`` in your request, you must also include ``EndPercentage``.

                  
                

                - **EndPercentage** *(integer) --* 

                  The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include ``EndPercentage`` in your request, you must also include ``StartPercentage``.

                  
                

                - **First** *(integer) --* 

                  The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

                  
                

                - **Last** *(integer) --* 

                  The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

                  
            
              

              - **ParticipantRole** *(string) --* 

                Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.

                
              

              - **Negate** *(boolean) --* 

                Set to ``TRUE`` to flag the absence of the phrase that you specified in your request. Set to ``FALSE`` to flag the presence of the phrase that you specified in your request.

                
              

              - **Targets** *(list) --* 

                Specify the phrases that you want to flag.

                
                

                - *(string) --* 
            
          
            

            - **SentimentFilter** *(dict) --* 

              Flag the presence or absence of specific sentiments in your Call Analytics transcription output. Refer to for more detail.

              
              

              - **Sentiments** *(list) --* 

                Specify the sentiments that you want to flag.

                
                

                - *(string) --* 
            
              

              - **AbsoluteTimeRange** *(dict) --* 

                Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified sentiments. See for more detail.

                
                

                - **StartTime** *(integer) --* 

                  The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include ``StartTime`` in your request, you must also include ``EndTime``.

                  
                

                - **EndTime** *(integer) --* 

                  The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include ``EndTime`` in your request, you must also include ``StartTime``.

                  
                

                - **First** *(integer) --* 

                  The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

                  
                

                - **Last** *(integer) --* 

                  The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

                  
            
              

              - **RelativeTimeRange** *(dict) --* 

                Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified sentiments. See for more detail.

                
                

                - **StartPercentage** *(integer) --* 

                  The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include ``StartPercentage`` in your request, you must also include ``EndPercentage``.

                  
                

                - **EndPercentage** *(integer) --* 

                  The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include ``EndPercentage`` in your request, you must also include ``StartPercentage``.

                  
                

                - **First** *(integer) --* 

                  The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.

                  
                

                - **Last** *(integer) --* 

                  The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.

                  
            
              

              - **ParticipantRole** *(string) --* 

                Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.

                
              

              - **Negate** *(boolean) --* 

                Set to ``TRUE`` to flag the sentiments that you didn't include in your request. Set to ``FALSE`` to flag the sentiments that you specified in your request.

                
          
        
      
        

        - **CreateTime** *(datetime) --* 

          The date and time the specified Call Analytics category was created.

           

          Timestamps are in the format ``YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC``. For example, ``2022-05-04T12:32:58.761000-07:00`` represents 12:32 PM UTC-7 on May 4, 2022.

          
        

        - **LastUpdateTime** *(datetime) --* 

          The date and time the specified Call Analytics category was last updated.

           

          Timestamps are in the format ``YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC``. For example, ``2022-05-05T12:45:32.691000-07:00`` represents 12:45 PM UTC-7 on May 5, 2022.

          
        

        - **Tags** *(list) --* 

          The tags, each in the form of a key:value pair, assigned to the specified call analytics category.

          
          

          - *(dict) --* 

            Adds metadata, in the form of a key:value pair, to the specified resource.

             

            For example, you could add the tag ``Department:Sales`` to a resource to indicate that it pertains to your organization's sales department. You can also use tags for tag-based access control.

             

            To learn more about tagging, see `Tagging resources <https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html>`__.

            
            

            - **Key** *(string) --* 

              The first part of a key:value pair that forms a tag associated with a given resource. For example, in the tag ``Department:Sales``, the key is 'Department'.

              
            

            - **Value** *(string) --* 

              The second part of a key:value pair that forms a tag associated with a given resource. For example, in the tag ``Department:Sales``, the value is 'Sales'.

               

              Note that you can set the value of a tag to an empty string, but you can't set the value of a tag to null. Omitting the tag value is the same as using an empty string.

              
        
      
        

        - **InputType** *(string) --* 

          The input type associated with the specified category. ``POST_CALL`` refers to a category that is applied to batch transcriptions; ``REAL_TIME`` refers to a category that is applied to streaming transcriptions.

          
    
  
  **Exceptions**
  
  *   :py:class:`TranscribeService.Client.exceptions.BadRequestException`

  
  *   :py:class:`TranscribeService.Client.exceptions.LimitExceededException`

  
  *   :py:class:`TranscribeService.Client.exceptions.InternalFailureException`

  
  *   :py:class:`TranscribeService.Client.exceptions.NotFoundException`

  
  *   :py:class:`TranscribeService.Client.exceptions.ConflictException`

  