Blame - docs/dyn/safebrowsing_v4.encodedUpdates.html - platform/external/python/google-api-python-client

"minimumWaitDuration": "A String", # The minimum duration the client must wait before issuing any update request. If this field is not set clients may update as soon as they want.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

107

"listUpdateResponses": [ # The list updates requested by the clients.

Sai Cheemalapati

c30d2b5

2017-03-13 12:12:03 -0400

[diff] [blame]

108

{ # An update to an individual list.

Dmitry Frenkel

3e17f89

2020-10-06 16:46:05 -0700

[diff] [blame]

109

"checksum": { # The expected state of a client's local database. # The expected SHA256 hash of the client state; that is, of the sorted list of all hashes present in the database after applying the provided update. If the client state doesn't match the expected state, the client must disregard this update and retry later.

110

"sha256": "A String", # The SHA256 hash of the client state; that is, of the sorted list of all hashes present in the database.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

111

},

Yoshi Automation Bot

b6971b0

2020-11-26 17:16:03 -0800

[diff] [blame]

112

"removals": [ # A set of entries to remove from a local threat type's list. In practice, this field is empty or contains exactly one ThreatEntrySet.

113

{ # A set of threats that should be added or removed from a client's local database.

114

"riceHashes": { # The Rice-Golomb encoded data. Used for sending compressed 4-byte hashes or compressed removal indices. # The encoded 4-byte prefixes of SHA256-formatted entries, using a Golomb-Rice encoding. The hashes are converted to uint32, sorted in ascending order, then delta encoded and stored as encoded_data.

Yoshi Automation Bot

0bf565c

2020-12-09 08:56:03 -0800

[diff] [blame^]

115

"encodedData": "A String", # The encoded deltas that are encoded using the Golomb-Rice coder.

Yoshi Automation Bot

b6971b0

2020-11-26 17:16:03 -0800

[diff] [blame]

116

"numEntries": 42, # The number of entries that are delta encoded in the encoded data. If only a single integer was encoded, this will be zero and the single value will be stored in `first_value`.

117

"riceParameter": 42, # The Golomb-Rice parameter, which is a number between 2 and 28. This field is missing (that is, zero) if `num_entries` is zero.

118

"firstValue": "A String", # The offset of the first entry in the encoded data, or, if only a single integer was encoded, that single integer's value. If the field is empty or missing, assume zero.

Yoshi Automation Bot

b6971b0

2020-11-26 17:16:03 -0800

[diff] [blame]

119

},

Yoshi Automation Bot

b6971b0

2020-11-26 17:16:03 -0800

[diff] [blame]

120

"riceIndices": { # The Rice-Golomb encoded data. Used for sending compressed 4-byte hashes or compressed removal indices. # The encoded local, lexicographically-sorted list indices, using a Golomb-Rice encoding. Used for sending compressed removal indices. The removal indices (uint32) are sorted in ascending order, then delta encoded and stored as encoded_data.

Yoshi Automation Bot

0bf565c

2020-12-09 08:56:03 -0800

[diff] [blame^]

121

"encodedData": "A String", # The encoded deltas that are encoded using the Golomb-Rice coder.

Yoshi Automation Bot

b6971b0

2020-11-26 17:16:03 -0800

[diff] [blame]

122

"numEntries": 42, # The number of entries that are delta encoded in the encoded data. If only a single integer was encoded, this will be zero and the single value will be stored in `first_value`.

123

"riceParameter": 42, # The Golomb-Rice parameter, which is a number between 2 and 28. This field is missing (that is, zero) if `num_entries` is zero.

124

"firstValue": "A String", # The offset of the first entry in the encoded data, or, if only a single integer was encoded, that single integer's value. If the field is empty or missing, assume zero.

Yoshi Automation Bot

b6971b0

2020-11-26 17:16:03 -0800

[diff] [blame]

125

},

126

"rawIndices": { # A set of raw indices to remove from a local list. # The raw removal indices for a local list.

127

"indices": [ # The indices to remove from a lexicographically-sorted local list.

128

42,

129

],

130

},

Yoshi Automation Bot

0bf565c

2020-12-09 08:56:03 -0800

[diff] [blame^]

131

"compressionType": "A String", # The compression type for the entries in this set.

Yoshi Automation Bot

b6971b0

2020-11-26 17:16:03 -0800

[diff] [blame]

132

"rawHashes": { # The uncompressed threat entries in hash format of a particular prefix length. Hashes can be anywhere from 4 to 32 bytes in size. A large majority are 4 bytes, but some hashes are lengthened if they collide with the hash of a popular URL. Used for sending ThreatEntrySet to clients that do not support compression, or when sending non-4-byte hashes to clients that do support compression. # The raw SHA256-formatted entries.

Yoshi Automation Bot

b6971b0

2020-11-26 17:16:03 -0800

[diff] [blame]

133

"prefixSize": 42, # The number of bytes for each prefix encoded below. This field can be anywhere from 4 (shortest prefix) to 32 (full SHA256 hash).

Yoshi Automation Bot

0bf565c

2020-12-09 08:56:03 -0800

[diff] [blame^]

134

"rawHashes": "A String", # The hashes, in binary format, concatenated into one long string. Hashes are sorted in lexicographic order. For JSON API users, hashes are base64-encoded.

Yoshi Automation Bot

b6971b0

2020-11-26 17:16:03 -0800

[diff] [blame]

135

},

136

},

137

],

Yoshi Automation Bot

0bf565c

2020-12-09 08:56:03 -0800

[diff] [blame^]

138

"additions": [ # A set of entries to add to a local threat type's list. Repeated to allow for a combination of compressed and raw data to be sent in a single response.

139

{ # A set of threats that should be added or removed from a client's local database.

140

"riceHashes": { # The Rice-Golomb encoded data. Used for sending compressed 4-byte hashes or compressed removal indices. # The encoded 4-byte prefixes of SHA256-formatted entries, using a Golomb-Rice encoding. The hashes are converted to uint32, sorted in ascending order, then delta encoded and stored as encoded_data.

141

"encodedData": "A String", # The encoded deltas that are encoded using the Golomb-Rice coder.

142

"numEntries": 42, # The number of entries that are delta encoded in the encoded data. If only a single integer was encoded, this will be zero and the single value will be stored in `first_value`.

143

"riceParameter": 42, # The Golomb-Rice parameter, which is a number between 2 and 28. This field is missing (that is, zero) if `num_entries` is zero.

144

"firstValue": "A String", # The offset of the first entry in the encoded data, or, if only a single integer was encoded, that single integer's value. If the field is empty or missing, assume zero.

145

},

146

"riceIndices": { # The Rice-Golomb encoded data. Used for sending compressed 4-byte hashes or compressed removal indices. # The encoded local, lexicographically-sorted list indices, using a Golomb-Rice encoding. Used for sending compressed removal indices. The removal indices (uint32) are sorted in ascending order, then delta encoded and stored as encoded_data.

147

"encodedData": "A String", # The encoded deltas that are encoded using the Golomb-Rice coder.

148

"numEntries": 42, # The number of entries that are delta encoded in the encoded data. If only a single integer was encoded, this will be zero and the single value will be stored in `first_value`.

149

"riceParameter": 42, # The Golomb-Rice parameter, which is a number between 2 and 28. This field is missing (that is, zero) if `num_entries` is zero.

150

"firstValue": "A String", # The offset of the first entry in the encoded data, or, if only a single integer was encoded, that single integer's value. If the field is empty or missing, assume zero.

151

},

152

"rawIndices": { # A set of raw indices to remove from a local list. # The raw removal indices for a local list.

153

"indices": [ # The indices to remove from a lexicographically-sorted local list.

42,

],

},

"compressionType": "A String", # The compression type for the entries in this set.

158

"rawHashes": { # The uncompressed threat entries in hash format of a particular prefix length. Hashes can be anywhere from 4 to 32 bytes in size. A large majority are 4 bytes, but some hashes are lengthened if they collide with the hash of a popular URL. Used for sending ThreatEntrySet to clients that do not support compression, or when sending non-4-byte hashes to clients that do support compression. # The raw SHA256-formatted entries.

159

"prefixSize": 42, # The number of bytes for each prefix encoded below. This field can be anywhere from 4 (shortest prefix) to 32 (full SHA256 hash).

160

"rawHashes": "A String", # The hashes, in binary format, concatenated into one long string. Hashes are sorted in lexicographic order. For JSON API users, hashes are base64-encoded.

},

},

],

"newClientState": "A String", # The new client state, in encrypted format. Opaque to clients.

165

"platformType": "A String", # The platform type for which data is returned.

166

"responseType": "A String", # The type of response. This may indicate that an action is required by the client when the response is received.