쿼리 측정항목

프리뷰

이 기능에는 서비스별 약관이 적용됩니다. 정식 버전(GA) 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

CX Insights에 있는 대화 데이터에 관한 측정항목을 쿼리합니다. 이러한 측정항목에는 총 대화 수, 평균 무음 비율, 평균 대화 시간 등이 포함됩니다.

기본 요건

프로젝트에서 이 기능을 사용 설정하려면 Google 담당자에게 문의하세요.

쿼리 측정항목

다음 코드 샘플은 측정항목을 쿼리하는 방법을 보여줍니다. 대화 생성 시간 필터는 항상 필요합니다. 이 필터에 대한 자세한 내용은 대화 목록을 참고하세요.

전체 측정항목

모든 측정항목을 가져옵니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• MIN_TIMESTAMP: 최소 타임스탬프 필터입니다. 예를 들면 YYYY-MM-DDT00:00:00+00입니다.
• MAX_TIMESTAMP: 최대 타임스탬프 필터입니다. 예를 들면 YYYY-MM-DDT00:00:00+00입니다.
참고: 모든 예에서는 전역 Customer Experience Insights 인스턴스를 사용합니다. 리전 인스턴스 사용에 관한 안내는 리전화를 참고하세요.

HTTP 메서드 및 URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics

JSON 요청 본문:

{
  "filter": "create_time>='MIN_TIMESTAMP' create_time<'MAX_TIMESTAMP'"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
  }
}

주제별로 그룹화된 모든 측정항목

주제별로 그룹화된 모든 측정항목을 가져옵니다. 주제에 관한 자세한 내용은 주제 모델링 개요를 참고하세요.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• MIN_TIMESTAMP: 최소 타임스탬프 필터입니다. 예를 들면 YYYY-MM-DDT00:00:00+00입니다.
• MAX_TIMESTAMP: 최대 타임스탬프 필터입니다. 예를 들면 YYYY-MM-DDT00:00:00+00입니다.
참고: 모든 예에서는 전역 Customer Experience Insights 인스턴스를 사용합니다. 리전 인스턴스 사용에 관한 안내는 리전화를 참고하세요.

HTTP 메서드 및 URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics

JSON 요청 본문:

{
  "filter": "create_time>='MIN_TIMESTAMP' create_time<'MAX_TIMESTAMP'",
  "dimensions": [{ "dimensionKey": "ISSUE" }]
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
  }
}

일일 시계열의 모든 측정항목

일일 시계열의 모든 측정항목을 가져옵니다. 시계열의 각 데이터 포인트는 하루 분량의 측정항목을 나타냅니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• MIN_TIMESTAMP: 최소 타임스탬프 필터입니다. 예를 들면 YYYY-MM-DDT00:00:00+00입니다.
• MAX_TIMESTAMP: 최대 타임스탬프 필터입니다. 예를 들면 YYYY-MM-DDT00:00:00+00입니다.

HTTP 메서드 및 URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics

JSON 요청 본문:

{
  "filter": "create_time>='MIN_TIMESTAMP' create_time<'MAX_TIMESTAMP'",
  "timeGranularity": "DAILY"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
  }
}

일일 시계열의 주제별로 그룹화된 모든 측정항목

일일 시계열에서 주제별로 그룹화된 모든 측정항목을 가져옵니다. 시계열의 각 데이터 포인트는 하루 분량의 측정항목을 나타냅니다. 주제에 관한 자세한 내용은 주제 모델링 개요를 참고하세요.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• MIN_TIMESTAMP: 최소 타임스탬프 필터입니다. 예를 들면 YYYY-MM-DDT00:00:00+00입니다.
• MAX_TIMESTAMP: 최대 타임스탬프 필터입니다. 예를 들면 YYYY-MM-DDT00:00:00+00입니다.
참고: 모든 예에서는 전역 Customer Experience Insights 인스턴스를 사용합니다. 리전 인스턴스 사용에 관한 안내는 리전화를 참고하세요.

HTTP 메서드 및 URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics

JSON 요청 본문:

{
  "filter": "create_time>='MIN_TIMESTAMP' create_time<'MAX_TIMESTAMP'",
  "dimensions": [{ "dimensionKey": "ISSUE" }],
  "timeGranularity": "DAILY"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1:queryMetrics" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
  }
}