Method: threatListUpdates.fetch

Mengambil pembaruan daftar ancaman terbaru. Klien dapat meminta pembaruan untuk beberapa daftar sekaligus.

Permintaan HTTP

POST https://safebrowsing.googleapis.com/v4/threatListUpdates:fetch

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "client": {
    object (ClientInfo)
  },
  "listUpdateRequests": [
    {
      object (ListUpdateRequest)
    }
  ]
}
Kolom
client

object (ClientInfo)

Metadata klien.
listUpdateRequests[]

object (ListUpdateRequest)

Pembaruan daftar ancaman yang diminta.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "listUpdateResponses": [
    {
      object (ListUpdateResponse)
    }
  ],
  "minimumWaitDuration": string
}
Kolom
listUpdateResponses[]

object (ListUpdateResponse)

Pembaruan daftar yang diminta oleh klien. Jumlah respons di sini mungkin kurang dari jumlah permintaan yang dikirim oleh klien. Hal ini terjadi, misalnya, jika server tidak memiliki pembaruan untuk daftar tertentu.
minimumWaitDuration

string (Duration format)

Durasi minimum yang harus ditunggu klien sebelum mengeluarkan permintaan update apa pun. Jika kolom ini tidak ditetapkan, klien dapat melakukan update sesegera mungkin.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

ListUpdateRequest

Permintaan pembaruan daftar tunggal.

Representasi JSON 
{
  "threatType": enum (ThreatType),
  "platformType": enum (PlatformType),
  "threatEntryType": enum (ThreatEntryType),
  "state": string,
  "constraints": {
    object (Constraints)
  }
}
Kolom
threatType

enum (ThreatType)

Jenis ancaman yang disebabkan oleh entri yang ada dalam daftar.
platformType

enum (PlatformType)

Jenis platform yang berisiko berdasarkan entri yang ada dalam daftar.
threatEntryType

enum (ThreatEntryType)

Jenis entri yang ada dalam daftar.
state

string (bytes format)

Status klien saat ini untuk daftar yang diminta (status klien terenkripsi yang diterima dari pembaruan daftar terakhir yang berhasil).

String berenkode base64.
constraints

object (Constraints)

Batasan yang terkait dengan permintaan ini.

Batasan

Batasan untuk update ini.

Representasi JSON 
{
  "maxUpdateEntries": integer,
  "maxDatabaseEntries": integer,
  "region": string,
  "supportedCompressions": [
    enum (CompressionType)
  ],
  "language": string,
  "deviceLocation": string
}
Kolom
maxUpdateEntries

integer

Ukuran maksimum dalam jumlah entri. Update tidak akan berisi entri yang melebihi nilai ini. Ini harus berupa pangkat 2 antara 2**10 dan 2**20. Jika nol, tidak ada batas ukuran update yang ditetapkan.
maxDatabaseEntries

integer

Menetapkan jumlah entri maksimum yang ingin dimiliki klien dalam database lokal untuk daftar yang ditentukan. Ini harus berupa pangkat 2 antara 2**10 dan 2**20. Jika nol, tidak ada batas ukuran database yang ditetapkan.
region

string

Meminta daftar untuk lokasi geografis tertentu. Jika tidak disetel, server dapat memilih nilai tersebut berdasarkan alamat IP pengguna. Mengharapkan format ISO 3166-1 alpha-2.
supportedCompressions[]

enum (CompressionType)

Jenis kompresi yang didukung oleh klien.
language

string

Meminta daftar untuk bahasa tertentu. Format ISO 639 alpha-2 diharapkan.
deviceLocation

string

Lokasi fisik klien, dinyatakan sebagai kode wilayah ISO 31166-1 alpha-2.

CompressionType

Cara kumpulan entri ancaman dapat dikompresi.

Enum
COMPRESSION_TYPE_UNSPECIFIED Tidak diketahui.
RAW Data mentah dan tidak terkompresi.
RICE Data yang dienkode Rice-Golomb.

ListUpdateResponse

Pembaruan pada daftar individual.

Representasi JSON 
{
  "threatType": enum (ThreatType),
  "threatEntryType": enum (ThreatEntryType),
  "platformType": enum (PlatformType),
  "responseType": enum (ResponseType),
  "additions": [
    {
      object (ThreatEntrySet)
    }
  ],
  "removals": [
    {
      object (ThreatEntrySet)
    }
  ],
  "newClientState": string,
  "checksum": {
    object (Checksum)
  }
}
Kolom
threatType

enum (ThreatType)

Jenis ancaman yang datanya ditampilkan.
threatEntryType

enum (ThreatEntryType)

Format ancaman.
platformType

enum (PlatformType)

Jenis platform yang datanya ditampilkan.
responseType

enum (ResponseType)

Jenis respons. Hal ini menunjukkan bahwa klien memerlukan tindakan saat respons telah diterima.
additions[]

object (ThreatEntrySet)

Kumpulan entri untuk ditambahkan ke daftar jenis ancaman lokal. Berulang untuk memungkinkan kombinasi data yang dikompresi dan mentah dikirim dalam satu respons.
removals[]

object (ThreatEntrySet)

