Method: hashLists.batchGet
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 |
names[] |
string
必要欄位。特定雜湊清單的名稱。這份清單可能是威脅清單,也可能是全域快取。名稱「不得」包含重複;如果新增,用戶端就會收到錯誤訊息。
|
version[] |
string (bytes format)
用戶端已有的雜湊清單版本。如果這是用戶端第一次擷取雜湊清單,這個欄位應留空。否則,用戶端應提供先前從伺服器接收的版本。用戶端「不得」操縱這些位元組。 用戶端不必按照對應清單名稱的順序傳送版本。用戶端在要求中傳送的版本數量可能少於名稱的數量。但用戶端「不得」傳送多個對應同一個名稱的版本。否則用戶端會收到錯誤訊息。 歷史附註:在 API 的 V4 中稱為 states 。為求清楚起見,現已重新命名為 version Base64 編碼字串。
|
desiredHashLength |
enum (HashLength )
所傳回雜湊的所需雜湊前置字串長度 (以位元組為單位)。接著,伺服器會傳回此指定長度的所有雜湊前置字元。 不同的雜湊清單對 desiredHashLength 欄位接受的值有不同的規定。您可以在 HashListMetadata 的 supportedHashLengths 欄位中找到這項資訊。如果 desiredHashLength 未在 supportedHashLengths 中指定值,就會傳回錯誤給用戶端。 特別是 BatchGetHashListsRequest 中,用戶端無法為不同清單指定不同的 desiredHashLength 。如果需要執行此操作,用戶端應分成多個 BatchGetHashListsRequest 。
|
sizeConstraints |
object (SizeConstraints )
每份清單的大小限制。如果省略,則沒有任何限制。請注意,這裡的大小是以名單為基準,而非所有名單的匯總大小。
|
回應主體
含有多個雜湊清單的回應。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
{
"hashLists": [
{
object (HashList )
}
]
} |
欄位 |
hashLists[] |
object (HashList )
雜湊清單的順序與要求中提供的順序相同。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-12 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-09-12 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-09-12 (世界標準時間)。"]]