리전화

리전을 지정하는 것은 다음과 같은 사용 사례에서 특히 유용합니다.

시스템에 데이터 저장 위치를 제어하는 규정 또는 정책 요구사항이 있습니다.
데이터가 고객과 동일한 리전에 있으면 네트워크 지연 시간이 향상될 수 있습니다. 예를 들어 벨기에 고객이 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`
미주	Multi-Regional	`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 메서드 및 URL:

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 문서를 참고하세요.