REST Resource: hashList

Kaynak: HashList

Adıyla tanımlanan karmaların listesi.

JSON gösterimi 
{
  "name": string,
  "version": string,
  "partialUpdate": boolean,
  "compressedRemovals": {
    object (RiceDeltaEncoded32Bit)
  },
  "minimumWaitDuration": 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.

  // Union field checksum can be only one of the following:
  "sha256Checksum": string
  // End of list of possible types for union field checksum.
}
Alanlar
name

string

Karma oluşturma listesinin adı. Genel Önbelleğin aynı zamanda sadece bir karma listesi olduğunu ve burada belirtilebileceğini unutmayın.
version

string (bytes format)

Karma oluşturma listesi sürümü. İstemci bu baytları DEĞİŞTİRMEMELİDİR.

base64 kodlu bir dize.
partialUpdate

boolean

Doğru olduğunda bu, müşterinin halihazırda sahip olduğu özelliklere dayalı olarak ekleme ve kaldırma işlemlerini içeren kısmi bir farktır. "False" (yanlış) olduğunda bu, tam karma listesidir.

Yanlış değerine ayarlanırsa istemcinin bu karma listesi için yerel olarak depolanan sürümleri silmesi GEREKİR. Bu, istemcinin sahip olduğu sürümün gerçekten eski olduğu veya istemci verilerinin bozuk olduğuna inandığı anlamına gelir. compressedRemovals alanı boş olur.

Doğru olduğunda, müşterinin kaldırma ve ekleme işlemlerini uygulayarak artımlı bir güncelleme uygulaması GEREKİR.
compressedRemovals

object (RiceDeltaEncoded32Bit)

Kaldırma dizinlerinin Pirinç delta kodlamalı sürümü. Her karma listesi kesinlikle 2^32’den az giriş içerdiğinden, dizinler 32 bit tam sayılar olarak ele alınır ve kodlanır.
minimumWaitDuration

string (Duration format)

Müşteriler, karma listesini tekrar almak için en az bu süre beklemelidir. Atlanırsa veya sıfırsa istemciler, sunucunun istemciye gönderilecek ek bir güncellemeye sahip olduğunu ancak istemcinin belirlediği kısıtlamalar nedeniyle yapamadığını belirttiği için hemen getirmelidir.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
metadata

object (HashListMetadata)

Karma listeyle ilgili meta veriler. Bu alan, hashList.get yöntemi tarafından doldurulmaz ancak ListHashLists yöntemi tarafından doldurulur.
Birleştirme alanı compressed_additions. Eklemelerin Pirinç delta kodlamalı sürümü. Eklemelerin karma ön eki uzunlukları, listedeki tüm eklemeler genelinde tek tiptir. Bu, istemci tarafından gönderilen desired_hash_length veya istemci bu alanı atladıysa sunucu tarafından seçilen bir değerdir. compressed_additions şunlardan yalnızca 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.
Birleştirme alanı checksum. Bu, sağlanan güncelleme uygulandıktan sonra veritabanında bulunan tüm karmaların sıralı listesinin sağlaması için yapılan denetim toplamıdır. Bu bir "biri" alanını kullanarak birden fazla karma oluşturma algoritmasına izin verebilirsiniz. Ayrıca sunucu, istemcinin mevcut sağlama toplamını kullanması gerektiğini belirtmek için bu alanı atlayabilir (güncelleme sağlanmadıysa). checksum şunlardan yalnızca biri olabilir:
sha256Checksum

string (bytes format)

SHA256 ile tekrar karma oluşturma işlemi uygulanmış tüm karmaların sıralı listesi.

base64 kodlu bir dize.

RiceDeltaEncoded32Bit

Rice-Golomb olarak kodlanmış veriler. Karmalar veya kaldırma dizinleri için kullanılır. Buradaki her karmanın veya dizinin aynı uzunlukta olduğu ve bu uzunluğun tam olarak 32 bit olduğu garanti edilir.

Genel olarak, tüm girişleri sözlüksel olarak sıralarsak, yüksek düzeydeki bitlerin düşük mertebedeki bitler kadar sık değişmeme eğiliminde olduğunu görürüz. Bu, girişler arasındaki bitişik farkı da alırsak yüksek sıradan bitlerin sıfır olma olasılığının yüksek olduğu anlamına gelir. Bu, temel olarak belirli sayıda bit seçerek bu yüksek sıfır olasılığından yararlanır; bundan daha önemli olan tüm bitler muhtemelen sıfır olacaktır. Bu nedenle, tekli kodlamayı kullanırız. riceParameter alanına bakın.

Geçmişteki not: Rice-delta kodlaması ilk olarak bu API'nin V4'te kullanılmıştır. V5'te iki önemli iyileştirme yapılmıştır: İlk olarak, Rice-delta kodlaması artık 4 bayttan uzun karma ön ekleriyle kullanılabiliyor; ikinci olarak, kodlanmış veriler maliyetli bir sıralama adımını önlemek için artık büyük-endian olarak ele alınır.

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

integer (uint32 format)

Kodlanmış verilerdeki (karma işlemler veya dizinler) ilk giriş ya da yalnızca tek bir karma ön eki veya dizin kodlanmışsa ilgili girişin değeri. Alan boşsa giriş sıfır olur.
riceParameter

integer

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

integer

Kodlanmış verilerde delta olarak 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 depolanır.
encodedData

string (bytes format)

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

base64 kodlu bir dize.

RiceDeltaEncoded64Bit

RiceDeltaEncoded32Bit ile aynıdır, ancak 64 bitlik sayıları kodlar.

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

string

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

integer

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

