Api-roll 37: 2016-06-06

discovery/googleapis/safebrowsing__v4.json

 {
     "basePath": "",
     "baseUrl": "https://safebrowsing.googleapis.com/",
     "batchPath": "batch",
     "description": "Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/safe-browsing/",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/sNqN0JiWP8e28tYjOdGK7QuKa18\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/Yoew02BLq1-_QyzwsVjtSdddocY\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "safebrowsing:v4",
     "kind": "discovery#restDescription",
     "name": "safebrowsing",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 132 matching lines @@
                     "httpMethod": "GET",
                     "id": "safebrowsing.threatLists.list",
                     "path": "v4/threatLists",
                     "response": {
                         "$ref": "ListThreatListsResponse"
                     }
                 }
             }
         }
     },
-    "revision": "20160428",
+    "revision": "20160520",
     "rootUrl": "https://safebrowsing.googleapis.com/",
     "schemas": {
         "FindThreatMatchesRequest": {
             "description": "Request to check entries against lists.",
             "id": "FindThreatMatchesRequest",
             "properties": {
                 "client": {
                     "$ref": "ClientInfo",
                     "description": "The client metadata."
                 },
@@ skipping 44 matching lines @@
                     },
                     "type": "array"
                 },
                 "platformTypes": {
                     "description": "The platform types to be checked.",
                     "enumDescriptions": [
                         "Unknown platform.",
                         "Threat posed to Windows.",
                         "Threat posed to Linux.",
                         "Threat posed to Android.",
-                        "Threat posed to OSX.",
+                        "Threat posed to OS X.",
                         "Threat posed to iOS.",
                         "Threat posed to at least one of the defined platforms.",
                         "Threat posed to all defined platforms.",
                         "Threat posed to Chrome."
                     ],
                     "items": {
                         "enum": [
                             "PLATFORM_TYPE_UNSPECIFIED",
                             "WINDOWS",
                             "LINUX",
                             "ANDROID",
                             "OSX",
                             "IOS",
                             "ANY_PLATFORM",
                             "ALL_PLATFORMS",
                             "CHROME"
                         ],
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "threatEntryTypes": {
                     "description": "The entry types to be checked.",
                     "enumDescriptions": [
                         "Unspecified.",
-                        "A host-suffix/path-prefix URL expression; for example, \"foo.bar.com/baz/\".",
-                        "The digest of a binary.",
+                        "A URL.",
+                        "An executable program.",
                         "An IP range."
                     ],
                     "items": {
                         "enum": [
                             "THREAT_ENTRY_TYPE_UNSPECIFIED",
-                            "URL_EXPRESSION",
-                            "BINARY_DIGEST",
+                            "URL",
+                            "EXECUTABLE",
                             "IP_RANGE"
                         ],
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "threatEntries": {
                     "description": "The threat entries to be checked.",
                     "items": {
                         "$ref": "ThreatEntry"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "ThreatEntry": {
             "description": "An individual threat; for example, a malicious URL or its hash representation. Only one of these fields should be set.",
             "id": "ThreatEntry",
             "properties": {
                 "hash": {
-                    "description": "A hash prefix, consisting of the most significant 4-32 bytes of a SHA256 hash.",
+                    "description": "A hash prefix, consisting of the most significant 4-32 bytes of a SHA256 hash. This field is in binary format.",
                     "format": "byte",
                     "type": "string"
                 },
                 "url": {
                     "description": "A URL.",
                     "type": "string"
+                },
+                "digest": {
+                    "description": "The digest of an executable in SHA256 format. The API supports both binary and hex digests.",
+                    "format": "byte",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "FindThreatMatchesResponse": {
-            "description": "Response type for requests to find threat matches.",
             "id": "FindThreatMatchesResponse",
             "properties": {
                 "matches": {
                     "description": "The threat list matches.",
                     "items": {
                         "$ref": "ThreatMatch"
                     },
                     "type": "array"
                 }
             },
@@ skipping 26 matching lines @@
                         "ANY_PLATFORM",
                         "ALL_PLATFORMS",
                         "CHROME"
                     ],
                     "type": "string"
                 },
                 "threatEntryType": {
                     "description": "The threat entry type matching this threat.",
                     "enum": [
                         "THREAT_ENTRY_TYPE_UNSPECIFIED",
-                        "URL_EXPRESSION",
-                        "BINARY_DIGEST",
+                        "URL",
+                        "EXECUTABLE",
                         "IP_RANGE"
                     ],
                     "type": "string"
                 },
                 "threat": {
                     "$ref": "ThreatEntry",
                     "description": "The threat matching this threat."
                 },
                 "threatEntryMetadata": {
                     "$ref": "ThreatEntryMetadata",
@@ skipping 82 matching lines @@
                         "ANY_PLATFORM",
                         "ALL_PLATFORMS",
                         "CHROME"
                     ],
                     "type": "string"
                 },
                 "threatEntryType": {
                     "description": "The types of entries present in the list.",
                     "enum": [
                         "THREAT_ENTRY_TYPE_UNSPECIFIED",
-                        "URL_EXPRESSION",
-                        "BINARY_DIGEST",
+                        "URL",
+                        "EXECUTABLE",
                         "IP_RANGE"
                     ],
                     "type": "string"
                 },
                 "state": {
-                    "description": "The current state of the client for the requested list (the encrypted ClientState that was sent to the client from the previous update request).",
+                    "description": "The current state of the client for the requested list (the encrypted client state that was received from the last successful list update).",
                     "format": "byte",
                     "type": "string"
                 },
                 "constraints": {
                     "$ref": "Constraints",
                     "description": "The constraints associated with this request."
                 }
             },
             "type": "object"
         },
@@ skipping 29 matching lines @@
                             "RICE"
                         ],
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "FetchThreatListUpdatesResponse": {
-            "description": "Response type for threat list update requests.",
             "id": "FetchThreatListUpdatesResponse",
             "properties": {
                 "listUpdateResponses": {
                     "description": "The list updates requested by the clients.",
                     "items": {
                         "$ref": "ListUpdateResponse"
                     },
                     "type": "array"
                 },
                 "minimumWaitDuration": {
@@ skipping 15 matching lines @@
                         "SOCIAL_ENGINEERING",
                         "UNWANTED_SOFTWARE",
                         "POTENTIALLY_HARMFUL_APPLICATION"
                     ],
                     "type": "string"
                 },
                 "threatEntryType": {
                     "description": "The format of the threats.",
                     "enum": [
                         "THREAT_ENTRY_TYPE_UNSPECIFIED",
-                        "URL_EXPRESSION",
-                        "BINARY_DIGEST",
+                        "URL",
+                        "EXECUTABLE",
                         "IP_RANGE"
                     ],
                     "type": "string"
                 },
                 "platformType": {
                     "description": "The platform type for which data is returned.",
                     "enum": [
                         "PLATFORM_TYPE_UNSPECIFIED",
                         "WINDOWS",
                         "LINUX",
@@ skipping 108 matching lines @@
         "RiceDeltaEncoding": {
             "description": "The Rice-Golomb encoded data. Used for sending compressed 4-byte hashes or compressed removal indices.",
             "id": "RiceDeltaEncoding",
             "properties": {
                 "firstValue": {
                     "description": "The offset of the first entry in the encoded data, or, if only a single integer was encoded, that single integer's value.",
                     "format": "int64",
                     "type": "string"
                 },
                 "riceParameter": {
-                    "description": "The Golomb-Rice parameter which is a number between 2 and 28. This field is missing (that is, zero) if num_entries is zero.",
+                    "description": "The Golomb-Rice parameter, which is a number between 2 and 28. This field is missing (that is, zero) if `num_entries` is zero.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "numEntries": {
-                    "description": "The number of entries that are delta encoded in the encoded data. If only a single integer was encoded, this will be zero and the single value will be stored in first_value.",
+                    "description": "The number of entries that are delta encoded in the encoded data. If only a single integer was encoded, this will be zero and the single value will be stored in `first_value`.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "encodedData": {
                     "description": "The encoded deltas that are encoded using the Golomb-Rice coder.",
                     "format": "byte",
                     "type": "string"
                 }
             },
             "type": "object"
@@ skipping 27 matching lines @@
                     "type": "array"
                 },
                 "threatInfo": {
                     "$ref": "ThreatInfo",
                     "description": "The lists and hashes to be checked."
                 }
             },
             "type": "object"
         },
         "FindFullHashesResponse": {
-            "description": "Response type for requests to find full hashes.",
             "id": "FindFullHashesResponse",
             "properties": {
                 "matches": {
                     "description": "The full hashes that matched the requested prefixes.",
                     "items": {
                         "$ref": "ThreatMatch"
                     },
                     "type": "array"
                 },
                 "minimumWaitDuration": {
                     "description": "The minimum duration the client must wait before issuing any find hashes request. If this field is not set, clients can issue a request as soon as they want.",
                     "type": "string"
                 },
                 "negativeCacheDuration": {
                     "description": "For requested entities that did not match the threat list, how long to cache the response.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ListThreatListsResponse": {
-            "description": "A collection of lists available for download by the client.",
             "id": "ListThreatListsResponse",
             "properties": {
                 "threatLists": {
                     "description": "The lists available for download by the client.",
                     "items": {
                         "$ref": "ThreatListDescriptor"
                     },
                     "type": "array"
                 }
             },
@@ skipping 26 matching lines @@
                         "ANY_PLATFORM",
                         "ALL_PLATFORMS",
                         "CHROME"
                     ],
                     "type": "string"
                 },
                 "threatEntryType": {
                     "description": "The entry types contained in the list.",
                     "enum": [
                         "THREAT_ENTRY_TYPE_UNSPECIFIED",
-                        "URL_EXPRESSION",
-                        "BINARY_DIGEST",
+                        "URL",
+                        "EXECUTABLE",
                         "IP_RANGE"
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Safe Browsing APIs",
     "version": "v4"
 }