Lang andauernde Vorgänge

Einige Methoden der Dialogflow API geben einen Vorgang mit langer Ausführungszeit zurück. Diese Methoden sind asynchron und der Vorgang ist möglicherweise noch nicht abgeschlossen, wenn die Methode eine Antwort zurückgibt. Sie können den Status prüfen oder Vorgänge abbrechen.

Vorgangsstatus abrufen

Das folgende Beispiel zeigt, wie Sie den Status eines Vorgangs abrufen. Wenn Sie viele Vorgänge prüfen müssen, sollten Sie die Rate einschränken oder stattdessen die Methode Liste verwenden.

REST

Rufen Sie die get Methode für den Operations Typ auf.

Ersetzen Sie folgende Werte in den Anfragedaten:

• PROJECT_ID: Ihre GCP-Projekt-ID
• OPERATION_ID: Ihre Vorgangs-ID
• API_VERSION: entweder v2 oder v2beta1

HTTP-Methode und URL:

GET https://dialogflow.googleapis.com/API_VERSION/projects/my-gcp-project/operations/OPERATION_ID

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://dialogflow.googleapis.com/API_VERSION/projects/my-gcp-project/operations/OPERATION_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dialogflow.googleapis.com/API_VERSION/projects/my-gcp-project/operations/OPERATION_ID" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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,
  ...
}

Wenn der Vorgang abgeschlossen ist, wird der state-Wert SUCCESSFUL zurückgegeben.

Vorgänge auflisten und abbrechen

Sie können nicht nur einen bestimmten Vorgang ausführen, sondern auch Vorgänge auflisten und abbrechen. Siehe die Methoden list und cancel für den Typ Operations.

Die list-Ergebnisse können Vorgänge enthalten, die nichts mit Ihrer aktuellen Aufgabe zu tun haben. Achten Sie daher darauf, die Ergebnisse zu filtern.