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
|
<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 API</a> . <a href="safebrowsing_v4.threatHits.html">threatHits</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#create">create(body, x__xgafv=None)</a></code></p>
<p class="firstline">Reports a Safe Browsing threat list hit to Google. Only projects with</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="create">create(body, x__xgafv=None)</code>
<pre>Reports a Safe Browsing threat list hit to Google. Only projects with
TRUSTED_REPORTER visibility can use this method.
Args:
body: object, The request body. (required)
The object takes the form of:
{
"threatType": "A String", # The threat type reported.
"clientInfo": { # The client metadata associated with Safe Browsing API requests. # Client-reported identification.
"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.
},
"userInfo": { # Details about the user that encountered the threat. # Details about the user that encountered the threat.
"regionCode": "A String", # The UN M.49 region code associated with the user's location.
"userId": "A String", # Unique user identifier defined by the client.
},
"entry": { # An individual threat; for example, a malicious URL or its hash # The threat entry responsible for the hit. Full hash should be reported for
# hash-based hits.
# 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. For JSON requests, hashes are
# base64-encoded.
"digest": "A String", # The digest of an executable in SHA256 format. The API supports both
# binary and hex digests. For JSON requests, digests are base64-encoded.
},
"platformType": "A String", # The platform type reported.
"resources": [ # The resources related to the threat hit.
{ # A single resource related to a threat hit.
"url": "A String", # The URL of the resource.
"referrer": "A String", # Referrer of the resource. Only set if the referrer is available.
"type": "A String", # The type of source reported.
"remoteIp": "A String", # The remote IP of the resource in ASCII format. Either IPv4 or IPv6.
},
],
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A generic empty message that you can re-use to avoid defining duplicated
# empty messages in your APIs. A typical example is to use it as the request
# or the response type of an API method. For instance:
#
# service Foo {
# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
# }
#
# The JSON representation for `Empty` is empty JSON object `{}`.
}</pre>
</div>
</body></html>
|
