Regioni

Specificare una regione è particolarmente utile nei seguenti casi d'uso:

• Il tuo sistema ha requisiti normativi o di policy che regolano la posizione in cui devono risiedere i tuoi dati.
• Le latenze di rete potrebbero migliorare quando i dati si trovano nella stessa regione dei tuoi clienti. Ad esempio, se i clienti belgi utilizzano europe-west1, possono aspettarsi una latenza migliore.

Regioni disponibili

Raggruppamento di paesi	Posizione geografica	Endpoint	Località delle risorse
Globale	Globalserving, dati at-rest negli Stati Uniti	contactcenterinsights.googleapis.com	us-central1
Americhe	Carolina del Sud	us-east1-contactcenterinsights.googleapis.com	us-east1
Americhe	Oregon	us-west1-contactcenterinsights.googleapis.com	us-west1
Americhe	Montréal	northamerica-northeast1-contactcenterinsights.googleapis.com	northamerica-northeast1
Americhe	Più aree geografiche	us-contactcenterinsights.googleapis.com	us
Europa	Belgio	europe-west1-contactcenterinsights.googleapis.com	europe-west1
Europa	Londra	europe-west2-contactcenterinsights.googleapis.com	europe-west2
Europa	Francoforte	europe-west3-contactcenterinsights.googleapis.com	europe-west3
Europa	Paesi Bassi	europe-west4-contactcenterinsights.googleapis.com	europe-west4
Europa	Zurigo	europe-west6-contactcenterinsights.googleapis.com	europe-west6
Asia Pacifico	Tokyo	asia-northeast1-contactcenterinsights.googleapis.com	asia-northeast1
Asia Pacifico	Seul	asia-northeast3-contactcenterinsights.googleapis.com	asia-northeast3
Asia Pacifico	Mumbai	asia-south1-contactcenterinsights.googleapis.com	asia-south1
Asia Pacifico	Singapore	asia-southeast1-contactcenterinsights.googleapis.com	asia-southeast1
Asia Pacifico	Giacarta	asia-southeast2-contactcenterinsights.googleapis.com	asia-southeast2
Asia Pacifico	Sydney	australia-southeast1-contactcenterinsights.googleapis.com	australia-southeast1

Nota: le chiamate alla regione global potrebbero avere una latenza maggiore se effettuate da fuori dagli Stati Uniti. Se possibile, seleziona una regione più specifica e vicina ai tuoi servizi e utenti finali. Per saperne di più, consulta la documentazione relativa a regioni Google Cloud e geografia e regioni Google Cloud.

Nota: per motivi storici, Customer Experience Insights utilizza l'ID posizione risorsa us-central1 per l'endpoint globale, anziché global, che viene utilizzato dalle API più recenti.

Nota: per utilizzare l'istanza regionale, devi modificare sia l'host dell'URL sia la posizione della risorsa. Es. us-east1-contactcenterinsights.googleapis.com e projects/project-id/location/*us-east1*/conversation/conversation-id.

Comandi di esempio

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

• contactcenterinsights.analyses.create

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

• PROJECT_ID: il tuo ID progetto Google Cloud .
• LOCATION_ID: posizione regionale.
• CONVERSATION_ID: l'ID della conversazione che vuoi analizzare. Questo valore è stato restituito nella risposta `createConversation`.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo 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: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo 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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Client Python

Quando utilizzi il client Python, sia l'host che la posizione della risorsa devono essere aggiornati in modo che puntino all'istanza regionale.

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 documentazione di Cloud Logging per controllare la regione in cui sono archiviati i log.