使用 API 批量删除对话

在“客户体验洞见”中，您可以选择在单个请求中删除过滤后的部分对话，也可以删除所有对话。已删除的对话无法恢复，因此请确保您删除的对话数量符合预期，并且所用的过滤条件正确无误。

我们强烈建议您先运行将 MAX_DELETE_COUNT 设置为 0 的命令。然后，确认将删除的对话数量，并使用正确的 MAX_DELETE_COUNT 运行 API 调用。

前提条件

1. 确保您的对话数据已上传到“客户体验洞见”。

命令示例

删除所有对话

REST

如需了解完整的详细信息，请参阅 conversations:bulkDelete API 端点。

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

• PROJECT_ID：您的 Google Cloud Platform 项目 ID。
• FORCE：如果为 true，则会删除对话和关联的分析；否则，只会删除尚未分析的对话。
• MAX_DELETE_COUNT：要删除的对话数量上限。如果此值低于项目中的对话数量，API 调用将返回错误。

注意：所有示例均使用全球客户体验数据分析实例。如需了解如何使用区域实例，请参阅区域化。

HTTP 方法和网址：

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 方法和网址：

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 方法和网址：

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 响应：

{}