Package google.security.safebrowsing.v5alpha1

Dizin

SafeBrowsing

Güvenli Tarama API'leri, istemcilerin web kaynaklarını (genellikle URL'leri) Google'ın sürekli güncellenen güvenli olmayan web kaynakları listeleriyle karşılaştırarak kontrol etmesini sağlar.

BatchGetHashLists

rpc BatchGetHashLists(BatchGetHashListsRequest) returns (BatchGetHashListsResponse)

Aynı anda birden fazla karma listesi alın.

Bir müşterinin birden fazla karma listesi alması çok yaygındır. Normal Get yöntemini birden çok kez kullanmak yerine bu yöntemi kullanmak tercih edilir.

Bu, https://google.aip.dev/231 tarafından tanımlanan standart bir toplu GET yöntemidir ve HTTP yöntemi de GET'tir.
GetHashList

rpc GetHashList(GetHashListRequest) returns (HashList)

Bir karma listedeki en son içerikleri alın. Karma listesi, tehdit listesi veya Global Önbelleği gibi tehdit içermeyen bir liste olabilir.

Bu, https://google.aip.dev/131 tarafından tanımlanan standart bir Get yöntemidir ve HTTP yöntemi de GET'tir.
ListHashLists

rpc ListHashLists(ListHashListsRequest) returns (ListHashListsResponse)

Karma listeleri listeleyin.

Google, V5 API'de bu yöntemle daha önce döndürülmüş bir karma listesi hiçbir zaman kaldırmaz. Bu sayede istemciler bu yöntemi kullanmadan, ihtiyaç duydukları tüm karma listelerini sabit kod olarak kullanabilir.

Bu, https://google.aip.dev/132 tarafından tanımlanan standart bir Liste yöntemidir ve HTTP yöntemi GET'tir.
SearchHashes

rpc SearchHashes(SearchHashesRequest) returns (SearchHashesResponse)

Belirtilen ön eklerle eşleşen tam karma oluşturma işlemlerini arayın.

Bu, https://google.aip.dev/136 tarafından tanımlanan özel bir yöntemdir (özel yöntem, Google'ın genel API geliştirme terminolojisinde özel bir ada sahip olan bu yöntemi ifade eder; özel bir HTTP yönteminin kullanılmasını ifade etmez).

BatchGetHashListsRequest

Aynı anda birden fazla karma listesi alma isteği.

Alanlar
names[]

string

Zorunlu. Belirli karma listelerinin adları. Liste bir tehdit listesi veya Global Önbelleği OLABİLİR. Adlar yinelenen adlar İÇERMEMELİDİR. Aksi takdirde istemci hata alır.
version[]

bytes

İstemcinin hâlihazırda sahip olduğu karma listesi sürümleri. İstemci karma listelerini ilk kez getiriyorsa alan boş bırakılmalıdır. Aksi takdirde istemci, daha önce sunucudan alınan sürümleri sağlamalıdır. Müşteri bu baytları DEĞİŞTİRMEmelidir.

İstemcinin sürümleri ilgili liste adlarıyla aynı sırayla göndermesi gerekmez. Müşteri, bir istekte adlardan daha az veya daha fazla sürüm gönderebilir. Ancak istemci aynı ada karşılık gelen birden fazla sürüm GÖNDERMEMELİDİR. Aksi takdirde istemci hata alır.

Geçmiş not: API'nin 4. sürümünde bu states olarak adlandırılıyordu. Daha net olması için version olarak yeniden adlandırıldı.
desired_hash_length
(deprecated)

HashLength

Döndürülen karmaların bayt cinsinden istenen karma önek uzunluğu. Sunucu daha sonra bu belirtilen uzunluktaki tüm karma ön eklerinin döndürür.

Farklı karma listeleri, desired_hash_length alanının kabul edilebilir değerleriyle ilgili farklı koşullara sahiptir. Bu bilgiyi HashListMetadata'daki supported_hash_lengths alanında bulabilirsiniz. desired_hash_length, supported_hash_lengths içinde bir değer belirtmezse istemcilere hata döndürülür.

