Operasi yang Berjalan Lama

Submission API bersifat asinkron dan menampilkan operasi yang berjalan lama. Operasi mungkin tidak selesai saat metode menampilkan respons.

Mendapatkan status operasi

Berikut ini cara memeriksa status operasi.

Panggil metode GET untuk jenis Operasi.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • project-number: nomor project Google Cloud Anda
  • operation-id: ID operasi Anda

Metode HTTP dan URL: 

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

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

PowerShell

Jalankan perintah berikut: 

$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

Anda akan melihat respons JSON seperti berikut:

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

Memahami Status Operasi

Kolom metadata.state dalam respons menunjukkan status pengiriman saat ini. Setelah operasi selesai, kolom state di SubmitUriMetadata akan diperbarui. Status yang mungkin adalah sebagai berikut:

  • SUCCEEDED: Menunjukkan bahwa URL yang dikirimkan telah ditambahkan ke Daftar URL yang Tidak Diizinkan Safe Browsing.
  • CLOSED: Menunjukkan bahwa URL yang dikirim tidak ditambahkan ke daftar URL yang tidak diizinkan Safe Browsing karena tidak ditemukan melanggar kebijakan Safe Browsing.
  • RUNNING: Menunjukkan bahwa pengiriman masih diproses.

Memahami alasan DITUTUP

Jika status operasi adalah CLOSED, SubmitUriMetadata mungkin menyertakan kolom closed_reason. Kolom ini memberikan konteks tambahan tentang alasan pengiriman ditutup tanpa URL ditambahkan ke daftar yang tidak diizinkan.

Kemungkinan nilai untuk closed_reason adalah sebagai berikut:

  • CLOSED_REASON_UNSPECIFIED: Alasannya tidak ditentukan.
  • NO_THREAT_DETECTED:
    • Deskripsi: URL yang dikirimkan berhasil dianalisis dan tidak ditemukan berisi konten berbahaya. Hal ini menunjukkan bahwa, berdasarkan analisis kami, URL tersebut tidak memenuhi kriteria untuk dimasukkan dalam daftar yang diblokir.
    • Tindakan Pengguna yang Direkomendasikan: Biasanya tidak ada tindakan lebih lanjut yang diperlukan untuk URL ini, karena tidak ditemukan sebagai ancaman. Jangan kirim ulang berulang kali kecuali jika konten berubah dan muncul bukti baru aktivitas berbahaya.
  • HOST_UNRESOLVABLE:
    • Deskripsi: Kami tidak dapat menyelesaikan analisis karena nama host URL tidak dapat di-resolve oleh DNS. Hal ini sering kali berarti situs tidak aktif, domain tidak ada lagi, atau ada masalah DNS sementara. Kami tidak dapat menambahkan URL yang tidak aktif atau placeholder ke daftar yang tidak diizinkan.
    • Tindakan Pengguna yang Direkomendasikan:
      • Verifikasi URL: Pastikan nama host sudah benar dan situs aktif serta dapat diakses secara publik.
      • Kirim ulang: Anda dapat mengirim ulang URL nanti jika mengonfirmasi bahwa situs aktif.
  • CONTENT_UNREACHABLE:
    • Deskripsi: Analisis tidak dapat diselesaikan karena konten situs tidak dapat dijangkau. Hal ini dapat terjadi karena beberapa alasan, seperti:
      • Halaman web tidak ada lagi (ini adalah error "404 Not Found").
      • Server situs mengalami error (ini adalah "Error Server 5xx").
      • Situs mungkin menampilkan konten yang berbeda ke sistem analisis kami daripada yang ditampilkan kepada pengunjung biasa (ini adalah penyelubungan), sehingga mencegah penilaian penuh.
    • Tindakan Pengguna yang Direkomendasikan:
      • Periksa Aksesibilitas: Pastikan konten berbahaya dapat diakses. Perhatikan bahwa beberapa situs hanya dapat menampilkan konten berbahaya dalam kondisi tertentu (yaitu lokasi geografis, perangkat, atau browser tertentu).
      • Berikan Konteks Lainnya: Jika URL dapat diakses dalam kondisi tertentu, kirim ulang URL tersebut. Gunakan kolom ThreatDiscovery di SubmitUriRequest untuk memberikan detail tambahan, seperti wilayah dan platform tempat ancaman diamati. Informasi ini dapat meningkatkan kemungkinan keberhasilan analisis.