Ten dokument dotyczy tej metody: Update API (v4): threatListUpdates.fetch.
Ustawianie ograniczeń
Podczas aktualizowania lokalnych baz danych (patrz Aktualizacje bazy danych) klienci mogą używać pól maxUpdateEntries i maxDatabaseEntries w żądaniu</threatListUpdates.fetch, aby określić ograniczenia rozmiaru. Klienci powinni ustawiać ograniczenia, aby zachować przewidywalne wykorzystanie pamięci RAM, dysku i przepustowości klienta oraz zabezpieczyć się przed wzrostem liczby list.
- Klienci mogą określić maksymalny rozmiar odpowiedzi na aktualizację (
maxUpdateEntries) w liczbie wpisów (1 wpis = 1 dodanie lub 1 usunięcie). - Klienci mogą określać maksymalny rozmiar bazy danych (
maxDatabaseEntries) w liczbie wpisów (zdecydowanie większość wpisów w bazie danych to 4-bajtowe prefiksy skrótu, więc można przyjąć, że 1 wpis ≈ 4 bajtów).
Przepustowość a miejsce na dane
Klienci mogą określać dowolne rozmiary odpowiedzi na aktualizację i bazy danych, ale serwer Bezpiecznego przeglądania wstępnie generuje jedynie ograniczoną liczbę możliwych odpowiedzi na aktualizację i rozmiarów bazy danych.
- Aby ograniczyć wykorzystanie przepustowości, klienty powinny używać rozmiaru odpowiedzi na żądanie aktualizacji (
maxUpdateEntries). - Klient powinien używać rozmiaru bazy danych (
maxDatabaseEntries), aby ograniczyć ilość pamięci RAM lub miejsca potrzebnego na urządzeniu.
Wskazówki dotyczące ustawiania ograniczeń
Rozmiar list Bezpiecznego przeglądania może zmieniać się stopniowo lub nagle. Klienci powinni ustawiać maxUpdateEntries dla żądań aktualizacji listy, co ogranicza maksymalny rozmiar odpowiedzi na aktualizację listy i zwiększa niezawodność, gdy nie można przetworzyć dużych aktualizacji.
W przypadku braku bardziej rygorystycznych wymagań lub wymagań, które są mniej rygorystyczne, Google zaleca użycie właściwości maxUpdateEntries=16777216. Przy typowym rozmiarze wpisu na liście, który wynosi 4 bajty na prefiks skrótu, odpowiada to około 67 MB na listę. W przypadku klientów mobilnych Google zaleca używanie mniejszego limitu, ponieważ maxUpdateEntries=2097152 jest zwykle mniej wydajny. Przy typowym rozmiarze pozycji na liście, który wynosi 4 bajty na prefiks skrótu, odpowiada to około 8 megabajtów na listę.
Listy Bezpiecznego przeglądania różnią się rozmiarem i tempem wzrostu. Jednak klient powinien ustawić te same ograniczenia dla wszystkich list na podstawie maksymalnego dozwolonego wykorzystania pamięci lub przepustowości dla każdej listy.
Aby zwiększyć niezawodność, Google zaleca klientom wdrożenie telemetrii wykrywających nadmierne wykorzystanie pamięci lub przepustowości, a także mechanizmy szybkiego dostarczania klientom nowych ograniczeń.
Stan klienta
Serwer Bezpiecznego przeglądania nigdy nie wysyła aktualizacji, dzięki którym klient pozostaje w nieaktualnym stanie. Klienty są zawsze w pełni aktualne po każdym żądaniu aktualizacji. Jeśli na przykład klient ma obecnie bazę danych zawierającą 4096 pozycji, ale chce pobrać maksymalnie 2048 delta, serwer może zresetować klienta do bazy danych 2048, jeśli klient jest naprawdę nieaktualny.