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 in SubmitUriMetadata aktualisiert. Folgende Status sind möglich:

  • SUCCEEDED: Gibt an, dass die eingereichte URL der Safe Browsing-Sperrliste hinzugefügt wurde.
  • CLOSED: Gibt an, dass die eingereichte URL nicht der Safe Browsing-Sperrliste hinzugefügt wurde, 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 „CLOSED“

Wenn der Vorgangsstatus CLOSED ist, kann SubmitUriMetadata ein 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 enthielt keine schädlichen Inhalte. Das bedeutet, dass die URL unserer Analyse zufolge die Kriterien für die Sperrliste nicht erfüllt.
    • Empfohlene Nutzeraktion: In der Regel sind keine weiteren Maßnahmen für diese URL erforderlich, da sie keine Bedrohung darstellt. Reichen Sie die URL nicht wiederholt ein, es sei denn, die Inhalte ändern sich und es gibt neue Beweise für schädliche Aktivitäten.
  • HOST_UNRESOLVABLE:
    • Beschreibung: Wir konnten die Analyse nicht abschließen, da der Hostname der URL nicht von DNS aufgelöst werden konnte. Das bedeutet oft, dass die Website offline ist, die Domain nicht mehr vorhanden ist oder ein vorübergehendes DNS-Problem aufgetreten ist. Wir können inaktive URLs 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 erreichbar waren. Dafür kann es verschiedene Gründe geben:
      • Die Webseite ist nicht mehr vorhanden (Fehler „404 Not Found“).
      • Auf dem Server der Website ist ein Fehler aufgetreten (Fehler „5xx Server Error“).
      • Die Website zeigt unserem Analysesystem möglicherweise andere Inhalte als einem normalen Besucher (Cloaking), was eine vollständige Bewertung verhindert.
    • 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. in bestimmten geografischen Regionen, 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 ThreatDiscovery Felder in der 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.