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 listesinin adı. Genel Önbelleğin aynı zamanda yalnızca bir karma listesi olduğunu ve burada belirtilebileceğini unutmayın.
version

string (bytes format)

Karma listesinin sürümü. İstemci bu baytları DEĞİŞTİRMEMELİDİR.

Base64 kodlu bir dize.
partialUpdate

boolean

Doğru olduğunda bu, müşterinin hâlihazırda sahip olduklarına dayalı olarak ekleme ve kaldırma işlemleri içeren kısmi bir farktır. Yanlış değerine ayarlandığında bu, tam karma listesidir.

False (yanlış) değerine ayarlanırsa istemcinin, bu karma listesi için yerel olarak depolanan sürümleri silmesi ZORUNLUDUR. Bu, istemcinin sahip olduğu sürümün ciddi derecede eski olduğu veya istemci verilerinin bozuk olduğuna inanıldığı anlamına gelir. compressedRemovals alanı boş olacaktır.

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

object (RiceDeltaEncoded32Bit)

Kaldırma dizinlerinin Rice-delta olarak kodlanmış sürümü. Her karma listede kesinlikle 2^32'den az giriş bulunduğundan, dizinler 32 bitlik tam sayılar olarak ele alınır ve kodlanır.
minimumWaitDuration

string (Duration format)

İstemciler, karma listesini tekrar almak için en az bu kadar süre beklemelidir. Atlanırsa veya sıfırlanırsa istemcilerin hemen getirmesi GEREKİR. Çünkü bu durum, sunucunun istemciye gönderilecek ek bir güncellemesinin olduğunu, ancak istemcinin belirttiği kısıtlamalar nedeniyle yapamadığını belirtir.

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

object (HashListMetadata)

Karma listesiyle 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 Rice-delta olarak kodlanmış sürümü. Eklemelerin karma ön ek uzunlukları, listedeki tüm eklemeler genelinde eşittir. Bu değer, istemci tarafından gönderilen desired_hash_length veya istemci tarafından atlanmışsa 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ıdır. Bu, birden fazla karma oluşturma algoritmasına izin veren "oneof" alanıdır. Ayrıca sunucunun, istemcinin mevcut sağlama toplamını kullanması gerektiğini belirtmek için (güncelleme sağlanmamışsa) bu alanı çıkarması da mümkündür. checksum şunlardan yalnızca biri olabilir:
sha256Checksum

string (bytes format)

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

Base64 kodlu bir dize.

RiceDeltaKodlu 32Bit

Rice-Golomb kodlamalı veriler. Karma oluşturma işlemleri veya kaldırma dizinleri için kullanılır. Buradaki her karma veya dizin aynı uzunluğa sahip olur ve bu uzunluğun da tam olarak 32 bit olduğu garanti edilir.

Genel olarak, tüm girişleri sözlüksel olarak sıraladığımızda, yüksek düzeydeki bitlerin genellikle alt sıradaki bitler kadar sık değişmediğini görürüz. Bu, girişler arasındaki bitişik farkı da alırsak, yüksek düzeydeki bitlerin sıfır olma olasılığının yüksek olacağı anlamına gelir. Bu yöntem, temelde belirli bir bit sayısı seçerek bu yüksek sıfır olasılığından yararlanır; bundan daha önemli olan tüm bitler sıfır olacağından birli kodlama kullanırız. riceParameter alanına bakın.

Geçmişe yönelik 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, ilk olarak, Rice-delta kodlaması artık 4 bayttan uzun karma öneklerle kullanılabilmektedir; ikinci olarak, kodlanmış veriler artık maliyetli bir sıralama adımını önlemek için büyük uçlu olarak işlenmektedir.

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

integer (uint32 format)

Kodlanmış verilerdeki ilk giriş (karmalar veya dizinler) veya yalnızca tek bir karma öneki ya da dizin kodlanmışsa bu girişin değeridir. Alan boşsa giriş sıfır olur.
riceParameter

integer

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

integer

Kodlanmış verilerde delta olarak kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlanmışsa bu değer sıfır olur ve tek değer firstValue özelliğinde depolanır.
encodedData

string (bytes format)

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

Base64 kodlu bir dize.

RiceDeltaKodlu 64Bit

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 (karmalar) ilk giriş veya yalnızca tek bir karma öneki kodlanmışsa bu girişin değeridir. Alan boşsa giriş sıfır olur.
riceParameter

integer

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

integer

Kodlanmış verilerde delta olarak kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlanmışsa bu değer sıfır olur ve tek değer firstValue özelliğinde depolanır.
encodedData

