Method: threatListUpdates.fetch

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

enum (ThreatType)

Jenis ancaman yang disebabkan oleh entri yang ada dalam daftar.

enum (PlatformType)

Jenis platform yang berisiko berdasarkan entri yang ada dalam daftar.

enum (ThreatEntryType)

Jenis entri yang ada dalam daftar.

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.

object (Constraints)

Batasan yang terkait dengan permintaan ini.

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

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.

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.

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.

enum (CompressionType)

Jenis kompresi yang didukung oleh klien.

string

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

string

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

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

enum (ThreatType)

Jenis ancaman yang datanya ditampilkan.

enum (ThreatEntryType)

Format ancaman.

enum (PlatformType)

Jenis platform yang datanya ditampilkan.

enum (ResponseType)

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

object (ThreatEntrySet)

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

object (ThreatEntrySet)

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

string (bytes format)

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

String berenkode base64.

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.

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

enum (CompressionType)

Jenis kompresi untuk entri dalam kumpulan ini.

object (RawHashes)

Entri mentah berformat SHA256.

object (RawIndices)

Indeks penghapusan mentah untuk daftar lokal.

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.

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.

{
  "prefixSize": integer,
  "rawHashes": string
}

integer

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

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.

{
  "indices": [
    integer
  ]
}

integer

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

{
  "firstValue": string,
  "riceParameter": integer,
  "numEntries": integer,
  "encodedData": string
}

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.

integer

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

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.

string (bytes format)

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

String berenkode base64.

{
  "sha256": string
}

string (bytes format)

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

String berenkode base64.