地区化

在以下用例中，指定区域特别有用：

您的系统有一些法规或政策要求，限定了您的数据必须存放的位置。
当数据位于客户所在的区域时，您的网络延迟可能会得到改善。例如，如果比利时客户使用 europe-west1，那么延迟时间可能会更短。

可用区域

国家/地区分组	地理位置	端点	资源位置
全球	全球服务，静态数据位于美国	`contactcenterinsights.googleapis.com`	`us-central1`
美洲	南卡罗来纳	`us-east1-contactcenterinsights.googleapis.com`	`us-east1`
美洲	俄勒冈	`us-west1-contactcenterinsights.googleapis.com`	`us-west1`
美洲	蒙特利尔	`northamerica-northeast1-contactcenterinsights.googleapis.com`	`northamerica-northeast1`
美洲	多区域	`us-contactcenterinsights.googleapis.com`	`us`
欧洲	比利时	`europe-west1-contactcenterinsights.googleapis.com`	`europe-west1`
欧洲	伦敦	`europe-west2-contactcenterinsights.googleapis.com`	`europe-west2`
欧洲	法兰克福	`europe-west3-contactcenterinsights.googleapis.com`	`europe-west3`
欧洲	荷兰	`europe-west4-contactcenterinsights.googleapis.com`	`europe-west4`
欧洲	苏黎世	`europe-west6-contactcenterinsights.googleapis.com`	`europe-west6`
亚太地区	东京	`asia-northeast1-contactcenterinsights.googleapis.com`	`asia-northeast1`
亚太地区	首尔	`asia-northeast3-contactcenterinsights.googleapis.com`	`asia-northeast3`
亚太地区	孟买	`asia-south1-contactcenterinsights.googleapis.com`	`asia-south1`
亚太地区	新加坡	`asia-southeast1-contactcenterinsights.googleapis.com`	`asia-southeast1`
亚太地区	雅加达	`asia-southeast2-contactcenterinsights.googleapis.com`	`asia-southeast2`
亚太地区	悉尼	`australia-southeast1-contactcenterinsights.googleapis.com`	`australia-southeast1`

命令示例

执行此任务所需的权限

您必须拥有以下权限才能执行此任务：

contactcenterinsights.analyses.create

REST

在使用任何请求数据之前，请先进行以下替换：

PROJECT_ID：您的 Google Cloud 项目 ID。
LOCATION_ID：区域位置。
CONVERSATION_ID：您要分析的对话的 ID。此值是在 `createConversation` 响应中返回的。

HTTP 方法和网址：

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

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

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)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

$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

您应该收到类似以下内容的 JSON 响应：

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

Python 客户端

使用 Python 客户端时，需要同时更新主机和资源位置，以指向区域实例。

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

如需控制日志的存储区域，请参阅 Cloud Logging 文档。