Supprimer des conversations par lot à l'aide de l'API

Dans Customer Experience Insights, vous pouvez choisir de supprimer un sous-ensemble filtré de conversations ou toutes les conversations en une seule demande. Les conversations supprimées ne peuvent pas être récupérées. Assurez-vous donc de supprimer le nombre de conversations attendu et avec le bon filtre.

Nous vous recommandons vivement d'exécuter d'abord la commande avec MAX_DELETE_COUNT défini sur 0. Ensuite, confirmez le nombre de conversations qui seront supprimées et exécutez l'appel d'API avec le MAX_DELETE_COUNT approprié.

Prérequis

1. Assurez-vous que vos données de conversation sont importées dans Customer Experience Insights.

Exemples de commandes

Supprimer toutes les conversations

REST

Reportez-vous au point de terminaison conversations:bulkDelete de l'API pour obtenir des informations complètes.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet Google Cloud Platform.
• FORCE : si la valeur est "true", les conversations et les analyses associées seront supprimées. Sinon, seules les conversations qui n'ont pas été analysées seront supprimées.
• MAX_DELETE_COUNT : nombre maximal de conversations à supprimer. Si cette valeur est inférieure au nombre de conversations dans le projet, l'appel d'API renverra une erreur.

Remarque : Tous les exemples utilisent l'instance Insights sur l'expérience client globale. Pour savoir comment utiliser les instances régionales, consultez Régionalisation.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

(Facultatif) Supprimer des conversations à l'aide d'un filtre

Vous trouverez la liste complète des filtres sur la page Filtrer les conversations.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet Google Cloud Platform.
• FORCE : si la valeur est "true", les conversations et les analyses associées seront supprimées. Sinon, seules les conversations qui n'ont pas été analysées seront supprimées.
• MAX_DELETE_COUNT : nombre maximal de conversations à supprimer. Si cette valeur est inférieure au nombre de conversations dans le projet, l'appel d'API renvoie une erreur.
• FILTER : consultez Lister les conversations pour connaître les options de filtrage disponibles.

Remarque : Tous les exemples utilisent l'instance Insights sur l'expérience client globale. Pour savoir comment utiliser les instances régionales, consultez Régionalisation.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Interroger l'opération

La suppression de conversations renvoie une opération de longue durée. Les méthodes de longue durée sont asynchrones, et il est possible que l'opération ne soit pas encore terminée lorsque la méthode renvoie une réponse. Vous pouvez interroger l'opération pour vérifier son état. Pour en savoir plus et obtenir des exemples de code, consultez la page Opérations de longue durée.

Annuler l'opération

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet Google Cloud Platform.
• OPERATION_ID : ID de la conversation que vous souhaitez analyser. Cette valeur a été renvoyée lorsque vous avez créé l'opération.

Remarque : Tous les exemples utilisent l'instance Insights sur l'expérience client globale. Pour savoir comment utiliser les instances régionales, consultez Régionalisation.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

{}