Regionalização

Especificar uma região é particularmente útil nos seguintes casos de uso:

• Seu sistema tem requisitos regulatórios ou de políticas que regem o local dos dados.
• Suas latências de rede podem ser melhoradas quando os dados estão na mesma região que seus clientes. Por exemplo, se os clientes da Bélgica usarem europe-west1, eles poderão esperar uma latência melhor.

Regiões disponíveis

Grupos de países	Localização geográfica	Endpoint	Local do recurso
Global	Disponibilização global, dados em repouso nos EUA	contactcenterinsights.googleapis.com	us-central1
Américas	Carolina do Sul	us-east1-contactcenterinsights.googleapis.com	us-east1
Américas	Oregon	us-west1-contactcenterinsights.googleapis.com	us-west1
Américas	Montreal	northamerica-northeast1-contactcenterinsights.googleapis.com	northamerica-northeast1
Américas	Várias regiões	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	Frankfurt	europe-west3-contactcenterinsights.googleapis.com	europe-west3
Europa	Países Baixos	europe-west4-contactcenterinsights.googleapis.com	europe-west4
Europa	Zurique	europe-west6-contactcenterinsights.googleapis.com	europe-west6
Ásia-Pacífico	Tóquio	asia-northeast1-contactcenterinsights.googleapis.com	asia-northeast1
Ásia-Pacífico	Seul	asia-northeast3-contactcenterinsights.googleapis.com	asia-northeast3
Ásia-Pacífico	Mumbai	asia-south1-contactcenterinsights.googleapis.com	asia-south1
Ásia-Pacífico	Singapura	asia-southeast1-contactcenterinsights.googleapis.com	asia-southeast1
Ásia-Pacífico	Jacarta	asia-southeast2-contactcenterinsights.googleapis.com	asia-southeast2
Ásia-Pacífico	Sydney	australia-southeast1-contactcenterinsights.googleapis.com	australia-southeast1

Observação: as chamadas para a região global podem ter uma latência maior quando feitas de fora dos EUA. Se possível, selecione uma região mais específica mais próxima dos seus serviços e usuários finais. Para mais informações, consulte a documentação sobre regiões do Google Cloud e geografia e regiões do Google Cloud.

Observação: por motivos históricos, o Customer Experience Insights usa o ID do local do recurso us-central1 para o endpoint global, em vez de global, que é usado por APIs mais recentes.

Observação: é necessário mudar o host do URL e o local do recurso para usar a instância regional. Por exemplo: us-east1-contactcenterinsights.googleapis.com e projects/project-id/location/*us-east1*/conversation/conversation-id.

Exemplos de comandos

Permissões exigidas para a tarefa

Para executar essa tarefa, é necessário ter permissões:

• contactcenterinsights.analyses.create

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID: o ID do projeto Google Cloud .
• LOCATION_ID: local regional.
• CONVERSATION_ID: o ID da conversa que você quer analisar. Esse valor foi retornado na resposta `createConversation`.

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte 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)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

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

Cliente Python

Ao usar o cliente Python, o host e o local do recurso precisam ser atualizados para apontar para a instância 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

Consulte a documentação do Cloud Logging para controlar a região em que seus registros são armazenados.