Public/Invoke-GCAnalyticsEvaluationsAggregatesQuery.ps1

<#
.SYNOPSIS
    Queries evaluation aggregate analytics.

.DESCRIPTION
    Executes an analytics query for quality evaluation aggregate metrics in Genesys Cloud.
    Returns aggregated evaluation data such as scores, counts, and completion rates.
    Calls POST /api/v2/analytics/evaluations/aggregates/query.

.PARAMETER Body
    The mandatory request body containing the analytics query definition including interval,
    granularity, groupBy, filter, and metrics.

.EXAMPLE
    $query = @{
        interval = '2024-01-01T00:00:00Z/2024-01-02T00:00:00Z'
        granularity = 'PT1H'
        metrics = @('nEvaluations', 'oTotalScore', 'oTotalCriticalScore')
    }
    Invoke-GCAnalyticsEvaluationsAggregatesQuery -Body $query

.NOTES
    Genesys Cloud API: POST /api/v2/analytics/evaluations/aggregates/query
#>

function Invoke-GCAnalyticsEvaluationsAggregatesQuery {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true)]
        [object]$Body
    )

    $endpoint = "analytics/evaluations/aggregates/query"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method POST -Body $Body
}