שימוש ב-Submission API

שימוש ב-Submission API

בדף הזה מוסבר איך להשתמש ב-Submission API כדי לשלוח לניתוח ב'גלישה בטוחה' כתובות URL שאתם חושדים שהן לא בטוחות. כל כתובות ה-URL שתואמות למדיניות הגלישה הבטוחה יתווספו לשירות הגלישה הבטוחה.

לפני שמתחילים

כדי לקבל גישה לתכונה הזו, צריך לפנות לצוות המכירות שלנו או למהנדס הלקוחות.

שליחת כתובות URL

כדי לשלוח כתובת URL, שולחים בקשת HTTP POST לשיטה projects.submissions.create.

בקשת API

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud

ה-method של ה-HTTP וכתובת ה-URL: 

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

גוף בקשת JSON: 

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

כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

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

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

$cred = gcloud auth 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/",
}