You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: discovery/safebrowsing-v5.json
+79-5Lines changed: 79 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -99,7 +99,7 @@
99
99
"hashList": {
100
100
"methods": {
101
101
"get": {
102
-
"description": "Get the latest contents of a hash list. A hash list may either by a threat list or a non-threat list such as the Global Cache. This is a standard Get method as defined by https://google.aip.dev/131 and the HTTP method is also GET.",
102
+
"description": "Gets the latest contents of a hash list. A hash list may either by a threat list or a non-threat list such as the Global Cache. This is a standard Get method as defined by https://google.aip.dev/131 and the HTTP method is also GET.",
103
103
"flatPath": "v5/hashList/{name}",
104
104
"httpMethod": "GET",
105
105
"id": "safebrowsing.hashList.get",
@@ -142,7 +142,7 @@
142
142
"hashLists": {
143
143
"methods": {
144
144
"batchGet": {
145
-
"description": "Get multiple hash lists at once. It is very common for a client to need to get multiple hash lists. Using this method is preferred over using the regular Get method multiple times. This is a standard batch Get method as defined by https://google.aip.dev/231 and the HTTP method is also GET.",
145
+
"description": "Gets multiple hash lists at once. It is very common for a client to need to get multiple hash lists. Using this method is preferred over using the regular Get method multiple times. This is a standard batch Get method as defined by https://google.aip.dev/231 and the HTTP method is also GET.",
146
146
"flatPath": "v5/hashLists:batchGet",
147
147
"httpMethod": "GET",
148
148
"id": "safebrowsing.hashLists.batchGet",
@@ -180,7 +180,7 @@
180
180
}
181
181
},
182
182
"list": {
183
-
"description": "List hash lists. In the V5 API, Google will never remove a hash list that has ever been returned by this method. This enables clients to skip using this method and simply hard-code all hash lists they need. This is a standard List method as defined by https://google.aip.dev/132 and the HTTP method is GET.",
183
+
"description": "Lists hash lists. In the V5 API, Google will never remove a hash list that has ever been returned by this method. This enables clients to skip using this method and simply hard-code all hash lists they need. This is a standard List method as defined by https://google.aip.dev/132 and the HTTP method is GET.",
184
184
"flatPath": "v5/hashLists",
185
185
"httpMethod": "GET",
186
186
"id": "safebrowsing.hashLists.list",
@@ -208,7 +208,7 @@
208
208
"hashes": {
209
209
"methods": {
210
210
"search": {
211
-
"description": "Search for full hashes matching the specified prefixes. This is a custom method as defined by https://google.aip.dev/136 (the custom method refers to this method having a custom name within Google's general API development nomenclature; it does not refer to using a custom HTTP method).",
211
+
"description": "Searches for full hashes matching the specified prefixes. This is a custom method as defined by https://google.aip.dev/136 (the custom method refers to this method having a custom name within Google's general API development nomenclature; it does not refer to using a custom HTTP method).",
212
212
"flatPath": "v5/hashes:search",
213
213
"httpMethod": "GET",
214
214
"id": "safebrowsing.hashes.search",
@@ -228,9 +228,32 @@
228
228
}
229
229
}
230
230
}
231
+
},
232
+
"urls": {
233
+
"methods": {
234
+
"search": {
235
+
"description": "Searches for URLs matching known threats. Each URL and it's host-suffix and path-prefix expressions (up to a limited depth) are checked. This means that the response may contain URLs that were not included in the request, but are expressions of the requested URLs.",
236
+
"flatPath": "v5/urls:search",
237
+
"httpMethod": "GET",
238
+
"id": "safebrowsing.urls.search",
239
+
"parameterOrder": [],
240
+
"parameters": {
241
+
"urls": {
242
+
"description": "Required. The URLs to be looked up. Clients MUST NOT send more than 50 URLs.",
"description": "The response returned after searching threats matching the specified URLs. If nothing is found, the server will return an OK status (HTTP status code 200) with the `threats` field empty, rather than returning a NOT_FOUND status (HTTP status code 404).",
"description": "The client-side cache duration. The client MUST add this duration to the current time to determine the expiration time. The expiration time then applies to every URL queried by the client in the request, regardless of how many URLs are returned in the response. Even if the server returns no matches for a particular URL, this fact MUST also be cached by the client. If and only if the field `threats` is empty, the client MAY increase the `cache_duration` to determine a new expiration that is later than that specified by the server. In any case, the increased cache duration must not be longer than 24 hours. Important: the client MUST NOT assume that the server will return the same cache duration for all responses. The server MAY choose different cache durations for different responses depending on the situation.",
628
+
"format": "google-duration",
629
+
"type": "string"
630
+
},
631
+
"threats": {
632
+
"description": "Unordered list. The unordered list of threat matches found. Each entry contains a URL and the threat types that were found matching that URL. The list size can be greater than the number of URLs in the request as the all expressions of the URL would've been considered.",
633
+
"items": {
634
+
"$ref": "GoogleSecuritySafebrowsingV5ThreatUrl"
635
+
},
636
+
"type": "array"
637
+
}
638
+
},
639
+
"type": "object"
640
+
},
641
+
"GoogleSecuritySafebrowsingV5ThreatUrl": {
642
+
"description": "A URL matching one or more threats.",
643
+
"id": "GoogleSecuritySafebrowsingV5ThreatUrl",
644
+
"properties": {
645
+
"threatTypes": {
646
+
"description": "Unordered list. The unordered list of threat that the URL is classified as.",
647
+
"items": {
648
+
"enum": [
649
+
"THREAT_TYPE_UNSPECIFIED",
650
+
"MALWARE",
651
+
"SOCIAL_ENGINEERING",
652
+
"UNWANTED_SOFTWARE",
653
+
"POTENTIALLY_HARMFUL_APPLICATION"
654
+
],
655
+
"enumDescriptions": [
656
+
"Unknown threat type. If this is returned by the server, the client shall disregard the enclosing `FullHashDetail` altogether.",
657
+
"Malware threat type. Malware is any software or mobile application specifically designed to harm a computer, a mobile device, the software it's running, or its users. Malware exhibits malicious behavior that can include installing software without user consent and installing harmful software such as viruses. More information can be found [here](https://developers.google.com/search/docs/monitor-debug/security/malware).",
658
+
"Social engineering threat type. Social engineering pages falsely purport to act on behalf of a third party with the intention of confusing viewers into performing an action with which the viewer would only trust a true agent of that third party. Phishing is a type of social engineering that tricks the viewer into performing the specific action of providing information, such as login credentials. More information can be found [here](https://developers.google.com/search/docs/monitor-debug/security/social-engineering).",
659
+
"Unwanted software threat type. Unwanted software is any software that does not adhere to [Google's Software Principles](https://www.google.com/about/software-principles.html) but isn't malware.",
660
+
"Potentially harmful application threat type [as used by Google Play Protect for the Play Store](https://developers.google.com/android/play-protect/potentially-harmful-applications)."
661
+
],
662
+
"type": "string"
663
+
},
664
+
"type": "array"
665
+
},
666
+
"url": {
667
+
"description": "The requested URL that was matched by one or more threats.",
* The response returned after searching threats matching the specified URLs. If nothing is found, the server will return an OK status (HTTP status code 200) with the `threats` field empty, rather than returning a NOT_FOUND status (HTTP status code 404).
* The client-side cache duration. The client MUST add this duration to the current time to determine the expiration time. The expiration time then applies to every URL queried by the client in the request, regardless of how many URLs are returned in the response. Even if the server returns no matches for a particular URL, this fact MUST also be cached by the client. If and only if the field `threats` is empty, the client MAY increase the `cache_duration` to determine a new expiration that is later than that specified by the server. In any case, the increased cache duration must not be longer than 24 hours. Important: the client MUST NOT assume that the server will return the same cache duration for all responses. The server MAY choose different cache durations for different responses depending on the situation.
370
+
*/
371
+
cacheDuration?: string|null;
372
+
/**
373
+
* Unordered list. The unordered list of threat matches found. Each entry contains a URL and the threat types that were found matching that URL. The list size can be greater than the number of URLs in the request as the all expressions of the URL would've been considered.
* Search for full hashes matching the specified prefixes. This is a custom method as defined by https://google.aip.dev/136 (the custom method refers to this method having a custom name within Google's general API development nomenclature; it does not refer to using a custom HTTP method).
398
+
* Searches for full hashes matching the specified prefixes. This is a custom method as defined by https://google.aip.dev/136 (the custom method refers to this method having a custom name within Google's general API development nomenclature; it does not refer to using a custom HTTP method).
* Get the latest contents of a hash list. A hash list may either by a threat list or a non-threat list such as the Global Cache. This is a standard Get method as defined by https://google.aip.dev/131 and the HTTP method is also GET.
556
+
* Gets the latest contents of a hash list. A hash list may either by a threat list or a non-threat list such as the Global Cache. This is a standard Get method as defined by https://google.aip.dev/131 and the HTTP method is also GET.
* Get multiple hash lists at once. It is very common for a client to need to get multiple hash lists. Using this method is preferred over using the regular Get method multiple times. This is a standard batch Get method as defined by https://google.aip.dev/231 and the HTTP method is also GET.
744
+
* Gets multiple hash lists at once. It is very common for a client to need to get multiple hash lists. Using this method is preferred over using the regular Get method multiple times. This is a standard batch Get method as defined by https://google.aip.dev/231 and the HTTP method is also GET.
* List hash lists. In the V5 API, Google will never remove a hash list that has ever been returned by this method. This enables clients to skip using this method and simply hard-code all hash lists they need. This is a standard List method as defined by https://google.aip.dev/132 and the HTTP method is GET.
897
+
* Lists hash lists. In the V5 API, Google will never remove a hash list that has ever been returned by this method. This enables clients to skip using this method and simply hard-code all hash lists they need. This is a standard List method as defined by https://google.aip.dev/132 and the HTTP method is GET.
* Searches for URLs matching known threats. Each URL and it's host-suffix and path-prefix expressions (up to a limited depth) are checked. This means that the response may contain URLs that were not included in the request, but are expressions of the requested URLs.
0 commit comments