ThreatMatch
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Kecocokan saat memeriksa entri ancaman dalam daftar ancaman Safe Browsing.
| Kolom |
threatType |
enum (ThreatType)
Jenis ancaman yang cocok dengan ancaman ini.
|
platformType |
enum (PlatformType)
Jenis platform yang cocok dengan ancaman ini.
|
threatEntryType |
enum (ThreatEntryType)
Jenis entri ancaman yang cocok dengan ancaman ini.
|
threat |
object (ThreatEntry)
Ancaman yang cocok dengan ancaman ini.
|
threatEntryMetadata |
object (ThreatEntryMetadata)
Metadata opsional yang terkait dengan ancaman ini.
|
cacheDuration |
string (Duration format)
Masa aktif cache untuk kecocokan yang ditampilkan. Klien tidak boleh meng-cache respons ini selama lebih dari durasi ini untuk menghindari positif palsu. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
|
ThreatEntryMetadata
Metadata yang terkait dengan entri ancaman tertentu. Klien diharapkan mengetahui key-value pair metadata yang terkait dengan setiap jenis ancaman.
MetadataEntry
| Representasi JSON |
{
"key": string,
"value": string
} |
| Kolom |
key |
string (bytes format)
Kunci entri metadata. Untuk permintaan JSON, kuncinya dienkode dengan base64. String berenkode base64.
|
value |
string (bytes format)
Nilai entri metadata. Untuk permintaan JSON, nilainya dienkode dengan base64. String berenkode base64.
|
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[[["\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. |"]]