Kumpulan entri yang akan dihapus dari daftar jenis ancaman lokal. Dalam praktiknya, kolom ini kosong atau berisi hanya satu ThreatEntrySet.
newClientState

string (bytes format)

Status klien baru, dalam format terenkripsi. Transparan untuk klien.

String berenkode base64.
checksum

object (Checksum)

Hash SHA256 yang diharapkan dari status klien; yaitu, daftar yang diurutkan dari semua hash yang ada di database setelah menerapkan update yang diberikan. Jika status klien tidak sesuai dengan status yang diharapkan, klien harus mengabaikan update ini dan mencobanya lagi nanti.

ResponseType

Jenis respons yang dikirim ke klien.

Enum
RESPONSE_TYPE_UNSPECIFIED Tidak diketahui.
PARTIAL_UPDATE Update parsial diterapkan ke database lokal klien yang ada.
FULL_UPDATE Update penuh menggantikan seluruh database lokal klien. Ini berarti bahwa klien benar-benar sudah ketinggalan zaman atau klien diyakini korup.

ThreatEntrySet

Serangkaian ancaman yang harus ditambahkan atau dihapus dari database lokal klien.

Representasi JSON 
{
  "compressionType": enum (CompressionType),
  "rawHashes": {
    object (RawHashes)
  },
  "rawIndices": {
    object (RawIndices)
  },
  "riceHashes": {
    object (RiceDeltaEncoding)
  },
  "riceIndices": {
    object (RiceDeltaEncoding)
  }
}
Kolom
compressionType

enum (CompressionType)

Jenis kompresi untuk entri dalam kumpulan ini.
rawHashes

object (RawHashes)

Entri mentah berformat SHA256.
rawIndices

object (RawIndices)

Indeks penghapusan mentah untuk daftar lokal.
riceHashes

object (RiceDeltaEncoding)

Awalan 4 byte yang dienkode dari entri berformat SHA256, menggunakan encoding Golomb-Rice. Hash dikonversi menjadi uint32, diurutkan dalam urutan menaik, kemudian dienkode delta dan disimpan sebagai encodingData.
riceIndices

object (RiceDeltaEncoding)

Indeks daftar lokal yang dienkode dan diurutkan secara leksikografis, menggunakan encoding Golomb-Rice. Digunakan untuk mengirim indeks penghapusan terkompresi. Indeks penghapusan (uint32) diurutkan dalam urutan menaik, kemudian dienkode delta dan disimpan sebagai encodingData.

RawHashes

Entri ancaman yang tidak dikompresi dalam format hash dengan panjang awalan tertentu. {i>Hash <i}dapat berukuran 4 hingga 32 byte. Sebagian besar panjangnya adalah 4 byte, namun beberapa hash akan diperpanjang jika bertabrakan dengan hash URL populer.

Digunakan untuk mengirim ThreatEntrySet ke klien yang tidak mendukung kompresi, atau saat mengirim hash non-4 byte ke klien yang mendukung kompresi.

Representasi JSON 
{
  "prefixSize": integer,
  "rawHashes": string
}
Kolom
prefixSize

integer

Jumlah byte untuk setiap awalan yang dienkode di bawah. Kolom ini dapat berupa 4 (awalan terpendek) hingga 32 (hash SHA256 lengkap).
rawHashes

string (bytes format)

Hash, dalam format biner, digabungkan menjadi satu string panjang. {i>Hash<i} diurutkan dalam urutan leksikografis. Untuk pengguna JSON API, hash berenkode base64.

String berenkode base64.

RawIndices

Sekumpulan indeks mentah yang akan dihapus dari daftar lokal.

Representasi JSON 
{
  "indices": [
    integer
  ]
}
Kolom
indices[]

integer

Indeks yang akan dihapus dari daftar lokal yang diurutkan secara leksikografis.

RiceDeltaEncoding

Data yang dienkode Rice-Golomb. Digunakan untuk mengirim hash 4 byte yang dikompresi atau indeks penghapusan yang dikompresi.

Representasi JSON 
{
  "firstValue": string,
  "riceParameter": integer,
  "numEntries": integer,
  "encodedData": string
}
Kolom
firstValue

string (int64 format)

Offset entri pertama dalam data yang dienkode, atau, jika hanya satu bilangan bulat yang dienkode, nilai bilangan bulat tunggal tersebut. Jika kolom kosong atau tidak ada, anggap nol.
riceParameter

integer

Parameter Golomb-Rice, yang merupakan angka antara 2 dan 28. Kolom ini tidak ada (yaitu, nol) jika numEntries adalah nol.
numEntries

integer

Jumlah entri yang dienkode delta pada data yang dienkode. Jika hanya satu bilangan bulat yang dienkode, nilai ini akan menjadi nol dan nilai tunggal akan disimpan di firstValue.
encodedData

string (bytes format)

Delta yang dienkode yang dienkode menggunakan pembuat kode Golomb-Rice.

String berenkode base64.

Checksum

Status yang diharapkan dari database lokal klien.

Representasi JSON 
{
  "sha256": string
}
Kolom
sha256

string (bytes format)

Hash SHA256 status klien; yaitu, daftar yang diurutkan dari semua hash yang ada dalam database.

String berenkode base64.