Stay organized with collectionsSave and categorize content based on your preferences.
Specifying a region is particularly helpful in the following use cases:
Your system has regulatory or policy requirements that govern where your data
must reside.
Your network latencies might be improved when the data is in the same region
as your customers. For example, if Belgium customers useeurope-west1, they
can expect better latency.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eSpecifying a region for your data can help meet regulatory requirements and improve network latency by keeping data closer to customers.\u003c/p\u003e\n"],["\u003cp\u003eThe global endpoint for Conversational Insights uses \u003ccode\u003eus-central1\u003c/code\u003e as the resource location ID, while other regions use their respective location IDs.\u003c/p\u003e\n"],["\u003cp\u003eCalls to the \u003ccode\u003eglobal\u003c/code\u003e region may have higher latency from outside the US, so selecting a region closer to services and end-users is recommended.\u003c/p\u003e\n"],["\u003cp\u003eTo use a regional instance, both the host in the URL and the resource location must be changed, for example, from \u003ccode\u003econtactcenterinsights.googleapis.com\u003c/code\u003e to \u003ccode\u003eus-east1-contactcenterinsights.googleapis.com\u003c/code\u003e and \u003ccode\u003eus-east1\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe provided table outlines the available regions, their corresponding geographical locations, the associated endpoint, and resource location for better comprehension.\u003c/p\u003e\n"]]],[],null,["# Regionalization\n\nSpecifying a region is particularly helpful in the following use cases:\n\n- Your system has regulatory or policy requirements that govern where your data must reside.\n- Your network latencies might be improved when the data is in the same region as your customers. For example, if Belgium customers use `europe-west1`, they can expect better latency.\n\nAvailable regions\n-----------------\n\n| **Note:** Calls to the `global` region might have higher latency when called from outside of the US. Select a more specific region that is closer to your services and end-users, if possible. For more information, see the [Google Cloud regions](/about/locations) and [Google Cloud geography and regions](/docs/geography-and-regions) documentation.\n| **Note:** For historical reasons, Conversational Insights uses the resource location ID `us-central1` for the global endpoint, instead of `global` which is used by newer APIs.\n| **Note:** You need to change both the host of the URL and the resource location to use the regional instance. Eg. `us-east1-contactcenterinsights.googleapis.com` and `projects/project-id/location/*us-east1*/conversation/conversation-id`.\n\nSample Commands\n---------------\n\n#### Permissions required for this task\n\nTo perform this task, you must have the following\n[permissions](/iam/docs/overview#permissions):\n\n\n- `contactcenterinsights.analyses.create` \n\n### REST\n\n\nBefore using any of the request data,\nmake the following replacements:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: your Google Cloud project ID.\n- \u003cvar translate=\"no\"\u003eLOCATION_ID\u003c/var\u003e: regional location.\n- \u003cvar translate=\"no\"\u003eCONVERSATION_ID\u003c/var\u003e: the ID of the conversation you want to analyze. This value was returned in the \\`createConversation\\` response.\n\n\nHTTP method and URL:\n\n```\nPOST https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses\n```\n\nTo send your request, expand one of these options:\n\n#### curl (Linux, macOS, or Cloud Shell)\n\n| **Note:** The following command assumes that you have logged in to the `gcloud` CLI with your user account by running [`gcloud init`](/sdk/gcloud/reference/init) or [`gcloud auth login`](/sdk/gcloud/reference/auth/login) , or by using [Cloud Shell](/shell/docs), which automatically logs you into the `gcloud` CLI . You can check the currently active account by running [`gcloud auth list`](/sdk/gcloud/reference/auth/list).\n\n\nExecute the following command:\n\n```\ncurl -X POST \\\n -H \"Authorization: Bearer $(gcloud auth print-access-token)\" \\\n -H \"Content-Type: application/json; charset=utf-8\" \\\n -d \"\" \\\n \"https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses\"\n```\n\n#### PowerShell (Windows)\n\n| **Note:** The following command assumes that you have logged in to the `gcloud` CLI with your user account by running [`gcloud init`](/sdk/gcloud/reference/init) or [`gcloud auth login`](/sdk/gcloud/reference/auth/login) . You can check the currently active account by running [`gcloud auth list`](/sdk/gcloud/reference/auth/list).\n\n\nExecute the following command:\n\n```\n$cred = gcloud auth print-access-token\n$headers = @{ \"Authorization\" = \"Bearer $cred\" }\n\nInvoke-WebRequest `\n -Method POST `\n -Headers $headers `\n -Uri \"https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses\" | Select-Object -Expand Content\n```\n\nYou should receive a JSON response similar to the following:\n\n```\n{\n \"name\": \"projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID\"\n}\n```\n\n\u003cbr /\u003e\n\nPython Client\n-------------\n\nWhile using the python client, both the host and the resource location needs to be updated to point to the regional instance. \n\n options = ClientOptions(api_endpoint=\"us-east1-contactcenterinsights.googleapis.com\" )\n request = contact_center_insights_v1.ListConversationsRequest(\n parent=f\"projects/{project_id}/locations/us-east1\",\n )\n client = contact_center_insights_v1.ContactCenterInsightsClient(client_options=options)\n\nCloud Logging\n-------------\n\nSee the [Cloud Logging documentation](/contact-center/insights/logging/docs/regionalized-logs) to control\nthe region where your logs are stored."]]
