Regionalización

Especificar una región es particularmente útil en los siguientes casos de uso:

• Tu sistema tiene requisitos regulatorios o de políticas que rigen la ubicación de tus datos.
• Las latencias de la red pueden mejorarse cuando los datos se encuentran en la misma región que tus clientes. Por ejemplo, si los clientes de Bélgica usan europe-west1, pueden esperar una mejor latencia.

Regiones disponibles

Agrupación por país	Ubicación geográfica	Extremo	Ubicación del recurso
Global	Entrega global, datos en reposo en EE.UU.	contactcenterinsights.googleapis.com	us-central1
América	Carolina del Sur	us-east1-contactcenterinsights.googleapis.com	us-east1
América	Oregón	us-west1-contactcenterinsights.googleapis.com	us-west1
América	Montreal	northamerica-northeast1-contactcenterinsights.googleapis.com	northamerica-northeast1
América	Multirregional	us-contactcenterinsights.googleapis.com	us
Europa	Bélgica	europe-west1-contactcenterinsights.googleapis.com	europe-west1
Europa	Londres	europe-west2-contactcenterinsights.googleapis.com	europe-west2
Europa	Fráncfort	europe-west3-contactcenterinsights.googleapis.com	europe-west3
Europa	Países Bajos	europe-west4-contactcenterinsights.googleapis.com	europe-west4
Europa	Zúrich	europe-west6-contactcenterinsights.googleapis.com	europe-west6
Asia-Pacífico	Tokio	asia-northeast1-contactcenterinsights.googleapis.com	asia-northeast1
Asia-Pacífico	Seúl	asia-northeast3-contactcenterinsights.googleapis.com	asia-northeast3
Asia-Pacífico	Bombay	asia-south1-contactcenterinsights.googleapis.com	asia-south1
Asia-Pacífico	Singapur	asia-southeast1-contactcenterinsights.googleapis.com	asia-southeast1
Asia-Pacífico	Yakarta	asia-southeast2-contactcenterinsights.googleapis.com	asia-southeast2
Asia-Pacífico	Sídney	australia-southeast1-contactcenterinsights.googleapis.com	australia-southeast1

Nota: Las llamadas a la región global pueden tener una latencia más alta cuando se llaman desde fuera de EE.UU. Si es posible, selecciona una región más específica que esté más cerca de tus servicios y usuarios finales. Para obtener más información, consulta la documentación de las regiones de Google Cloud y la geografía y las regiones de Google Cloud.

Nota: Por motivos históricos, Customer Experience Insights usa el ID de ubicación del recurso us-central1 para el extremo global, en lugar de global, que usan las APIs más nuevas.

Nota: Debes cambiar tanto el host de la URL como la ubicación del recurso para usar la instancia regional. P. ej., us-east1-contactcenterinsights.googleapis.com y projects/project-id/location/*us-east1*/conversation/conversation-id.

Comandos de muestra

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

• contactcenterinsights.analyses.create

REST

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

• PROJECT_ID: Es el ID del proyecto de Google Cloud .
• LOCATION_ID: Es la ubicación regional.
• CONVERSATION_ID: Es el ID de la conversación que deseas analizar. Este valor se devolvió en la respuesta de `createConversation`.

Método HTTP y URL:

POST https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses

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.

Ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses"

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.

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID"
}

Cliente de Python

Cuando se usa el cliente de Python, se deben actualizar la ubicación del host y del recurso para que apunten a la instancia regional.

options = ClientOptions(api_endpoint="us-east1-contactcenterinsights.googleapis.com" )
request = contact_center_insights_v1.ListConversationsRequest(
    parent=f"projects/{project_id}/locations/us-east1",
)
client = contact_center_insights_v1.ContactCenterInsightsClient(client_options=options)

Cloud Logging

Consulta la documentación de Cloud Logging para controlar la región en la que se almacenan tus registros.