Method: threatListUpdates.fetch

Ruft die neuesten Aktualisierungen der Bedrohungsliste ab. Ein Kunde kann Aktualisierungen für mehrere Listen gleichzeitig anfordern.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "client": {
    object (ClientInfo)
  },
  "listUpdateRequests": [
    {
      object (ListUpdateRequest)
    }
  ]
}
Felder
client

object (ClientInfo)

Die Metadaten des Clients.
listUpdateRequests[]

object (ListUpdateRequest)

Die angeforderte Liste der Bedrohungen wird aktualisiert.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "listUpdateResponses": [
    {
      object (ListUpdateResponse)
    }
  ],
  "minimumWaitDuration": string
}
Felder
listUpdateResponses[]

object (ListUpdateResponse)

Die von den Clients angeforderten Listenaktualisierungen. Die Anzahl der Antworten hier kann geringer sein als die Anzahl der Anfragen, die von Clients gesendet werden. Das ist beispielsweise der Fall, wenn der Server keine Aktualisierungen für eine bestimmte Liste hat.
minimumWaitDuration

string (Duration format)

Die Mindestdauer, die der Client warten muss, bevor er eine Aktualisierungsanfrage sendet. Wenn dieses Feld nicht festgelegt ist, können Clients schnellstmöglich aktualisiert werden.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".

ListUpdateRequest

Eine einzelne Anfrage zur Listenaktualisierung.

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

enum (ThreatType)

Die Art der Bedrohung durch Einträge in der Liste.
platformType

enum (PlatformType)

Der Plattformtyp, für den ein Risiko nach Einträgen in der Liste besteht.
threatEntryType

enum (ThreatEntryType)

Die in der Liste vorhandenen Eintragstypen.
state

string (bytes format)

Der aktuelle Status des Clients für die angeforderte Liste. Dies ist der verschlüsselte Clientstatus, der nach der letzten erfolgreichen Listenaktualisierung empfangen wurde.

Ein base64-codierter String.
constraints

object (Constraints)

Die mit dieser Anfrage verknüpften Einschränkungen.

Einschränkungen

Die Einschränkungen für dieses Update.

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

integer

Die maximale Größe der Anzahl von Einträgen. Die Aktualisierung enthält nicht mehr Einträge als diesen Wert. Der Wert sollte eine Potenz von 2 zwischen 2**10 und 2**20 sein. Wenn null, wird keine Größenbeschränkung für die Aktualisierung festgelegt.
maxDatabaseEntries

integer

Legt die maximale Anzahl von Einträgen fest, die der Client für die angegebene Liste in der lokalen Datenbank aufnehmen möchte. Der Wert sollte eine Potenz von 2 zwischen 2**10 und 2**20 sein. Wenn null, ist keine Größenbeschränkung für die Datenbank festgelegt.
region

string

Fordert die Liste für einen bestimmten geografischen Standort an. Wenn die Richtlinie nicht konfiguriert ist, kann der Server diesen Wert anhand der IP-Adresse des Nutzers auswählen. Erfordert ISO 3166-1 alpha-2-Format.
supportedCompressions[]

enum (CompressionType)

Die vom Client unterstützten Komprimierungstypen.
language

string

Fordert die Listen für eine bestimmte Sprache an. Erwartet das ISO 639-Alpha-2-Format.
deviceLocation

string

Der physische Standort eines Clients, ausgedrückt als Regionscode nach ISO 31166-1 alpha-2.

CompressionType

Methoden, mit denen Bedrohungseintragssätze komprimiert werden können.

Enums
COMPRESSION_TYPE_UNSPECIFIED Unbekannt.
RAW Unkomprimierte Rohdaten.
RICE Mit Rice-Golomb codierte Daten.

ListUpdateResponse

Die Aktualisierung einer einzelnen Liste.

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

enum (ThreatType)

Der Bedrohungstyp, für den Daten zurückgegeben werden.
threatEntryType

enum (ThreatEntryType)

Das Format der Bedrohungen.
platformType

enum (PlatformType)

Der Plattformtyp, für den Daten zurückgegeben werden.
responseType

enum (ResponseType)

Der Typ der Antwort. Dies kann darauf hinweisen, dass der Client eine Aktion erfordert, wenn die Antwort eingeht.
additions[]

object (ThreatEntrySet)

Eine Reihe von Einträgen, die der Liste eines lokalen Bedrohungstyps hinzugefügt werden sollen. Wird wiederholt, damit eine Kombination aus komprimierten und Rohdaten in einer einzigen Antwort gesendet werden kann.
removals[]

object (ThreatEntrySet)

Eine Reihe von Einträgen, die aus der Liste eines lokalen Bedrohungstyps entfernt werden sollen. In der Praxis ist dieses Feld leer oder enthält genau ein ThreatEntrySet.
newClientState

string (bytes format)

Der neue Clientstatus im verschlüsselten Format. Für Kunden intransparent.

Ein base64-codierter String.
checksum

object (Checksum)