Özellikle BatchGetHashListsRequest için istemcilerin farklı listeler için farklı bir desired_hash_length belirtmesi mümkün değildir. Bunun yapılması gerekiyorsa istemci birden fazla BatchGetHashListsRequest'ye bölünmelidir.
size_constraints

SizeConstraints

Her listenin boyut kısıtlamaları. Atlanırsa herhangi bir kısıtlama yoktur. Buradaki boyutların tüm listeler genelinde toplanmış değil, liste başına olduğunu unutmayın.

BatchGetHashListsResponse

Birden fazla karma liste içeren yanıt.

Alanlar
hash_lists[]

HashList

Karma, istekte verilen sırayla listelenir.

FullHash

Bir veya daha fazla eşleşmeyle tanımlanan tam karma.

Alanlar
full_hash

bytes

Eşleşen tam karma. Bu, SHA256 karmasıdır. Uzunluk tam olarak 32 bayttır.
full_hash_details[]

FullHashDetail

Sırasız liste. Bu tam karma oluşturma işlemiyle ilgili ayrıntıları tanımlayan tekrarlanan bir alan.

FullHashDetail

Eşleşen tam karma ile ilgili ayrıntılar.

Gelecek uyumluluğuyla ilgili önemli bir not: Sunucu tarafından dilediğiniz zaman yeni tehdit türleri ve tehdit özellikleri eklenebilir. Bu eklemeler küçük sürüm değişiklikleri olarak kabul edilir. Google'ın politikası, API'lerde küçük sürüm numaralarını göstermemektir (sürüm politikası için https://cloud.google.com/apis/design/versioning adresine bakın). Bu nedenle, istemciler ThreatType enum değerleri veya istemci tarafından geçersiz kabul edilen ThreatAttribute enum değerleri içeren FullHashDetail mesajları almaya HAZIR OLMALIDIR. Bu nedenle, tüm ThreatType ve ThreatAttribute enum değerlerinin geçerliliğini kontrol etmek istemcinin sorumluluğundadır. Herhangi bir değer geçersiz kabul edilirse istemcinin FullHashDetail mesajının tamamını yoksaması GEREKİR.

Alanlar
threat_type

ThreatType

Tehdidin türü. Bu alan hiçbir zaman boş olmaz.
attributes[]

ThreatAttribute

Sırasız liste. Bu tam karmalarla ilgili ek özellikler. Bu alan boş olabilir.

GetHashListRequest

Tehdit listesi veya Genel Önbelleğe benzer bir tehdit dışı liste olabilecek bir karma listesi alma isteği.

Sürüm 5'teki yenilikler: Daha önce sürüm 4'te states olarak adlandırılan öğe, daha anlaşılır olması için version olarak yeniden adlandırıldı. Listeler artık adlandırılmış, platform türleri ve tehdit girişi türleri kaldırılmıştır. Artık birden fazla listenin aynı tehdit türüne sahip olması veya tek bir listenin birden fazla tehdit türüyle ilgili olması mümkün. İstemciler artık istedikleri karma uzunluğunu belirtebilir. Bu, V4'ün birçok istemci uygulamasında soruna neden olan değişken uzunlukta karma ön eklerinin cevabının bir parçasıdır: Bir listedeki tüm karmaların uzunluğu artık tektir ve çok daha verimli istemci uygulamalarına olanak tanır. Kısıtlamalar basitleştirildi ve sıkıştırma türü kaldırıldı (sıkıştırma her zaman uygulanır).

Alanlar
name

string

Zorunlu. Bu karma liste adı. Bu, bir tehdit listesi veya Global Önbelleği olabilir.
version

bytes

İstemcinin sahip olduğu karma listesi sürümü. İstemci karma listesi ilk kez getiriyorsa bu alan BOŞ BIRAKILMALIDIR. Aksi takdirde istemci, daha önce sunucudan alınan sürümü sağlamalıdır. Müşteri bu baytları DEĞİŞTİRMEmelidir.

V5'teki yenilikler: API'nin 4. sürümünde states olarak adlandırılan bu parametre, daha anlaşılır olması için version olarak yeniden adlandırıldı.
desired_hash_length
(deprecated)

HashLength

Döndürülen karmaların bayt cinsinden istenen karma önek uzunluğu. Sunucu daha sonra bu belirtilen uzunluktaki tüm karma ön eklerinin döndürür.

Farklı karma listeleri, desired_hash_length alanının kabul edilebilir değerleriyle ilgili farklı koşullara sahiptir. Bu bilgiyi HashListMetadata'daki supported_hash_lengths alanında bulabilirsiniz. desired_hash_length, supported_hash_lengths içinde bir değer belirtmezse hata döndürülür.
size_constraints

SizeConstraints

Listede boyut kısıtlamaları. Atlanırsa herhangi bir kısıtlama yoktur. Sınırlı işlem gücü, bant genişliği veya depolama alanına sahip tüm cihazlarda kısıtlamalar önerilir.

HashList

Adıyla tanımlanan karma oluşturma işlemlerinin listesi.

Alanlar
name

string

Karma listesi adı. Genel önbelleğin de yalnızca bir karma liste olduğunu ve buradan referans alınabileceğini unutmayın.
version

bytes

Karma listesi sürümü. Müşteri bu baytları DEĞİŞTİRMEmelidir.
partial_update

bool

Doğru olduğunda, istemcinin mevcut durumuna göre ekleme ve kaldırma işlemlerini içeren kısmi bir farktır. Yanlış olduğunda bu, karma listesi tamamıdır.

Yanlış olduğunda istemci, bu karma liste için yerel olarak depolanan tüm sürümleri SİLMELİDİR. Bu, istemcinin sahip olduğu sürümün ciddi ölçüde güncel olmadığı veya istemci verilerinin bozuk olduğu anlamına gelir. compressed_removals alanı boş olur.

Doğru olduğunda istemci, kaldırma ve ardından ekleme işlemlerini uygulayarak artımlı güncelleme UYGULAMALIDIR.
compressed_removals

RiceDeltaEncoded32Bit

Kaldırma dizinlerinin Rice-delta kodlanmış sürümü. Her karma liste kesinlikle 2^32'den az girişe sahip olduğundan, dizinler 32 bit tam sayı olarak değerlendirilir ve kodlanır.
minimum_wait_duration

Duration

İstemcilerin karma listesi tekrar almak için en az bu kadar beklemesi gerekir. Atlanırsa veya sıfır olursa istemciler hemen getirmelidir. Bu, sunucunun istemciye gönderilecek ek bir güncellemesi olduğunu ancak istemci tarafından belirtilen kısıtlamalar nedeniyle bunu gönderemediğini gösterir.
sha256_checksum

bytes

SHA256 ile tekrar karma oluşturma işlemi uygulanmış tüm karma değerlerinin sıralı listesi. Bu, sağlanan güncelleme uygulandıktan sonra veritabanında bulunan tüm karma oluşturma işlemlerinin sıralı listesinin sağlama toplamıdır. Hiçbir güncelleme sağlanmazsa sunucu, istemcinin mevcut sağlama toplamını kullanması gerektiğini belirtmek için bu alanı atlar.
metadata

HashListMetadata

Karma oluşturma listesi ile ilgili meta veriler. Bu, GetHashList yöntemi tarafından değil, ListHashLists yöntemi tarafından doldurulur.
Birlik alanı compressed_additions. Eklemelerin Rice-delta kodlanmış sürümü. Eklenen öğelerin karma önek uzunlukları, listedeki tüm eklemeler için aynıdır. İstemci tarafından gönderilen desired_hash_length veya istemci bu alanı atladıysa sunucu tarafından seçilen bir değerdir. compressed_additions yalnızca aşağıdakilerden biri olabilir:
additions_four_bytes

RiceDeltaEncoded32Bit

4 baytlık eklemeler.
additions_eight_bytes

RiceDeltaEncoded64Bit

8 baytlık eklemeler.
additions_sixteen_bytes

RiceDeltaEncoded128Bit

16 baytlık eklemeler.
additions_thirty_two_bytes

RiceDeltaEncoded256Bit

32 baytlık eklemeler.

HashListMetadata

Belirli bir karma listeyle ilgili meta veriler.

Alanlar
threat_types[]

ThreatType

Sırasız liste. Boş değilse karma listesi bir tür tehdit listesi olduğunu belirtir ve bu karma listesindeki karmalarla veya karma ön ekleriyle ilişkili tehdit türlerini listeler. Giriş bir tehdit oluşturmuyorsa (ör. muhtemelen güvenli bir türü temsil ediyorsa) boş olabilir.
likely_safe_types[]

LikelySafeType

Sırasız liste. Boş değilse karma listesi, büyük olasılıkla güvenli karmaların listesini temsil eder ve bu karmaların büyük olasılıkla güvenli kabul edilme yollarını belirtir. Bu alan, threat_types alanıyla birlikte kullanılamaz.
description

string

Bu listeyle ilgili, kullanıcıların okuyabileceği bir açıklama. İngilizce yazılmış olmalıdır.
supported_hash_lengths[]
(deprecated)

HashLength

Bu karma liste için desteklenen karma uzunlukları. Her karma listesi en az bir uzunluk destekler. Bu nedenle bu alan boş olmaz.
hash_length

HashLength

Bu karma liste için desteklenen karma uzunluğu. Her karma listesi tam olarak bir uzunluk destekler. Aynı tehdit türü veya güvenli tür grubu için farklı bir karma oluşturma uzunluğu eklenirse bu, farklı bir ada ve ilgili karma oluşturma uzunluğuna sahip ayrı bir liste olarak eklenir.

HashLength

Bir karma listedeki karmaların uzunluğu.

Sıralamalar
HASH_LENGTH_UNSPECIFIED Belirtilmemiş uzunluk. Sunucu, istemciye verdiği yanıtlarda bu değeri döndürmez (supported_hash_lengths alanında), ancak istemcinin bu değeri sunucuya göndermesine izin verilir (desired_hash_length alanında). Bu durumda sunucu otomatik olarak bir değer seçer. İstemciler, sunucunun bir değer seçmesine İZİN VERMELİDİR.
FOUR_BYTES Her karma oluşturma işlemi dört baytlık bir ön ektir.
EIGHT_BYTES Her karma oluşturma işlemi sekiz baytlık bir ön ektir.
SIXTEEN_BYTES Her karma oluşturma işlemi on altı baytlık bir ön ektir.
THIRTY_TWO_BYTES Her karma, otuz iki baytlık tam karmadır.

LikelySafeType

Muhtemelen güvenli site türleri.

SearchHashesResponse'ün LikelySafeType içermediğini unutmayın.

Sıralamalar
LIKELY_SAFE_TYPE_UNSPECIFIED Bilinmiyor.
GENERAL_BROWSING Bu site, genel olarak göz atmak için büyük olasılıkla yeterince güvenlidir. Buna genel önbellek de denir.
CSD Bu site, istemci tarafı algılama modelleri veya şifre koruması kontrolleri çalıştırmaya gerek kalmayacak kadar güvenli olabilir.
DOWNLOAD Bu site, siteden yapılan indirmelerin kontrol edilmesine gerek kalmayacak kadar güvenlidir.

ListHashListsRequest

Mevcut karma listeleri listeleme isteği.

Alanlar
page_size

int32

Döndürülecek maksimum karma listesi sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Belirtilmemişse sunucu, sayfalandırma gerekmemesi için karma liste sayısından daha büyük olabilecek bir sayfa boyutu seçer.
page_token

string

Önceki bir ListHashLists çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

ListHashListsResponse

Karma listelerle ilgili meta verileri içeren yanıt.

Alanlar
hash_lists[]

HashList

Karma listeler keyfi bir sıradadır. İçerikleri değil, yalnızca karma listelerle ilgili meta veriler dahil edilir.
next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar olmaz.

RiceDeltaEncoded128Bit

128 bitlik sayıları kodlaması dışında RiceDeltaEncoded32Bit ile aynıdır.

Alanlar
first_value_hi

uint64

Kodlanmış verilerdeki ilk girişin üst 64 biti (karma oluşturma işlemleri). Alan boşsa üstteki 64 bitin tümü sıfırdır.
first_value_lo

fixed64

Kodlanmış verilerdeki ilk girişin alt 64 biti (karma). Alan boşsa alttaki 64 bitin tümü sıfırdır.
rice_parameter

int32

Golomb-Rice parametresi. Bu parametrenin 99 ile 126 arasında (ikisi de dahil) olacağı garanti edilir.
entries_count

int32

Kodlanmış verilerde delta kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlandıysa bu değer sıfır olur ve tek değer first_value içinde saklanır.
encoded_data

bytes

Golomb-Rice kodlayıcısı kullanılarak kodlanan kodlanmış deltalar.

RiceDeltaEncoded256Bit

256 bit sayıları kodlaması dışında RiceDeltaEncoded32Bit ile aynıdır.

Alanlar
first_value_first_part

uint64

Kodlanmış verilerdeki ilk girişin ilk 64 biti (karma oluşturma işlemleri). Alan boşsa ilk 64 bitin tümü sıfırdır.
first_value_second_part

fixed64

Kodlanmış verilerdeki ilk girişin 65 ila 128. bitleri (karmalar). Alan boşsa 65 ile 128. bitlerin tümü sıfırdır.
first_value_third_part

fixed64

Kodlanmış verilerdeki ilk girişin 129 ila 192. bitleri (karmalar). Alan boşsa 129 ile 192 arasındaki bitlerin tümü sıfırdır.
first_value_fourth_part

fixed64

Kodlanmış verilerdeki ilk girişin son 64 biti (karma). Alan boşsa son 64 bitin tümü sıfırdır.
rice_parameter

int32

Golomb-Rice parametresi. Bu parametrenin 227 ile 254 arasında (dahil) olacağı garanti edilir.
entries_count

int32

Kodlanmış verilerde delta kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlandıysa bu değer sıfır olur ve tek değer first_value içinde saklanır.
encoded_data

bytes

Golomb-Rice kodlayıcısı kullanılarak kodlanan kodlanmış deltalar.

RiceDeltaEncoded32Bit

Rice-Golomb kodlu veriler. Karma oluşturma işlemleri veya kaldırma dizinleri için kullanılır. Buradaki her karma değerin veya dizinin aynı uzunlukta olduğu ve bu uzunluğun tam olarak 32 bit olduğu garanti edilir.

Genel olarak, tüm girişleri alfabetik olarak sıralarsak daha yüksek değerli bitlerin daha düşük değerli bitler kadar sık değişmediğini görürüz. Bu, girişler arasındaki bitişik farkı da hesaba katarsak daha yüksek değerli bitlerin sıfır olma olasılığının yüksek olduğu anlamına gelir. Bu yöntem, temel olarak belirli sayıda bit seçerek sıfır olma olasılığının yüksekliğinden yararlanır. Bu değerden daha önemli tüm bitlerin sıfır olma olasılığı yüksek olduğundan tek değerli kodlama kullanırız. rice_parameter alanına bakın.

Tarihsel not: Rice-delta kodlaması ilk olarak bu API'nin 4. sürümünde kullanıldı. V5'te iki önemli iyileştirme yapıldı: Birincisi, Rice-delta kodlaması artık 4 bayttan uzun karma ön ekleriyle kullanılabilir; ikincisi, kodlanmış veriler artık maliyetli bir sıralama adımı kullanmaktan kaçınmak için büyük endian olarak değerlendirilir.

Alanlar
first_value

uint32

Kodlanmış verilerdeki ilk giriş (karma oluşturma işlemleri veya dizinler) ya da yalnızca tek bir karma oluşturma ön eki veya dizini kodlandıysa bu girişin değeri. Alan boşsa giriş sıfır olur.
rice_parameter

int32

Golomb-Rice parametresi. Bu parametrenin 3 ile 30 arasında (dahil) olacağı garanti edilir.
entries_count

int32

Kodlanmış verilerde delta kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlandıysa bu değer sıfır olur ve tek değer first_value içinde saklanır.
encoded_data

bytes

Golomb-Rice kodlayıcısı kullanılarak kodlanan kodlanmış deltalar.

RiceDeltaEncoded64Bit

64 bitlik sayıları kodlaması dışında RiceDeltaEncoded32Bit ile aynıdır.

Alanlar
first_value

uint64

Kodlanmış verilerdeki (karmalar) ilk giriş veya yalnızca tek bir karma ön ek kodlanmışsa bu girişin değeri. Alan boşsa giriş sıfır olur.
rice_parameter

int32

Golomb-Rice parametresi. Bu parametrenin 35 ile 62 arasında (bu değerler dahil) olacağı garanti edilir.
entries_count

int32

Kodlanmış verilerde delta kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlandıysa bu değer sıfır olur ve tek değer first_value içinde saklanır.
encoded_data

bytes

Golomb-Rice kodlayıcısı kullanılarak kodlanan kodlanmış deltalar.

SearchHashesRequest

İstemcinin belirli karma ön ekleri aramak için gönderdiği istek.

Bu işlev yalnızca tehdit listelerini aramak için tasarlanmıştır ve Global Önbelleği gibi tehdit olmayan listeleri aramaz.

V5'te yenilikler: İstemcilerin yerel veritabanında bir ClientInfo veya karma listelerinin durumlarını belirtmesi gerekmez. Bu, gizliliği artırmak içindir. Ayrıca, istemcilerin ilgilendikleri tehdit türlerini göndermesi gerekmez.

Alanlar
hash_prefixes[]

bytes

Zorunlu. Aranacak karma değer ön ekleri. Müşteriler 1.000'den fazla karma ön ek göndermemelidir. Ancak URL işleme prosedürü sonrasında istemcilerin 30'dan fazla karma ön ek göndermesi GEREKMEZ.

Şu anda her karma ön ekinin tam olarak 4 bayt uzunluğunda olması gerekir. Bu durum gelecekte GEVŞETİRİLEBİLİR.
filter

string

İsteğe bağlı. Müşteri yalnızca belirli türde tehditleri almak gibi filtreleme yapmak istiyorsa bu belirtilebilir. Atlanırsa eşleşen tüm tehditler döndürülür. Güvenli Tarama'nın sunabileceği en kapsamlı korumayı almak için bu seçeneği atlamanızı önemle tavsiye ederiz.

Filtre, Google Common Expression Language kullanılarak belirtilir. Bu dil, genel örneklerle birlikte https://github.com/google/cel-spec adresinde bulunabilir. Burada kullanılabilecek bazı örnekleri aşağıda bulabilirsiniz:

"threat_type == ThreatType.SOCIAL_ENGINEERING" filtresi, FullHashDetail içinde tehdit türünün SOCIAL_ENGINEERING olması gerektiğini belirtir. "threat_type" tanımlayıcı, mevcut tehdit türünü ifade eder. "ThreatType" tanımlayıcısı, tüm olası tehdit türlerinin koleksiyonunu ifade eder.

"threat_type in [ ThreatType.UNWANTED_SOFTWARE, ThreatType.MALWARE ]" filtresi, tehdit türünün UNWANTED_SOFTWARE veya MALWARE olması gerektiğini belirtir.

SearchHashesResponse

Tehdit karmaları arandıktan sonra döndürülen yanıt.

Hiçbir şey bulunamazsa sunucu, NOT_FOUND durumu (HTTP durum kodu 404) yerine full_hashes alanının boş olduğu bir OK durumu (HTTP durum kodu 200) döndürür.

V5'teki yenilikler: FullHash ile FullHashDetail arasında bir ayırma çizgisi vardır. Bir karma değerin birden fazla tehdit içeren bir siteyi temsil ettiği durumlarda (ör. hem MALWARE hem de SOCIAL_ENGINEERING), V4'te olduğu gibi karma değerin tamamının iki kez gönderilmesi gerekmez. Ayrıca, önbellek süresi tek bir cache_duration alanına basitleştirildi.

Alanlar
full_hashes[]

FullHash

Sırasız liste. Bulunan tam karmaların sırasız listesi.
cache_duration

Duration

İstemci tarafı önbelleği süresi. İstemci, geçerli süreyi belirlemek için bu süreyi mevcut süreye eklemelidir. Süre sonu, yanıtta kaç tane tam karma değerin döndürüldüğüne bakılmaksızın istemcide istekte bulunan her karma ön ekinde geçerli olur. Sunucu belirli bir karma ön ekiyle ilgili tam karma değeri döndürmezse bu durum istemci tarafından da önbelleğe ALINMALIDIR.

Yalnızca full_hashes alanı boşsa istemci, sunucu tarafından belirtilenden daha geç bir son kullanma tarihi belirlemek için cache_duration değerini artırabilir. Her durumda, artırılan önbellek süresi 24 saatten uzun olmamalıdır.

Önemli: İstemci, sunucunun tüm yanıtlar için aynı önbellek süresini döndüreceğini VARSAYAMAZ. Sunucu, duruma bağlı olarak farklı yanıtlar için farklı önbelleğe alma süreleri SEÇEBİLİR.

SizeConstraints

Karma liste boyutlarıyla ilgili kısıtlamalar.

Alanlar
max_update_entries

int32

Giriş sayısı olarak maksimum boyut. Güncelleme bu değerden fazla giriş içermez ancak bu değerden daha az giriş içerebilir. Bu değer en az 1.024 olmalıdır. Atlanırsa veya sıfır olarak ayarlanırsa güncelleme boyutu sınırı ayarlanmaz.
max_database_entries

int32

İstemcinin, liste için yerel veritabanında olmasını istediği maksimum giriş sayısını ayarlar. (Sunucu, istemcinin bu sayıdan daha az giriş depolamasına NEDEN OLABİLİR.) Atlanırsa veya sıfır olarak ayarlanırsa veritabanı boyutu sınırı ayarlanmaz.

ThreatAttribute

Tehditlerin özellikleri. Bu özellikler belirli bir tehdide ek anlam katabilir ancak tehdit türünü etkilemez. Örneğin, bir özellik daha düşük güven belirtirken farklı bir özellik daha yüksek güven belirtebilir. Gelecekte daha fazla özellik eklenebilir.

Sıralamalar
THREAT_ATTRIBUTE_UNSPECIFIED Bilinmeyen özellik. Bu değer sunucu tarafından döndürülürse istemci, kapsayıcı FullHashDetail değerini tamamen yoksayar.
CANARY threat_type özelliğinin yaptırım için kullanılmaması gerektiğini belirtir.
FRAME_ONLY threat_type parametresinin yalnızca çerçevelerde yaptırım için kullanılacağını belirtir.

ThreatType

Tehdit türleri.

Sıralamalar
THREAT_TYPE_UNSPECIFIED Bilinmeyen tehdit türü. Bu değer sunucu tarafından döndürülürse istemci, kapsayıcı FullHashDetail değerini tamamen yoksayar.
MALWARE

Kötü amaçlı yazılım tehdidi türü. Kötü amaçlı yazılımlar bilgisayarlara, mobil cihazlara, çalıştırdıkları yazılımlara veya kullanıcılarına zarar vermek için özel olarak tasarlanmış her türlü yazılım veya mobil uygulamadır. Kötü amaçlı yazılımlar, zararlı davranışlar sergiler (örneğin, kullanıcının izni olmadan yazılım yükleme ve virüs gibi zararlı yazılımlar yükleme).

Daha fazla bilgiye buradan ulaşabilirsiniz.
SOCIAL_ENGINEERING

Sosyal mühendislik tehdit türü. Sosyal mühendislik sayfaları, izleyicilerin kafasını karıştırarak yalnızca söz konusu üçüncü tarafın gerçek temsilcisine güvenecekleri bir işlem yapmalarını sağlamak amacıyla üçüncü taraf adına hareket ettiğini yanlış beyan eder. Kimlik avı, izleyiciyi kandırarak giriş kimlik bilgileri gibi belirli bir bilgi sağlama işlemini gerçekleştirmeye zorlayan bir sosyal mühendislik türüdür.

Daha fazla bilgiye buradan ulaşabilirsiniz.
UNWANTED_SOFTWARE İstenmeyen yazılım tehdidi türü. İstenmeyen yazılım, Google'ın Yazılım İlkeleri'ne uymayan ancak kötü amaçlı yazılım olmayan tüm yazılımlardır.
POTENTIALLY_HARMFUL_APPLICATION Play Store için Google Play Protect tarafından kullanılan potansiyel zararlı uygulama tehdidi türü.