This document applies to the following method: Update API (v4): threatListUpdates.fetch.
Setting constraints
When updating local databases
(see Database Updates)
clients can use the maxUpdateEntries
and maxDatabaseEntries
fields in the
threatListUpdates.fetch request
to specify size constraints. Clients should set constraints only if they have memory or bandwidth
limitations.
- Clients can specify a maximum update response size (
maxUpdateEntries
) in number of entries (1 entry = 1 addition or 1 removal). - Clients can specify a maximum database size (
maxDatabaseEntries
) in number of entries (the vast majority of entries in the database are 4-byte hash prefixes so it’s fair to assume that 1 entry ≈ 4 bytes).
Bandwidth vs. storage
While clients may specify arbitrary sizes for the update response and database sizes, the Safe Browsing server only pre-generates a finite number of possible update response and database sizes.
- Clients should use the update response size (
maxUpdateEntries
) to limit bandwidth usage. - Clients should use the database size (
maxDatabaseEntries
) to limit the amount of RAM or disk storage needed on the device.
Client state
The Safe Browsing server never sends an update that leaves the client in an outdated state; clients will be fully up-to-date after every update request. For example, if a client currently has a database of 4096 entries but only wants to download at most 2048 deltas, the server may reset the client to a 2048 database if the client is really out-of-date.