Métriques des requêtes

Interrogez les métriques sur les données de conversation que vous avez dans CX Insights. Ces métriques incluent, par exemple, le nombre total de conversations, le pourcentage moyen de silence et la durée moyenne des conversations.

Prérequis

Contactez votre représentant Google pour activer cette fonctionnalité dans votre projet.

Métriques des requêtes

L'exemple de code suivant montre comment interroger les métriques. Un filtre de date de création de conversation est toujours requis. Pour en savoir plus sur ce filtre, consultez la section Lister les conversations.

Toutes les métriques

Obtenez toutes les métriques.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

PROJECT_ID : ID de votre projet.
MIN_TIMESTAMP : filtre d'horodatage minimal. Par exemple, YYYY-MM-DDT00:00:00+00.
MAX_TIMESTAMP : filtre d'horodatage maximal. Par exemple, YYYY-MM-DDT00:00:00+00.

Méthode HTTP et URL :

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics

Corps JSON de la requête :

{
  "filter": "create_time>='MIN_TIMESTAMP' create_time<'MAX_TIMESTAMP'"
}

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics"

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
  }
}

Toutes les métriques regroupées par thème

Obtenez toutes les métriques regroupées par thème. Pour en savoir plus sur les thèmes, consultez la présentation de la modélisation thématique.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

PROJECT_ID : ID de votre projet.
MIN_TIMESTAMP : filtre d'horodatage minimal. Par exemple, YYYY-MM-DDT00:00:00+00.
MAX_TIMESTAMP : filtre d'horodatage maximal. Par exemple, YYYY-MM-DDT00:00:00+00.

Méthode HTTP et URL :

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics

Corps JSON de la requête :

{
  "filter": "create_time>='MIN_TIMESTAMP' create_time<'MAX_TIMESTAMP'",
  "dimensions": [{ "dimensionKey": "ISSUE" }]
}

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
  }
}

Toutes les métriques d'une série temporelle quotidienne

Obtenez toutes les métriques sur une série temporelle quotidienne. Chaque point de données de la série temporelle représente une journée de métriques.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

PROJECT_ID : ID de votre projet.
MIN_TIMESTAMP : filtre d'horodatage minimal. Par exemple, YYYY-MM-DDT00:00:00+00.
MAX_TIMESTAMP : filtre d'horodatage maximal. Par exemple, YYYY-MM-DDT00:00:00+00.

Méthode HTTP et URL :

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics

Corps JSON de la requête :

{
  "filter": "create_time>='MIN_TIMESTAMP' create_time<'MAX_TIMESTAMP'",
  "timeGranularity": "DAILY"
}

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
  }
}

Toutes les métriques regroupées par thème dans une série temporelle quotidienne

Obtenez toutes les métriques regroupées par thèmes dans une série temporelle quotidienne. Chaque point de données de la série temporelle représente les métriques d'une journée. Pour en savoir plus sur les thèmes, consultez la présentation de la modélisation thématique.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

PROJECT_ID : ID de votre projet.
MIN_TIMESTAMP : filtre d'horodatage minimal. Par exemple, YYYY-MM-DDT00:00:00+00.
MAX_TIMESTAMP : filtre d'horodatage maximal. Par exemple, YYYY-MM-DDT00:00:00+00.

Méthode HTTP et URL :

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics

Corps JSON de la requête :

{
  "filter": "create_time>='MIN_TIMESTAMP' create_time<'MAX_TIMESTAMP'",
  "dimensions": [{ "dimensionKey": "ISSUE" }],
  "timeGranularity": "DAILY"
}

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
  }
}

Métriques des requêtes Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Prérequis

Métriques des requêtes

Toutes les métriques

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Toutes les métriques regroupées par thème

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Toutes les métriques d'une série temporelle quotidienne

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Toutes les métriques regroupées par thème dans une série temporelle quotidienne

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Métriques des requêtes