Operazioni a lunga esecuzione

L'API Submission è asincrona e restituisce un'operazione a lunga esecuzione. L'operazione potrebbe non essere completata quando il metodo restituisce una risposta.

Recupero dello stato di un'operazione

Di seguito viene mostrato come eseguire il polling dello stato di un'operazione.

Chiama il metodo GET per il tipo Operations.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • project-number: il numero del tuo progetto Google Cloud
  • operation-id: l'ID dell'operazione

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando: 

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

PowerShell

Esegui questo comando: 

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Informazioni sullo stato dell'operazione

Il campo metadata.state nella risposta indica lo stato attuale dell'invio. Al termine dell'operazione, il campo state in SubmitUriMetadata viene aggiornato. I possibili stati sono i seguenti:

  • SUCCEEDED: indica che l'URL inviato è stato aggiunto alla lista bloccata di Navigazione sicura.
  • CLOSED: indica che l'URL inviato non è stato aggiunto alla lista bloccata di Navigazione sicura perché non è stato rilevato che violasse le norme di Navigazione sicura.
  • RUNNING: indica che i contenuti inviati sono ancora in fase di elaborazione.

Informazioni sui motivi di CLOSED

Quando lo stato dell'operazione è CLOSED, SubmitUriMetadata potrebbe includere un campo closed_reason. Questo campo fornisce un contesto aggiuntivo sul motivo per cui l'invio è stato chiuso senza che l'URL sia stato aggiunto a una lista bloccata.

I possibili valori per closed_reason sono i seguenti:

  • CLOSED_REASON_UNSPECIFIED: il motivo non è specificato.
  • NO_THREAT_DETECTED:
    • Descrizione: l'URL inviato è stato analizzato correttamente e non è stato rilevato che contenga contenuti dannosi. Ciò indica che, in base alla nostra analisi, l'URL non soddisfa i criteri per l'inserimento nella lista bloccata.
    • Azione utente consigliata: in genere non sono necessarie ulteriori azioni per questo URL, in quanto non è stato rilevato che costituisca una minaccia. Non inviare di nuovo ripetutamente a meno che i contenuti non cambino e non emergano nuove prove di attività dannose.
  • HOST_UNRESOLVABLE:
    • Descrizione: non è stato possibile completare l'analisi perché il nome host dell'URL non è stato risolto dal DNS. Spesso significa che il sito web non è attivo, il dominio non esiste più o si è verificato un problema DNS temporaneo. Non possiamo aggiungere URL inattivi o segnaposto alla lista bloccata.
    • Azione utente consigliata:
      • Verifica l'URL: assicurati che il nome host sia corretto e che il sito web sia attivo e accessibile pubblicamente.
      • Invia di nuovo: puoi inviare di nuovo l'URL in un secondo momento se confermi che il sito è attivo.
  • CONTENT_UNREACHABLE:
    • Descrizione: non è stato possibile completare l'analisi perché non è stato possibile raggiungere i contenuti del sito web. Questo può accadere per diversi motivi, ad esempio:
      • La pagina web non esiste più (si tratta di un errore "404 Not Found").
      • Il server del sito web ha riscontrato un errore (si tratta di un "errore del server 5xx").
      • Il sito web potrebbe mostrare contenuti diversi al nostro sistema di analisi rispetto a quelli che mostrerebbe a un visitatore normale (si tratta di cloaking), impedendo una valutazione completa.
    • Azione utente consigliata:
      • Controlla l'accessibilità: verifica che i contenuti dannosi siano raggiungibili. Tieni presente che alcuni siti potrebbero mostrare contenuti dannosi solo in condizioni specifiche (ovvero in determinate località geografiche, su determinati dispositivi o browser).
      • Fornisci ulteriore contesto: se l'URL è accessibile in condizioni specifiche, invialo di nuovo. Utilizza i campi ThreatDiscovery in SubmitUriRequest per fornire dettagli aggiuntivi, come la regione e la piattaforma in cui è stata osservata la minaccia. Queste informazioni possono aumentare la probabilità di un'analisi riuscita.