Der erwartete SHA256-Hash des Clientstatus, d. h. der sortierten Liste aller Hashes, die nach dem bereitgestellten Update in der Datenbank vorhanden sind. Wenn der Clientstatus nicht mit dem erwarteten Status übereinstimmt, muss der Client diese Aktualisierung ignorieren und es später noch einmal versuchen.

ResponseType

Der an den Client gesendete Antworttyp.

Enums
RESPONSE_TYPE_UNSPECIFIED Unbekannt.
PARTIAL_UPDATE Teilweise Aktualisierungen werden auf die vorhandene lokale Datenbank des Clients angewendet.
FULL_UPDATE Vollständige Updates ersetzen die gesamte lokale Datenbank des Clients. Das bedeutet, dass der Kunde entweder stark veraltet war oder vermutet wird, dass er korrupt war.

ThreatEntrySet

Eine Reihe von Bedrohungen, die der lokalen Datenbank eines Clients hinzugefügt oder daraus entfernt werden sollten.

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

enum (CompressionType)

Der Komprimierungstyp für die Einträge in diesem Satz.
rawHashes

object (RawHashes)

Die Roheinträge im SHA256-Format.
rawIndices

object (RawIndices)

Die Indizes der Rohentfernung für eine lokale Liste.
riceHashes

object (RiceDeltaEncoding)

Die codierten 4-Byte-Präfixe von SHA-256-formatierten Einträgen mit Golomb-Rice-Codierung. Die Hashes werden in uint32 konvertiert, in aufsteigender Reihenfolge sortiert, dann deltacodiert und als EncryptData gespeichert.
riceIndices

object (RiceDeltaEncoding)

Die codierten lokalen, lexikografisch sortierten Listenindexe unter Verwendung einer Golomb-Rice-Codierung. Wird zum Senden komprimierter Entfernungsindexe verwendet. Die Entfernungsindexe (uint32) werden in aufsteigender Reihenfolge sortiert, dann deltacodiert und als EncryptData gespeichert.

RawHashes

Die unkomprimierten Bedrohungseinträge im Hash-Format mit einer bestimmten Präfixlänge. Hashes können zwischen 4 und 32 Byte groß sein. Die meisten Hashes sind 4 Byte. Einige Hashes werden jedoch verlängert, wenn sie mit dem Hash einer beliebten URL kollidieren.

Wird zum Senden von ThreatEntrySet an Clients, die keine Komprimierung unterstützen, oder zum Senden von Nicht-Byte-Hashes an Clients mit Komprimierungsunterstützung verwendet.

JSON-Darstellung 
{
  "prefixSize": integer,
  "rawHashes": string
}
Felder
prefixSize

integer

Die Anzahl der Byte für jedes unten codierte Präfix. Der Wert in diesem Feld kann zwischen 4 (kürzestes Präfix) und 32 (vollständiger SHA256-Hash) liegen.
rawHashes

string (bytes format)

Die Hashes im Binärformat, die zu einem langen String verkettet sind. Hashes werden in lexikografischer Reihenfolge sortiert. Für Nutzer der JSON API sind Hashes base64-codiert.

Ein base64-codierter String.

RawIndices

Eine Reihe von Rohindexen, die aus einer lokalen Liste entfernt werden sollen

JSON-Darstellung 
{
  "indices": [
    integer
  ]
}
Felder
indices[]

integer

Indizes, die aus einer lexikografisch sortierten lokalen Liste entfernt werden sollen

RiceDeltaEncoding

Die Rice-Golomb-codierten Daten. Wird zum Senden komprimierter 4-Byte-Hashes oder komprimierter Entfernungsindexe verwendet.

JSON-Darstellung 
{
  "firstValue": string,
  "riceParameter": integer,
  "numEntries": integer,
  "encodedData": string
}
Felder
firstValue

string (int64 format)

Der Offset des ersten Eintrags in den codierten Daten oder, wenn nur eine einzelne Ganzzahl codiert wurde, der Wert dieser einzelnen Ganzzahl. Wenn das Feld leer ist oder fehlt, wird Null angenommen.
riceParameter

integer

Der Golomb-Rice-Parameter, bei dem es sich um eine Zahl zwischen 2 und 28 handelt. Dieses Feld fehlt (d. h. null), wenn numEntries null ist.
numEntries

integer

Die Anzahl der Einträge, die in den codierten Daten Deltacodiert sind. Wenn nur eine einzelne Ganzzahl codiert wurde, ist dies null und der einzelne Wert wird in firstValue gespeichert.
encodedData

string (bytes format)

Die codierten Deltas, die mit dem Golomb-Rice-Coder codiert werden.

Ein base64-codierter String.

Prüfsumme

Der erwartete Status der lokalen Datenbank eines Clients.

JSON-Darstellung 
{
  "sha256": string
}
Felder
sha256

string (bytes format)

SHA256-Hash des Clientstatus, also der sortierten Liste aller in der Datenbank vorhandenen Hashes.

Ein base64-codierter String.