Opérations de longue durée

Certaines méthodes de l'API Dialogflow renvoient une opération de longue durée. Ces méthodes sont asynchrones, et l'opération risque de ne pas être terminée lorsque la méthode renverra une réponse. Vous pouvez vérifier l'état ou annuler des opérations.

Obtenir l'état d'une opération

Pour interroger l'état d'une opération, procédez comme suit : Si vous avez de nombreuses opérations à vérifier, vous devez limiter vos appels ou utiliser la méthode list à la place.

API REST et ligne de commande

Appelez la méthode get pour le type Operations.

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

  • project-id : ID de votre projet GCP
  • operation-id : ID d'opération
  • api-version : v2 ou v2beta1

Méthode HTTP et URL :

GET https://dialogflow.googleapis.com/api-version/projects/my-gcp-project/operations/operation-id

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

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

{
  "name": "projects/project-id/operations/some-operation-name-operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.dialogflow.api-version.SomeOperationType",
    "state": "DONE"
  },
  "done": true,
  ...
}

Lorsque l'opération est terminée, la valeur SUCCESSFUL est renvoyée pour state.

Répertorier et annuler des opérations

En plus d'obtenir une opération spécifique, vous pouvez répertorier et annuler des opérations. Consultez les méthodes list et cancel pour le type Operations.

Les résultats list peuvent contenir des opérations sans rapport avec votre tâche actuelle. Veillez donc à filtrer les résultats.