장기 실행 작업

Submission API는 비동기식이며 장기 실행 작업을 반환합니다. 메서드가 응답을 반환하면 작업이 완료되지 않을 수 있습니다.

작업 상태 가져오기

다음은 작업 상태를 폴링하는 방법을 보여줍니다.

작업 유형에 대해 GET 메서드를 호출합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • project-number: Google Cloud 프로젝트 번호입니다.
  • operation-id: 작업 ID입니다.

HTTP 메서드 및 URL:

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

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

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

PowerShell

다음 명령어를 실행합니다.

$cred = gcloud auth application-default 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: 제출된 URL이 세이프 브라우징 차단 목록에 추가되었음을 나타냅니다.

  • CLOSED: 제출된 URL이 세이프 브라우징 정책을 위반하는 것으로 감지되지 않았고 최근 24시간 동안 세이프 브라우징 차단 목록에 추가되지 않았음을 나타냅니다.