區域規劃

在下列情況下，指定地區特別有幫助：

• 您的系統有法規或政策要求，規定資料的儲存位置。
• 如果資料與顧客位於相同區域，網路延遲時間可能會縮短。舉例來說，如果比利時客戶使用 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

注意： 從美國境外呼叫 global 地區時，延遲時間可能會較長。如有可能，請選取更具體的區域，盡量靠近您的服務和使用者。詳情請參閱「Google Cloud 區域」和「Google Cloud 地理位置和區域」說明文件。

注意：基於歷史因素，Customer Experience Insights 使用資源位置 ID us-central1 做為全域端點，而非較新 API 使用的 global。

注意：如要使用區域執行個體，您必須變更網址主機和資源位置。例如：us-east1-contactcenterinsights.googleapis.com 和 projects/project-id/location/*us-east1*/conversation/conversation-id。

指令範例

這項工作需要的權限

如要執行這項工作，您必須具備以下權限：

• 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 說明文件。