integer

Kodlanmış verilerde delta olarak 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 depolanır.
encodedData

string (bytes format)

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

base64 kodlu bir dize.

RiceDeltaKodlanmış128Bit

RiceDeltaEncoded32Bit ile aynıdır, ancak 128 bitlik sayıları kodlar.

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

string

Kodlanmış verilerdeki (karma) ilk girişin üst 64 biti. Alan boşsa üst 64 bitin tamamı sıfır olur.
firstValueLo

string (uint64 format)

Kodlanmış verilerdeki (karma) ilk girişin alt 64 biti. Alan boşsa alttaki 64 bitin tamamı sıfır olur.
riceParameter

integer

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

integer

Kodlanmış verilerde delta olarak 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 depolanır.
encodedData

string (bytes format)

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

base64 kodlu bir dize.

RiceDeltaKodlanmış256Bit

RiceDeltaEncoded32Bit ile aynıdır, ancak 256 bitlik sayıları kodlar.

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

string

Kodlanmış verilerdeki (karma) ilk girişin ilk 64 biti. Alan boşsa ilk 64 bitin tamamı sıfır olur.
firstValueSecondPart

string (uint64 format)

Kodlanmış verilerdeki (karma) ilk girişin 65 ila 128. bitleri. Bu alan boşsa 65 ile 128. bitlerin tamamı sıfırdır.
firstValueThirdPart

string (uint64 format)

Kodlanmış verilerdeki (karma) ilk girişin 129 ila 192. bitleri. Bu alan boşsa 129 ile 192. bitlerin tamamı sıfırdır.
firstValueFourthPart

string (uint64 format)

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

integer

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

integer

Kodlanan verilerde delta olarak 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 depolanır.
encodedData

string (bytes format)

Golomb-Pirinci kodlayıcı 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)
  ],
  "mobileOptimized": boolean,
  "description": string,
  "supportedHashLengths": [
    enum (HashLength)
  ]
}
Alanlar
threatTypes[]

enum (ThreatType)

Sırasız liste. Boş değilse bu, karma listesinin bir tür tehdit listesi olduğunu belirtir ve bu karma listesindeki karmalarla veya karma önekleriyle ilişkili tehditlerin türünü sıralar. Giriş bir tehdit temsil etmiyorsa (ör. olası güvenli bir türü temsil ediyorsa) boş olabilir.
likelySafeTypes[]

enum (LikelySafeType)

Sırasız liste. Boş değilse bu değer, karma listesinin olası güvenli karmaların bir listesini temsil ettiğini belirtir ve bunların güvenli olma olasılığı yüksek olan karmaları sıralar. Bu alan, tehdit türü alanını birlikte hariç tutar.
mobileOptimized

boolean

Bu listenin mobil cihazlar (Android ve iOS) için optimize edilip edilmediğidir.
description

string

Bu liste hakkında kullanıcıların okuyabileceği bir açıklama. İngilizce dilinde yazılmıştır.
supportedHashLengths[]

enum (HashLength)

Bu karma listesi için desteklenen karma uzunlukları. Her karma listesi en az bir uzunluğu destekler. Bu nedenle bu alan boş bırakılamaz.

ThreatType

Tehdit türleri.

Sıralamalar
THREAT_TYPE_UNSPECIFIED Bilinmeyen tehdit türü. Bu sunucu tarafından döndürülürse istemci, içeren FullHashDetail ifadesini tamamen göz ardı eder.
MALWARE

Kötü amaçlı yazılım tehdit 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ı, yanıltıcı bir şekilde üçüncü bir taraf adına hareket ediyormuş gibi görünür ve görüntüleyen kişinin yalnızca söz konusu üçüncü tarafın gerçek aracısına güveneceği bir işlem yapması için izleyicinin kafasını karıştırabilir. Kimlik avı, izleyiciyi kandırarak giriş kimlik bilgileri gibi belirli bilgileri sağlama işlemini gerçekleştirmesi için kandırılan 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 uygun olmayan ancak kötü amaçlı yazılım olmayan yazılımlardır.
POTENTIALLY_HARMFUL_APPLICATION Google Play Protect tarafından Play Store için kullanıldığı şekliyle zararlı olabilecek uygulama tehdit türü.

LikelySafeType

Olası güvenli site türleri.

SearchHashesResponse öğesinin kasıtlı olarak LikelySafeType içermediğini unutmayın.

Sıralamalar
LIKELY_SAFE_TYPE_UNSPECIFIED Bilinmiyor.
GENERAL_BROWSING Bu site muhtemelen genel tarama için yeterince güvenlidir. Bu, genel önbellek olarak da bilinir.
CSD Bu site, büyük olasılıkla İstemci Tarafı Algılama modelleri veya şifre koruma denetimleri çalıştırmaya gerek kalmayacak kadar güvenli.
DOWNLOAD Bu site, büyük olasılıkla siteden yapılan indirmelerin kontrol edilmesini gerektirecek kadar güvenlidir.

HashLength

Bir karma listesindeki karmaların uzunluğu.

Sıralamalar
HASH_LENGTH_UNSPECIFIED Uzunluk belirtilmedi. Sunucu, istemciye verilen 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 izin vermelidir.
FOUR_BYTES Her karma, dört baytlık bir ön ektir.
EIGHT_BYTES Her karma, sekiz baytlık bir ön ektir.
SIXTEEN_BYTES Her karma, on altı baytlık bir ön ektir.
THIRTY_TWO_BYTES Her karma, otuz iki baytlık tam bir karmadır.

Yöntemler

get

 Karma oluşturma listesinin en son içeriklerini alın.