ThreatMatch
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
ThreatEntryMetadata
与特定威胁条目关联的元数据。客户端应知道与每种威胁类型关联的元数据键值对。
MetadataEntry
JSON 表示法 |
{
"key": string,
"value": string
} |
字段 |
key |
string (bytes format)
元数据条目键。对于 JSON 请求,密钥采用 base64 编码。 使用 base64 编码的字符串。
|
value |
string (bytes format)
元数据条目值。对于 JSON 请求,该值采用 base64 编码。 使用 base64 编码的字符串。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eThreatMatch indicates a match when checking for threats in Safe Browsing threat lists, containing information about the threat type, platform, and entry type.\u003c/p\u003e\n"],["\u003cp\u003eIt includes optional metadata associated with the specific threat entry, which may provide additional context.\u003c/p\u003e\n"],["\u003cp\u003eThreatEntryMetadata stores this metadata as key-value pairs, understood by the client based on the threat type.\u003c/p\u003e\n"],["\u003cp\u003eMetadataEntry represents a single metadata entry, where both the key and value are base64-encoded for JSON requests.\u003c/p\u003e\n"]]],["The document defines data structures for threat matches in Safe Browsing. A threat match includes `threatType`, `platformType`, `threatEntryType`, and the matching `threat`. It may optionally contain `threatEntryMetadata`, consisting of `MetadataEntry` objects with `key` and `value` string pairs. Each match also specifies `cacheDuration`, dictating how long the match should be considered valid, to avoid false positives. Data representation is in JSON format with specific structure for `ThreatEntryMetadata` and `MetadataEntry`.\n"],null,["# ThreatMatch\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [ThreatEntryMetadata](#ThreatEntryMetadata)\n - [JSON representation](#ThreatEntryMetadata.SCHEMA_REPRESENTATION)\n- [MetadataEntry](#MetadataEntry)\n - [JSON representation](#MetadataEntry.SCHEMA_REPRESENTATION)\n\nA match when checking a threat entry in the Safe Browsing threat lists.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"threatType\": enum (/safe-browsing/reference/rest/v4/ThreatType), \"platformType\": enum (/safe-browsing/reference/rest/v4/PlatformType), \"threatEntryType\": enum (/safe-browsing/reference/rest/v4/ThreatEntryType), \"threat\": { object (/safe-browsing/reference/rest/v4/ThreatEntry) }, \"threatEntryMetadata\": { object (/safe-browsing/reference/rest/v4/ThreatMatch#ThreatEntryMetadata) }, \"cacheDuration\": string } ``` |\n\n| Fields ||\n|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `threatType` | `enum (`[ThreatType](/safe-browsing/reference/rest/v4/ThreatType)`)` The threat type matching this threat. |\n| `platformType` | `enum (`[PlatformType](/safe-browsing/reference/rest/v4/PlatformType)`)` The platform type matching this threat. |\n| `threatEntryType` | `enum (`[ThreatEntryType](/safe-browsing/reference/rest/v4/ThreatEntryType)`)` The threat entry type matching this threat. |\n| `threat` | `object (`[ThreatEntry](/safe-browsing/reference/rest/v4/ThreatEntry)`)` The threat matching this threat. |\n| `threatEntryMetadata` | `object (`[ThreatEntryMetadata](/safe-browsing/reference/rest/v4/ThreatMatch#ThreatEntryMetadata)`)` Optional metadata associated with this threat. |\n| `cacheDuration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` The cache lifetime for the returned match. Clients must not cache this response for more than this duration to avoid false positives. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n\nThreatEntryMetadata\n-------------------\n\nThe metadata associated with a specific threat entry. The client is expected to know the metadata key/value pairs associated with each threat type.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------|\n| ``` { \"entries\": [ { object (/safe-browsing/reference/rest/v4/ThreatMatch#MetadataEntry) } ] } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------------|\n| `entries[]` | `object (`[MetadataEntry](/safe-browsing/reference/rest/v4/ThreatMatch#MetadataEntry)`)` The metadata entries. |\n\nMetadataEntry\n-------------\n\nA single metadata entry.\n\n| JSON representation |\n|--------------------------------------------|\n| ``` { \"key\": string, \"value\": string } ``` |\n\n| Fields ||\n|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `key` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` The metadata entry key. For JSON requests, the key is base64-encoded. A base64-encoded string. |\n| `value` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` The metadata entry value. For JSON requests, the value is base64-encoded. A base64-encoded string. |"]]