string (bytes format)

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

Base64 kodlu bir dize.

RiceDeltaKodlu128Bit

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ırdır.
firstValueLo

string (uint64 format)

Kodlanmış verilerdeki (karma) ilk girişin düşük olan 64 biti. Alan boşsa alttaki 64 bitin tamamı sıfırdır.
riceParameter

integer

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

integer

Kodlanmış verilerde delta olarak kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlanmışsa bu değer sıfır olur ve tek değer firstValue özelliğinde depolanır.
encodedData

string (bytes format)

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

Base64 kodlu bir dize.

RiceDeltaKodlu 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ırdır.
firstValueSecondPart

string (uint64 format)

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

string (uint64 format)

Kodlanmış verilerdeki (karmalar) ilk girişin 129 ile 192. bitleri. Alan boşsa 129 ile 192. bitlerin tümü sıfır olur.
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 ile 254 dahil) olması garanti edilir.
entriesCount

integer

Kodlanmış verilerde delta olarak kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlanmışsa bu değer sıfır olur ve tek değer firstValue özelliğinde depolanır.
encodedData

string (bytes format)

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

Base64 kodlu bir dize.

HashListMetadata

Belirli bir karma listesiyle 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 karmalar veya karma öneklerle ilişkili tehditlerin türünü sıralar. Giriş bir tehdidi temsil etmiyorsa (yani güvenli olabilecek bir türü temsil ediyorsa) boş olabilir.
likelySafeTypes[]

enum (LikelySafeType)

Sırasız liste. Boş değilse karma listesi, olası güvenli karmaların listesini temsil eder ve bu liste, karmaların güvenli kabul edilmesi gereken yolları sıralar. Bu alan, ThreatTypes alanı ile karşılıklı olarak kullanılamaz.
mobileOptimized

boolean

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

string

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

enum (HashLength)

Bu karma listesi için desteklenen karma uzunlukları. Her karma listesi en az bir uzunluğu destekler. Dolayısıyla bu alan boş olmayacaktır.

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 öğesini tamamen dikkate almaz.
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ı, görüntüleyen kişilerin yalnızca üçüncü tarafın gerçek bir aracısına güveneceği bir eylemi gerçekleştirmek üzere izleyicileri yanıltmak amacıyla yanlış bir şekilde üçüncü bir taraf adına hareket ediyormuş gibi davranır. Kimlik avı, görüntüleyen kişiyi, giriş kimlik bilgileri gibi bilgileri sağlamak üzere belirli bir işlem yapması için kandıran bir sosyal mühendislik türüdür.

Daha fazla bilgiye buradan ulaşabilirsiniz.
UNWANTED_SOFTWARE İstenmeyen yazılım tehdit türü. İstenmeyen yazılım Google Yazılım İlkeleri'ne bağlı olmayan ancak kötü amaçlı olmayan her türlü yazılımdır.
POTENTIALLY_HARMFUL_APPLICATION Play Store için Google Play Protect tarafından kullanıldığı şekliyle potansiyel zararlı uygulama tehdit türü.

LikelySafeType

Güvenli olma olasılığı yüksek 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 büyük olasılıkla genel göz atma için yeterince güvenli. Bu önbellek, genel önbellek olarak da bilinir.
CSD Bu site, İstemci Tarafı Algılama modellerini veya şifre koruma kontrollerini çalıştırmaya gerek kalmayacak kadar güvenli olabilir.
DOWNLOAD Bu site, siteden yapılan indirmelerin kontrol edilmesine gerek olmayacak kadar güvenlidir.

HashLength

Bir karma listesindeki karmaların uzunluğu.

Sıralamalar
HASH_LENGTH_UNSPECIFIED Uzunluk belirtilmedi. Sunucu istemciye yanıtlarında bu değeri döndürmez (supportedHashLengths alanında) ancak istemcinin bu değeri sunucuya göndermesine izin verilir (desiredHashLength alanında). Böyle bir durumda sunucu otomatik olarak bir değer seçer. İstemciler sunucunun bir değer seçmesine izin vermelidir.
FOUR_BYTES Her bir karma, dört baytlık bir önektir.
EIGHT_BYTES Her bir karma, sekiz baytlık bir önektir.
SIXTEEN_BYTES Her bir karma değeri, on altı baytlık bir ön ektir.
THIRTY_TWO_BYTES Her bir karma değeri, otuz iki baytlık tam karmadır.

Yöntemler

get

 Karma listesinin en son içeriklerini alma.