Régionalisation

Spécifier une région est particulièrement utile dans les cas d'utilisation suivants :

• Votre système est soumis à des exigences réglementaires ou des règles qui régissent l'emplacement de vos données.
• Les latences réseau peuvent être améliorées lorsque les données se trouvent dans la même région que vos clients. Par exemple, les clients belges peuvent s'attendre à une meilleure latence s'ils utilisent la région europe-west1.

Régions disponibles

Regroupement de pays	Emplacement géographique.	Point de terminaison	Emplacement de la ressource
Monde	Diffusion mondiale, données au repos aux États-Unis	contactcenterinsights.googleapis.com	us-central1
Amériques	Caroline du Sud	us-east1-contactcenterinsights.googleapis.com	us-east1
Amériques	Oregon	us-west1-contactcenterinsights.googleapis.com	us-west1
Amériques	Montréal	northamerica-northeast1-contactcenterinsights.googleapis.com	northamerica-northeast1
Amériques	Stockage multirégional	us-contactcenterinsights.googleapis.com	us
Europe	Belgique	europe-west1-contactcenterinsights.googleapis.com	europe-west1
Europe	Londres	europe-west2-contactcenterinsights.googleapis.com	europe-west2
Europe	Francfort	europe-west3-contactcenterinsights.googleapis.com	europe-west3
Europe	Pays-Bas	europe-west4-contactcenterinsights.googleapis.com	europe-west4
Europe	Zurich	europe-west6-contactcenterinsights.googleapis.com	europe-west6
Asie-Pacifique	Tokyo	asia-northeast1-contactcenterinsights.googleapis.com	asia-northeast1
Asie-Pacifique	Séoul	asia-northeast3-contactcenterinsights.googleapis.com	asia-northeast3
Asie-Pacifique	Mumbai	asia-south1-contactcenterinsights.googleapis.com	asia-south1
Asie-Pacifique	Singapour	asia-southeast1-contactcenterinsights.googleapis.com	asia-southeast1
Asie-Pacifique	Jakarta	asia-southeast2-contactcenterinsights.googleapis.com	asia-southeast2
Asie-Pacifique	Sydney	australia-southeast1-contactcenterinsights.googleapis.com	australia-southeast1

Remarque : Les appels vers la région global peuvent présenter une latence plus élevée lorsqu'ils sont appelés depuis l'extérieur des États-Unis. Si possible, sélectionnez une région plus spécifique et plus proche de vos services et des utilisateurs finaux. Pour en savoir plus, consultez la documentation Régions Google Cloud et Zones géographiques et régions Google Cloud.

Remarque : Pour des raisons historiques, Customer Experience Insights utilise l'ID d'emplacement de ressource us-central1 pour le point de terminaison mondial, au lieu de global qui est utilisé par les API plus récentes.

Remarque : Vous devez modifier à la fois l'hôte de l'URL et l'emplacement de la ressource pour utiliser l'instance régionale. Par exemple, us-east1-contactcenterinsights.googleapis.com et projects/project-id/location/*us-east1*/conversation/conversation-id.

Exemples de commandes

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• contactcenterinsights.analyses.create

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• LOCATION_ID : emplacement régional.
• CONVERSATION_ID : ID de la conversation que vous souhaitez analyser. Cette valeur a été renvoyée dans la réponse `createConversation`.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Client Python

Lorsque vous utilisez le client Python, l'hôte et l'emplacement de la ressource doivent être mis à jour pour pointer vers l'instance régionale.

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

Consultez la documentation Cloud Logging pour contrôler la région dans laquelle vos journaux sont stockés.