Métricas de consultas

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Consulta las métricas sobre los datos de conversación que tienes en CX Insights. Estas métricas incluyen, por ejemplo, el recuento total de conversaciones, el porcentaje promedio de silencio y la duración promedio de la conversación.

Requisitos previos

Comunícate con tu representante de Google para habilitar esta función en tu proyecto.

Métricas de consultas

En la siguiente muestra de código, se muestra cómo consultar métricas. Siempre se requiere un filtro de hora de creación de la conversación. Consulta la lista de referencia de conversaciones para obtener más información sobre este filtro.

Todas las métricas

Obtén todas las métricas.

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: el ID de tu proyecto
• MIN_TIMESTAMP: un filtro de marca de tiempo mínima Por ejemplo, YYYY-MM-DDT00:00:00+00
• MAX_TIMESTAMP: un filtro de marca de tiempo máxima Por ejemplo, YYYY-MM-DDT00:00:00+00
Nota: En todos los ejemplos, se usa la instancia global de Customer Experience Insights. Consulta Regionalización para obtener instrucciones sobre el uso de instancias regionales.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Todas las métricas agrupadas por temas

Obtén todas las métricas agrupadas por temas. Consulta la descripción general del modelado de temas para obtener información sobre los temas.

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: el ID de tu proyecto
• MIN_TIMESTAMP: un filtro de marca de tiempo mínima Por ejemplo, YYYY-MM-DDT00:00:00+00
• MAX_TIMESTAMP: un filtro de marca de tiempo máxima Por ejemplo, YYYY-MM-DDT00:00:00+00
Nota: En todos los ejemplos, se usa la instancia global de Customer Experience Insights. Consulta Regionalización para obtener instrucciones sobre el uso de instancias regionales.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Todas las métricas en una serie temporal diaria

Obtén todas las métricas en una serie temporal diaria. Cada punto de datos de la serie temporal representa las métricas de un día.

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: el ID de tu proyecto
• MIN_TIMESTAMP: un filtro de marca de tiempo mínima Por ejemplo, YYYY-MM-DDT00:00:00+00
• MAX_TIMESTAMP: un filtro de marca de tiempo máxima Por ejemplo, YYYY-MM-DDT00:00:00+00

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Todas las métricas agrupadas por temas en una serie temporal diaria

Obtén todas las métricas agrupadas por temas en una serie temporal diaria. Cada punto de datos de la serie temporal representa las métricas de un día. Consulta la descripción general del modelado de temas para obtener información sobre los temas.

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: el ID de tu proyecto
• MIN_TIMESTAMP: un filtro de marca de tiempo mínima Por ejemplo, YYYY-MM-DDT00:00:00+00
• MAX_TIMESTAMP: un filtro de marca de tiempo máxima Por ejemplo, YYYY-MM-DDT00:00:00+00
Nota: En todos los ejemplos, se usa la instancia global de Customer Experience Insights. Consulta Regionalización para obtener instrucciones sobre el uso de instancias regionales.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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