Vorgänge mit langer Ausführungszeit

Die Submission API ist asynchron und gibt einen Vorgang mit langer Ausführungszeit zurück. Der Vorgang ist möglicherweise noch nicht abgeschlossen, wenn die Methode eine Antwort zurückgibt.

Vorgangsstatus abrufen

Das folgende Beispiel zeigt, wie Sie den Status eines Vorgangs abrufen.

Rufen Sie die Methode GET für den Typ Vorgänge auf.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • project-number: Ihre Google Cloud-Projektnummer.
  • operation-id: Ihre Vorgangs-ID

HTTP-Methode und URL:

GET https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id"

PowerShell

Führen Sie folgenden Befehl aus: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id" | Select-Object -Expand Content

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

{
  "name": "projects/project-number/operations/operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.webrisk.v1.SubmitUriMetadata",
    "state": "RUNNING"
  }
  "done": false,
  ...
}

Vorgangsstatus

Das Feld metadata.state in der Antwort gibt den aktuellen Status der Einreichung an. Wenn der Vorgang abgeschlossen ist, wird das Feld state im SubmitUriMetadata aktualisiert. Folgende Status sind möglich:

  • SUCCEEDED: Gibt an, dass die eingereichte URL der Safe Browsing-Sperrliste hinzugefügt wurde.
  • CLOSED: Die eingereichte URL wurde nicht der Safe Browsing-Sperrliste hinzugefügt, da sie nicht gegen die Safe Browsing-Richtlinien verstößt.
  • RUNNING: Gibt an, dass die Einreichung noch verarbeitet wird.

Gründe für den Status „GESCHLOSSEN“

Wenn der Vorgangsstatus CLOSED ist, kann SubmitUriMetadata das Feld closed_reason enthalten. Dieses Feld enthält zusätzlichen Kontext dazu, warum die Einreichung geschlossen wurde, ohne dass die URL einer Sperrliste hinzugefügt wurde.

Folgende Werte sind für closed_reason möglich:

  • CLOSED_REASON_UNSPECIFIED: Der Grund ist nicht angegeben.
  • NO_THREAT_DETECTED:
    • Beschreibung: Die eingereichte URL wurde erfolgreich analysiert und es wurden keine schädlichen Inhalte gefunden. Das bedeutet, dass die URL unserer Analyse zufolge nicht die Kriterien für die Aufnahme auf die Sperrliste erfüllt.
    • Empfohlene Nutzeraktion: In der Regel sind für diese URL keine weiteren Maßnahmen erforderlich, da sie nicht als Bedrohung eingestuft wurde. Reichen Sie die Inhalte nicht wiederholt ein, es sei denn, sie haben sich geändert und es gibt neue Beweise für schädliche Aktivitäten.
  • HOST_UNRESOLVABLE:
    • Beschreibung: Die Analyse konnte nicht abgeschlossen werden, da der Hostname der URL nicht über DNS aufgelöst werden konnte. Das bedeutet oft, dass die Website nicht verfügbar ist, die Domain nicht mehr existiert oder ein vorübergehendes DNS-Problem aufgetreten ist. Wir können inaktive oder Platzhalter-URLs nicht der Sperrliste hinzufügen.
    • Empfohlene Nutzeraktion:
      • URL prüfen: Achten Sie darauf, dass der Hostname korrekt ist und die Website aktiv und öffentlich zugänglich ist.
      • Nochmal einreichen: Sie können die URL später noch einmal einreichen, wenn Sie bestätigen, dass die Website aktiv ist.
  • CONTENT_UNREACHABLE:
    • Beschreibung: Die Analyse konnte nicht abgeschlossen werden, da die Inhalte der Website nicht aufgerufen werden konnten. Dafür kann es verschiedene Gründe geben, z. B.:
      • Die Webseite existiert nicht mehr (Fehler „404 Not Found“).
      • Auf dem Server der Website ist ein Fehler aufgetreten (ein „5xx-Serverfehler“).
      • Auf der Website werden unserem Analysesystem möglicherweise andere Inhalte präsentiert als einem normalen Besucher (Cloaking). Dadurch ist keine vollständige Bewertung möglich.
    • Empfohlene Nutzeraktion:
      • Zugänglichkeit prüfen: Prüfen Sie, ob die schädlichen Inhalte erreichbar sind. Auf einigen Websites werden schädliche Inhalte möglicherweise nur unter bestimmten Bedingungen angezeigt, z. B. an bestimmten Standorten, auf bestimmten Geräten oder in bestimmten Browsern.
      • Mehr Kontext angeben: Wenn die URL unter bestimmten Bedingungen zugänglich ist, reichen Sie sie noch einmal ein. Verwenden Sie die Felder ThreatDiscovery in SubmitUriRequest, um zusätzliche Details anzugeben, z. B. die Region und Plattform, auf der die Bedrohung beobachtet wurde. Diese Informationen können die Wahrscheinlichkeit einer erfolgreichen Analyse erhöhen.