REST Resource: hashList

Kaynak: HashList

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

JSON gösterimi 
{
  "name": string,
  "version": string,
  "partialUpdate": boolean,
  "compressedRemovals": {
    object (RiceDeltaEncoded32Bit)
  },
  "minimumWaitDuration": string,
  "sha256Checksum": string,
  "metadata": {
    object (HashListMetadata)
  },

  // Union field compressed_additions can be only one of the following:
  "additionsFourBytes": {
    object (RiceDeltaEncoded32Bit)
  },
  "additionsEightBytes": {
    object (RiceDeltaEncoded64Bit)
  },
  "additionsSixteenBytes": {
    object (RiceDeltaEncoded128Bit)
  },
  "additionsThirtyTwoBytes": {
    object (RiceDeltaEncoded256Bit)
  }
  // End of list of possible types for union field compressed_additions.
}
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

string (bytes format)

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

Base64 kodlu bir dize.
partialUpdate

boolean

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. compressedRemovals alanı boş olur.

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

object (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.
minimumWaitDuration

string (Duration format)

İ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.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
sha256Checksum

string (bytes format)

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.

Base64 kodlu bir dize.
metadata

object (HashListMetadata)

Karma oluşturma listesi ile ilgili meta veriler. Bu, hashList.get 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:
additionsFourBytes

object (RiceDeltaEncoded32Bit)

4 baytlık eklemeler.
additionsEightBytes

object (RiceDeltaEncoded64Bit)

8 baytlık eklemeler.
additionsSixteenBytes

object (RiceDeltaEncoded128Bit)

16 baytlık eklemeler.
additionsThirtyTwoBytes

object (RiceDeltaEncoded256Bit)

32 baytlık eklemeler.

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. riceParameter 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.

JSON gösterimi 
{
  "firstValue": integer,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
Alanlar
firstValue

integer (uint32 format)

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.
riceParameter

integer

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

integer

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 firstValue içinde saklanır.
encodedData

string (bytes format)

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

Base64 kodlu bir dize.

RiceDeltaEncoded64Bit

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

JSON gösterimi 
{
  "firstValue": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
Alanlar
firstValue

string

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.
riceParameter

integer

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

integer

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 firstValue içinde saklanır.
encodedData

string (bytes format)

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

Base64 kodlu bir dize.

RiceDeltaEncoded128Bit

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

JSON gösterimi 
{
  "firstValueHi": string,
  "firstValueLo": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
Alanlar
firstValueHi

string

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.
firstValueLo

string (uint64 format)

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

integer

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

integer

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 firstValue içinde saklanır.
encodedData

string (bytes format)

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

Base64 kodlu bir dize.

RiceDeltaEncoded256Bit

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

JSON gösterimi 
{
  "firstValueFirstPart": string,
  "firstValueSecondPart": string,
  "firstValueThirdPart": string,
  "firstValueFourthPart": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
Alanlar
firstValueFirstPart

string

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.
firstValueSecondPart

string (uint64 format)

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

string (uint64 format)

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.
firstValueFourthPart

string (uint64 format)

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

integer

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

integer

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 firstValue içinde saklanır.
encodedData

string (bytes format)

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

Base64 kodlu bir dize.

HashListMetadata

Belirli bir karma listeyle ilgili meta veriler.

JSON gösterimi 
{
  "threatTypes": [
    enum (ThreatType)
  ],
  "likelySafeTypes": [
    enum (LikelySafeType)
  ],
  "description": string,
  "supportedHashLengths": [
    enum (HashLength)
  ],
  "hashLength": enum (HashLength)
}
Alanlar
threatTypes[]

enum (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.
likelySafeTypes[]

enum (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, threatTypes 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.
supportedHashLengths[]
(deprecated)

enum (HashLength)

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

enum (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.

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ü.

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.

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 (supportedHashLengths alanında), ancak istemcinin bu değeri sunucuya göndermesine izin verilir (desiredHashLength 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.

Yöntemler

get

 Bir karma listedeki en son içerikleri alın.