長時間執行的作業

提交 API 為非同步，並會傳回長時間執行的作業。方法傳回回應時，作業可能尚未完成。

取得作業狀態

以下說明如何輪詢作業的狀態。

呼叫 Operations 類型的 GET 方法。

使用任何要求資料之前，請先替換以下項目：

  • project-number：您的 Google Cloud 專案編號
  • operation-id：您的作業 ID

HTTP 方法和網址：

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

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令：

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

PowerShell

執行下列指令：

$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

您應該會收到如下的 JSON 回應：

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

作業完成後，state 會傳回下列其中一個值：

  • SUCCEEDED：表示提交的網址已加入安全瀏覽封鎖清單。

  • CLOSED：表示系統在過去 24 小時內，未偵測到提交的網址違反安全瀏覽政策，因此未將該網址加入安全瀏覽封鎖清單。