REST Resource: hashList

{
  "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.
}

string

Nom de la liste de hachage. Notez que le cache global n'est qu'une simple liste de hachage, que vous pouvez consulter ici.

string (bytes format)

Version de la liste de hachage. Le client NE DOIT PAS manipuler ces octets.

Chaîne encodée en base64.

boolean

Lorsque la valeur est "true", il s'agit d'une différence partielle comprenant des ajouts et des suppressions basés sur les données déjà disponibles dans le client. Si la valeur est "false", il s'agit de la liste de hachage complète.

Lorsque la valeur est "false", le client DOIT supprimer toute version stockée localement pour cette liste de hachage. Cela signifie que soit la version détenue par le client est très obsolète, soit les données du client sont soupçonnées d'être corrompues. Le champ compressedRemovals sera vide.

Lorsque la valeur est "true", le client DOIT appliquer une mise à jour incrémentielle en appliquant des suppressions, puis des ajouts.

object (RiceDeltaEncoded32Bit)

Version des index d'extraction, encodée au format delta de riz. Étant donné que chaque liste de hachage comporte certainement moins de 2^32 entrées, les index sont traités comme des entiers 32 bits et encodés.

string (Duration format)

Les clients doivent attendre au moins ce temps pour obtenir à nouveau la liste de hachage. En cas d'omission ou de zéro, les clients DOIVENT récupérer immédiatement l'accès, car cela indique que le serveur a une mise à jour supplémentaire à envoyer au client, mais ce n'est pas possible en raison des contraintes spécifiées par le client.

Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par "s". Exemple: "3.5s".

object (HashListMetadata)

Métadonnées sur la liste de hachage. Il n'est pas renseigné par la méthode hashList.get, mais par la méthode ListHashLists.

object (RiceDeltaEncoded32Bit)

Ajouts de 4 octets.

object (RiceDeltaEncoded64Bit)

Ajouts de 8 octets.

object (RiceDeltaEncoded128Bit)

Ajouts de 16 octets.

object (RiceDeltaEncoded256Bit)

Ajouts de 32 octets.

string (bytes format)

Liste triée de tous les hachages, une nouvelle fois hachée avec SHA256.

Chaîne encodée en base64.

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

integer (uint32 format)

Première entrée des données encodées (hachages ou index) ou, si un seul préfixe de hachage ou index a été encodé, la valeur de cette entrée. Si le champ est vide, la valeur à saisir est zéro.

integer

Paramètre Golomb-Rice. La valeur de ce paramètre est comprise entre 3 et 30 inclus.

integer

Nombre d'entrées encodées en delta dans les données encodées. Si un seul entier a été encodé, la valeur est zéro et la valeur unique sera stockée dans firstValue.

string (bytes format)

Deltas encodés à l'aide du codeur Golomb-Rice

Chaîne encodée en base64.

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

string

La première entrée des données encodées (hachages) ou, si un seul préfixe de hachage a été encodé, la valeur de cette entrée. Si le champ est vide, la valeur à saisir est zéro.

integer

Paramètre Golomb-Rice. La valeur de ce paramètre est comprise entre 35 et 62 inclus.

integer

Nombre d'entrées encodées en delta dans les données encodées. Si un seul entier a été encodé, la valeur est zéro et la valeur unique sera stockée dans firstValue.

string (bytes format)

Deltas encodés à l'aide du codeur Golomb-Rice

Chaîne encodée en base64.

{
  "firstValueHi": string,
  "firstValueLo": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}

string

Les 64 bits supérieurs de la première entrée dans les données encodées (hachages). Si le champ est vide, les 64 bits supérieurs sont tous des zéros.

string (uint64 format)

Les 64 bits inférieurs de la première entrée dans les données encodées (hachages). Si le champ est vide, les 64 bits inférieurs sont tous des zéros.

integer

Paramètre Golomb-Rice. La valeur de ce paramètre est comprise entre 99 et 126 inclus.

integer

Nombre d'entrées encodées en delta dans les données encodées. Si un seul entier a été encodé, la valeur est zéro et la valeur unique sera stockée dans firstValue.

string (bytes format)

Deltas encodés à l'aide du codeur Golomb-Rice

Chaîne encodée en base64.

{
  "firstValueFirstPart": string,
  "firstValueSecondPart": string,
  "firstValueThirdPart": string,
  "firstValueFourthPart": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}

string

Les 64 premiers bits de la première entrée dans les données encodées (hachages). Si le champ est vide, les 64 premiers bits sont tous des zéros.

string (uint64 format)

Les 65 à 128 bits de la première entrée dans les données encodées (hachages). Si le champ est vide, les 65 à 128 bits sont tous des zéros.

string (uint64 format)

Les 129 à 192 bits de la première entrée dans les données encodées (hachages). Si le champ est vide, les 129 à 192 bits sont tous des zéros.

string (uint64 format)

Les 64 derniers bits de la première entrée dans les données encodées (hachages). Si le champ est vide, les 64 derniers bits sont tous des zéros.

integer

Paramètre Golomb-Rice. La valeur de ce paramètre est comprise entre 227 et 254, inclus.

integer

Nombre d'entrées encodées en delta dans les données encodées. Si un seul entier a été encodé, la valeur est zéro et la valeur unique sera stockée dans firstValue.

string (bytes format)

Deltas encodés à l'aide du codeur Golomb-Rice

Chaîne encodée en base64.

{
  "threatTypes": [
    enum (ThreatType)
  ],
  "likelySafeTypes": [
    enum (LikelySafeType)
  ],
  "mobileOptimized": boolean,
  "description": string,
  "supportedHashLengths": [
    enum (HashLength)
  ]
}

enum (ThreatType)

Liste à puces. Si ce champ n'est pas vide, cela indique que la liste de hachage est un type de liste de menaces, et énumère le type de menaces associé aux hachages ou préfixes de hachage de cette liste. Peut être vide si l'entrée ne représente pas une menace, c'est-à-dire si elle représente un type de sécurité vraisemblablement sans danger.

enum (LikelySafeType)

Liste à puces. Si ce champ n'est pas vide, cela indique que la liste de hachage représente une liste de hachages susceptibles d'être sûrs et énumère en quoi ils sont considérés comme probablement sûrs. Ce champ et le champ ThreatTypes s'excluent mutuellement.

boolean

Indique si cette liste est optimisée pour les appareils mobiles (Android et iOS).

string

Description lisible de cette liste. Rédigé en anglais.

enum (HashLength)

Longueurs de hachage acceptées pour cette liste de hachage. Chaque liste de hachage peut accepter au moins une longueur. Ce champ ne sera donc pas vide.