使用 Submission v2 API

概览

Submission API 可让您将自己认为不安全的网址提交给安全浏览进行分析，并异步检查这些提交内容的结果。任何经过确认符合安全浏览政策的所有网址都将添加到安全浏览服务中。

准备工作

要获得此功能的访问权限，请与销售人员或您的客户工程师联系。

提交网址

如要提交网址，请向 projects.uris.submit 方法发送 HTTP POST 请求。

Submission API 支持每个请求使用 1 个网址。如要检查多个网址，您需要对每个网址发送单独的请求。
网址必须有效（请参阅 RFC 2396），但无需进行规范化。
HTTP POST 响应会返回 long-running operation。如需详细了解如何检索提交内容的结果，请参阅 Long-running operations。

示例

HTTP 方法和网址：

POST https://webrisk.googleapis.com/v1/projects/project-id/uris:submit

请求 JSON 正文：

{
  "submission": {
    "uri": "https://www.phishingsite.com/",
  },
}

如需发送请求，请选择以下方式之一：

curl

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://webrisk.googleapis.com/v1/projects/project-id/uris:submit"

PowerShell

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method POST `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://webrisk.googleapis.com/v1/projects/project-id/uris:submit" | Select-Object -Expand Content

您应该会收到类似以下内容的 JSON 响应：

{
  "name": "projects/project-id/operations/operation-id",
}