Menghapus percakapan secara massal menggunakan API

Anda memiliki opsi untuk menghapus subset percakapan yang difilter atau semua percakapan dalam satu permintaan di Customer Experience Insights. Percakapan yang dihapus tidak dapat dipulihkan, jadi pastikan Anda menghapus jumlah percakapan yang diharapkan dan dengan filter yang benar.

Sebaiknya jalankan perintah dengan MAX_DELETE_COUNT yang ditetapkan ke 0 terlebih dahulu. Kemudian, konfirmasi jumlah percakapan yang akan dihapus, dan jalankan panggilan API dengan MAX_DELETE_COUNT yang benar.

Prasyarat

1. Pastikan data percakapan Anda diupload ke Customer Experience Insights.

Contoh Perintah

Menghapus semua percakapan

REST

Lihat endpoint API conversations:bulkDelete untuk mengetahui detail selengkapnya.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID Google Cloud Platform Anda.
• FORCE: Jika benar (true), percakapan dan analisis tertaut akan dihapus. Jika salah (false), hanya percakapan yang belum dianalisis yang akan dihapus.
• MAX_DELETE_COUNT: Jumlah maksimum percakapan yang akan dihapus. Jika nilai ini lebih rendah dari jumlah percakapan dalam project, panggilan API akan menampilkan error.

Catatan: Semua contoh menggunakan instance Customer Experience Insights global. Lihat Regionalisasi untuk mengetahui petunjuk tentang cara menggunakan instance regional.

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

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

(Opsional) Menghapus percakapan menggunakan filter

Anda dapat melihat daftar lengkap filter di halaman Pemfilteran percakapan.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID Google Cloud Platform Anda.
• FORCE: Jika benar (true), percakapan dan analisis tertaut akan dihapus. Jika salah (false), hanya percakapan yang belum dianalisis yang akan dihapus.
• MAX_DELETE_COUNT: Jumlah maksimum percakapan yang akan dihapus. Jika jumlah ini lebih rendah daripada jumlah percakapan dalam project, panggilan API akan menampilkan error.
• FILTER: Lihat Mencantumkan percakapan untuk opsi filter yang tersedia.

Catatan: Semua contoh menggunakan instance Customer Experience Insights global. Lihat Regionalisasi untuk mengetahui petunjuk tentang cara menggunakan instance regional.

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

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

Polling operasi

Menghapus percakapan akan menampilkan operasi yang berjalan lama. Metode yang berjalan lama bersifat asinkron, dan operasi mungkin belum selesai saat metode menampilkan respons. Anda dapat melakukan polling operasi untuk memeriksa statusnya. Lihat halaman operasi yang berjalan lama untuk mengetahui detail dan contoh kodenya.

Membatalkan operasi

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID Google Cloud Platform Anda.
• OPERATION_ID: ID percakapan yang ingin Anda analisis. Nilai ini ditampilkan saat Anda membuat operasi.

Catatan: Semua contoh menggunakan instance Customer Experience Insights global. Lihat Regionalisasi untuk mengetahui petunjuk tentang cara menggunakan instance regional.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

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)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$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

Anda akan melihat respons JSON yang mirip seperti berikut:

{}