Этот документ относится к следующему методу: API обновления (v4) : ThreatListUpdates.fetch .
Установка ограничений
При обновлении локальных баз данных (см. Обновления баз данных ) клиенты могут использовать поля maxUpdateEntries и maxDatabaseEntries в запросе ThreatListUpdates.fetch для указания ограничений размера. Клиенты должны устанавливать ограничения для обеспечения предсказуемого потребления клиентской оперативной памяти, диска и пропускной способности, а также для защиты от роста списка.
- Клиенты могут указать максимальный размер ответа на обновление (
maxUpdateEntries) в количестве записей (1 запись = 1 добавление или 1 удаление). - Клиенты могут указать максимальный размер базы данных (
maxDatabaseEntries) в количестве записей (подавляющее большинство записей в базе данных представляют собой 4-байтовые хеш-префиксы, поэтому справедливо предположить, что 1 запись ≈ 4 байта).
Пропускная способность и хранилище
Хотя клиенты могут указывать произвольные размеры ответа на обновление и размеров базы данных, сервер безопасного просмотра предварительно генерирует только ограниченное число возможных ответов на обновление и размеров базы данных.
- Клиенты должны использовать размер ответа на обновление (
maxUpdateEntries), чтобы ограничить использование полосы пропускания. - Клиенты должны использовать размер базы данных (
maxDatabaseEntries), чтобы ограничить объем ОЗУ или дискового пространства, необходимого на устройстве.
Руководство по установке ограничений
Списки безопасного просмотра могут постепенно или внезапно изменяться в размере. Клиенты должны установить maxUpdateEntries для запросов на обновление списка, что ограничивает максимальный размер ответа на обновление списка и повышает надежность, когда большие обновления не могут быть обработаны.
При отсутствии более строгих или менее строгих требований Google рекомендует использовать maxUpdateEntries=16777216 . При типичном размере записи списка в 4 байта на префикс хэша это соответствует примерно 67 мегабайтам на список. Google рекомендует использовать меньший предел maxUpdateEntries=2097152 для мобильных клиентов, поскольку они обычно менее эффективны. При типичном размере записи списка в 4 байта на префикс хэша это соответствует примерно 8 мегабайтам на список.
Списки безопасного просмотра различаются по размеру и скорости роста. Однако клиенты должны устанавливать одинаковые ограничения для всех списков на основе максимально разрешенного использования памяти или полосы пропускания для каждого списка.
Чтобы повысить надежность, Google рекомендует клиентам реализовать телеметрию для обнаружения чрезмерного использования памяти или пропускной способности, а также механизмы для быстрого предоставления клиентам новых ограничений.
Состояние клиента
Сервер безопасного просмотра никогда не отправляет обновление, в результате которого клиент оказывается в устаревшем состоянии; клиенты будут полностью обновлены после каждого запроса на обновление. Например, если клиент в настоящее время имеет базу данных, содержащую 4096 записей, но хочет загрузить не более 2048 дельт, сервер может сбросить клиент до базы данных 2048, если клиент действительно устарел.