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 dikirim telah ditambahkan ke Daftar Blokir Safe Browsing.
  • CLOSED: Menunjukkan bahwa URL yang dikirim tidak ditambahkan ke daftar blokir Safe Browsing karena tidak ditemukan melanggar kebijakan Safe Browsing.
  • RUNNING: Menunjukkan bahwa pengiriman masih diproses.

Memahami alasan CLOSED

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 blokir.

Nilai yang mungkin untuk closed_reason adalah sebagai berikut:

  • CLOSED_REASON_UNSPECIFIED: Alasannya tidak ditentukan.
  • NO_THREAT_DETECTED:
    • Deskripsi: URL yang dikirim berhasil dianalisis dan tidak ditemukan berisi konten berbahaya. Hal ini menunjukkan bahwa, berdasarkan analisis kami, URL tersebut tidak memenuhi kriteria untuk dimasukkan ke daftar blokir.
    • Tindakan Pengguna yang Direkomendasikan: Biasanya tidak ada tindakan lebih lanjut yang diperlukan untuk URL ini, karena tidak ditemukan sebagai ancaman. Jangan berulang kali mengirim ulang kecuali jika konten berubah dan bukti baru aktivitas berbahaya muncul.
  • 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 placeholder atau tidak aktif ke daftar blokir.
    • 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 "5xx Server Error").
      • Situs mungkin menampilkan konten yang berbeda ke sistem analisis kami daripada yang akan ditampilkan kepada pengunjung biasa (ini adalah cloaking), sehingga mencegah penilaian lengkap.
    • Tindakan Pengguna yang Direkomendasikan:
      • Periksa Aksesibilitas: Pastikan konten berbahaya dapat dijangkau. Perhatikan bahwa beberapa situs mungkin hanya menampilkan konten berbahaya dalam kondisi tertentu (ini adalah lokasi geografis, perangkat, atau browser tertentu).
      • Berikan Konteks Tambahan: Jika URL dapat diakses dalam kondisi tertentu, kirim ulang. Gunakan kolom ThreatDiscovery di SubmitUriRequest untuk memberikan detail tambahan, seperti wilayah dan platform tempat ancaman diamati. Informasi ini dapat meningkatkan kemungkinan analisis yang berhasil.