API를 사용하여 대화 일괄 삭제

Customer Experience Insights에서 필터링된 일부 대화 또는 모든 대화를 단일 요청으로 삭제할 수 있습니다. 삭제된 대화는 복구할 수 없으므로 예상되는 수의 대화를 올바른 필터로 삭제해야 합니다.

먼저 MAX_DELETE_COUNT을 0으로 설정하여 명령어를 실행하는 것이 좋습니다. 그런 다음 삭제될 대화 수를 확인하고 올바른 MAX_DELETE_COUNT로 API 호출을 실행합니다.

기본 요건

1. 대화 데이터가 Customer Experience Insights에 업로드되었는지 확인합니다.

명령어 샘플

모든 대화 삭제

REST

자세한 내용은 conversations:bulkDelete API 엔드포인트를 참조하세요.

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

• PROJECT_ID: Google Cloud Platform 프로젝트 ID입니다.
• FORCE: true인 경우 대화 및 연결된 분석이 삭제되고, 그렇지 않으면 분석되지 않은 대화만 삭제됩니다.
• MAX_DELETE_COUNT: 삭제할 최대 대화 수입니다. 이 값이 프로젝트의 대화 수보다 작으면 API 호출이 오류를 반환합니다.

참고: 모든 예시에서는 전역 고객 경험 통계 인스턴스를 사용합니다. 리전 인스턴스 사용에 관한 안내는 리전화를 참고하세요.

HTTP 메서드 및 URL:

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations:bulkDelete

JSON 요청 본문:

{
  "force": FORCE,
  "maxDeleteCount": MAX_DELETE_COUNT,
}

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

cURL(Linux, macOS, Cloud Shell)

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

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

curl -X POST \
     -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/conversations:bulkDelete"

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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations:bulkDelete" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID",
}

(선택사항) 필터를 사용하여 대화 삭제

대화 필터링 페이지에서 필터의 전체 목록을 확인할 수 있습니다.

REST

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

• PROJECT_ID: Google Cloud Platform 프로젝트 ID입니다.
• FORCE: true인 경우 대화 및 연결된 분석이 삭제되고, 그렇지 않으면 분석되지 않은 대화만 삭제됩니다.
• MAX_DELETE_COUNT: 삭제할 최대 대화 수입니다. 이 값이 프로젝트의 대화 수보다 작으면 API 호출이 오류를 반환합니다.
• FILTER: 사용 가능한 필터 옵션은 대화 목록을 참고하세요.

참고: 모든 예시에서는 전역 고객 경험 통계 인스턴스를 사용합니다. 리전 인스턴스 사용에 관한 안내는 리전화를 참고하세요.

HTTP 메서드 및 URL:

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations:bulkAnalyze

JSON 요청 본문:

{
  "force": FORCE,
  "maxDeleteCount": MAX_DELETE_COUNT,
  "filter": 'FILTER'
}

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

cURL(Linux, macOS, Cloud Shell)

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

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

curl -X POST \
     -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/conversations:bulkAnalyze"

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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations:bulkAnalyze" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID",
}

작업 폴링

대화를 삭제하면 장기 실행 작업이 반환됩니다. 장기 실행 메서드는 비동기적이며 메서드가 응답을 반환할 때 작업이 아직 완료되지 않았을 수 있습니다. 작업을 폴링하여 상태를 확인할 수 있습니다. 자세한 내용과 코드 샘플은 장기 실행 작업 페이지를 참고하세요.

작업 취소

REST

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

• PROJECT_ID: Google Cloud Platform 프로젝트 ID입니다.
• OPERATION_ID: 분석하려는 대화의 ID입니다. 이 값은 작업을 만들 때 반환되었습니다.

참고: 모든 예시에서는 전역 고객 경험 통계 인스턴스를 사용합니다. 리전 인스턴스 사용에 관한 안내는 리전화를 참고하세요.

HTTP 메서드 및 URL:

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID:cancel

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

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://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID:cancel"

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://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID:cancel" | Select-Object -Expand Content

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

{}