1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="safebrowsing_v4.html">Safe Browsing APIs</a> . <a href="safebrowsing_v4.fullHashes.html">fullHashes</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#find">find(body, x__xgafv=None)</a></code></p>
<p class="firstline">Finds the full hashes that match the requested hash prefixes.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="find">find(body, x__xgafv=None)</code>
<pre>Finds the full hashes that match the requested hash prefixes.
Args:
body: object, The request body. (required)
The object takes the form of:
{ # Request to return full hashes matched by the provided hash prefixes.
"client": { # The client metadata associated with Safe Browsing API requests. # The client metadata.
"clientVersion": "A String", # The version of the client implementation.
"clientId": "A String", # A client ID that (hopefully) uniquely identifies the client implementation of the Safe Browsing API.
},
"threatInfo": { # The information regarding one or more threats that a client submits when checking for matches in threat lists. # The lists and hashes to be checked.
"threatTypes": [ # The threat types to be checked.
"A String",
],
"threatEntries": [ # The threat entries to be checked.
{ # An individual threat; for example, a malicious URL or its hash representation. Only one of these fields should be set.
"url": "A String", # A URL.
"hash": "A String", # A hash prefix, consisting of the most significant 4-32 bytes of a SHA256 hash. This field is in binary format.
"digest": "A String", # The digest of an executable in SHA256 format. The API supports both binary and hex digests.
},
],
"platformTypes": [ # The platform types to be checked.
"A String",
],
"threatEntryTypes": [ # The entry types to be checked.
"A String",
],
},
"clientStates": [ # The current client states for each of the client's local threat lists.
"A String",
],
}
x__xgafv: string, V1 error format.
Returns:
An object of the form:
{
"matches": [ # The full hashes that matched the requested prefixes.
{ # A match when checking a threat entry in the Safe Browsing threat lists.
"threatType": "A String", # The threat type matching this threat.
"threatEntryMetadata": { # The metadata associated with a specific threat entry. The client is expected to know the metadata key/value pairs associated with each threat type. # Optional metadata associated with this threat.
"entries": [ # The metadata entries.
{ # A single metadata entry.
"value": "A String", # The metadata entry value.
"key": "A String", # The metadata entry key.
},
],
},
"threatEntryType": "A String", # The threat entry type matching this threat.
"cacheDuration": "A String", # The cache lifetime for the returned match. Clients must not cache this response for more than this duration to avoid false positives.
"threat": { # An individual threat; for example, a malicious URL or its hash representation. Only one of these fields should be set. # The threat matching this threat.
"url": "A String", # A URL.
"hash": "A String", # A hash prefix, consisting of the most significant 4-32 bytes of a SHA256 hash. This field is in binary format.
"digest": "A String", # The digest of an executable in SHA256 format. The API supports both binary and hex digests.
},
"platformType": "A String", # The platform type matching this threat.
},
],
"negativeCacheDuration": "A String", # For requested entities that did not match the threat list, how long to cache the response.
"minimumWaitDuration": "A String", # The minimum duration the client must wait before issuing any find hashes request. If this field is not set, clients can issue a request as soon as they want.
}</pre>
</div>
</body></html>
|
