使用 Submission API

预览

此功能须遵守服务专用条款的“通用服务条款”部分中的“非正式版产品条款”。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

本页介绍了如何使用 Submission API 将您认为不安全的网址提交至安全浏览进行分析。经确认符合安全浏览政策的所有网址都将添加到安全浏览服务中。

准备工作

如要获取此功能，请联系我们的销售团队或您的客户工程师。

提交网址

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

API 请求

在使用任何请求数据之前，请先进行以下替换：

PROJECT_ID：您的 Google Cloud 项目 ID

HTTP 方法和网址：

POST https://webrisk.googleapis.com/v1/projects/PROJECT-ID/submissions

请求 JSON 正文：

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

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

curl

注意：请确保已将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为服务账号私钥文件的路径。

将请求正文保存在名为 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/submissions"

PowerShell

注意：请确保已将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为服务账号私钥文件的路径。

将请求正文保存在名为 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/submissions" | Select-Object -Expand Content

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

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