Regionalisierung

Die Angabe einer Region ist in den folgenden Anwendungsfällen besonders hilfreich:

• Für Ihr System gelten regulatorische oder Richtlinienanforderungen, die den Standort Ihrer Daten bestimmen.
• Befinden sich die Daten in derselben Region wie Ihre Kunden, kann das die Netzwerklatenzen verbessern. Beispiel: Wenn Kunden in Belgien europe-west1 verwenden, können sie eine niedrigere Latenz erwarten.

Verfügbare Regionen

Ländergruppierung	Geografischer Ort	Endpunkt	Ressourcenstandort
Global	Globale Bereitstellung, inaktive Daten in den USA	contactcenterinsights.googleapis.com	us-central1
Nord- und Südamerika	South Carolina	us-east1-contactcenterinsights.googleapis.com	us-east1
Amerika	Oregon	us-west1-contactcenterinsights.googleapis.com	us-west1
Nord- und Südamerika	Montreal	northamerica-northeast1-contactcenterinsights.googleapis.com	northamerica-northeast1
Nord- und Südamerika	Mehrere Regionen	us-contactcenterinsights.googleapis.com	us
Europa	Belgien	europe-west1-contactcenterinsights.googleapis.com	europe-west1
Europa	London	europe-west2-contactcenterinsights.googleapis.com	europe-west2
Europa	Frankfurt	europe-west3-contactcenterinsights.googleapis.com	europe-west3
Europa	Niederlande	europe-west4-contactcenterinsights.googleapis.com	europe-west4
Europa	Zürich	europe-west6-contactcenterinsights.googleapis.com	europe-west6
Asiatisch-pazifischer Raum	Tokio	asia-northeast1-contactcenterinsights.googleapis.com	asia-northeast1
Asiatisch-pazifischer Raum	Seoul	asia-northeast3-contactcenterinsights.googleapis.com	asia-northeast3
Asiatisch-pazifischer Raum	Mumbai	asia-south1-contactcenterinsights.googleapis.com	asia-south1
Asiatisch-pazifischer Raum	Singapur	asia-southeast1-contactcenterinsights.googleapis.com	asia-southeast1
Asiatisch-pazifischer Raum	Jakarta	asia-southeast2-contactcenterinsights.googleapis.com	asia-southeast2
Asiatisch-pazifischer Raum	Sydney	australia-southeast1-contactcenterinsights.googleapis.com	australia-southeast1

Hinweis :Aufrufe an die Region global können von außerhalb der USA eine höhere Latenz haben. Wählen Sie nach Möglichkeit eine spezifischere Region aus, die näher an Ihren Diensten und Endnutzern liegt. Weitere Informationen finden Sie in der Dokumentation zu Google Cloud-Regionen und Google Cloud-Geografie und -Regionen.

Hinweis:Aus historischen Gründen wird in Customer Experience Insights für den globalen Endpunkt die Ressourcenstandort-ID us-central1 anstelle von global verwendet, die von neueren APIs verwendet wird.

Hinweis:Sie müssen sowohl den Host der URL als auch den Ressourcenstandort ändern, um die regionale Instanz zu verwenden. z. B. us-east1-contactcenterinsights.googleapis.com und projects/project-id/location/*us-east1*/conversation/conversation-id.

Beispielbefehle

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie folgende Berechtigungen:

• contactcenterinsights.analyses.create

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: Projekt-ID in Google Cloud .
• LOCATION_ID: regionaler Standort.
• CONVERSATION_ID: die ID der Unterhaltung, die Sie analysieren möchten. Dieser Wert wurde in der `createConversation`-Antwort zurückgegeben.

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Python-Client

Wenn Sie den Python-Client verwenden, müssen sowohl der Host als auch der Speicherort der Ressource aktualisiert werden, damit sie auf die regionale Instanz verweisen.

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

Informationen zum Steuern der Region, in der Ihre Logs gespeichert werden, finden Sie in der Cloud Logging-Dokumentation.