Api-Roll 53: 2017-08-21

generated/googleapis/lib/safebrowsing/v4.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.safebrowsing.v4;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
 
 export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
     ApiRequestError, DetailedApiRequestError;
 
 const core.String USER_AGENT = 'dart-api-client safebrowsing/v4';
 
 /**
- * The Safe Browsing API is an experimental API that allows client applications
- * to check URLs against Google's constantly-updated blacklists of suspected
- * phishing and malware pages. Your client application can use the API to
- * download an encrypted table for local, client-side lookups of URLs.
+ * Enables client applications to check web resources (most commonly URLs)
+ * against Google-generated lists of unsafe web resources.
  */
 class SafebrowsingApi {
 
   final commons.ApiRequester _requester;
 
   EncodedFullHashesResourceApi get encodedFullHashes => new EncodedFullHashesResourceApi(_requester);
   EncodedUpdatesResourceApi get encodedUpdates => new EncodedUpdatesResourceApi(_requester);
   FullHashesResourceApi get fullHashes => new FullHashesResourceApi(_requester);
   ThreatListUpdatesResourceApi get threatListUpdates => new ThreatListUpdatesResourceApi(_requester);
   ThreatListsResourceApi get threatLists => new ThreatListsResourceApi(_requester);
   ThreatMatchesResourceApi get threatMatches => new ThreatMatchesResourceApi(_requester);
 
   SafebrowsingApi(http.Client client, {core.String rootUrl: "https://safebrowsing.googleapis.com/", core.String servicePath: ""}) :
       _requester = new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
 }
 
 
 class EncodedFullHashesResourceApi {
   final commons.ApiRequester _requester;
 
   EncodedFullHashesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Request parameters:
    *
    * [encodedRequest] - A serialized FindFullHashesRequest proto.
    *
-   * [clientVersion] - The version of the client implementation.
-   *
    * [clientId] - A client ID that (hopefully) uniquely identifies the client
    * implementation
    * of the Safe Browsing API.
    *
+   * [clientVersion] - The version of the client implementation.
+   *
    * Completes with a [FindFullHashesResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<FindFullHashesResponse> get(core.String encodedRequest, {core.String clientVersion, core.String clientId}) {
+  async.Future<FindFullHashesResponse> get(core.String encodedRequest, {core.String clientId, core.String clientVersion}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (encodedRequest == null) {
       throw new core.ArgumentError("Parameter encodedRequest is required.");
     }
+    if (clientId != null) {
+      _queryParams["clientId"] = [clientId];
+    }
     if (clientVersion != null) {
       _queryParams["clientVersion"] = [clientVersion];
     }
-    if (clientId != null) {
-      _queryParams["clientId"] = [clientId];
-    }
 
     _url = 'v4/encodedFullHashes/' + commons.Escaper.ecapeVariable('$encodedRequest');
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new FindFullHashesResponse.fromJson(data));
   }
 
 }
 
 
 class EncodedUpdatesResourceApi {
   final commons.ApiRequester _requester;
 
   EncodedUpdatesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Request parameters:
    *
    * [encodedRequest] - A serialized FetchThreatListUpdatesRequest proto.
    *
-   * [clientVersion] - The version of the client implementation.
-   *
    * [clientId] - A client ID that uniquely identifies the client implementation
    * of the Safe
    * Browsing API.
    *
+   * [clientVersion] - The version of the client implementation.
+   *
    * Completes with a [FetchThreatListUpdatesResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<FetchThreatListUpdatesResponse> get(core.String encodedRequest, {core.String clientVersion, core.String clientId}) {
+  async.Future<FetchThreatListUpdatesResponse> get(core.String encodedRequest, {core.String clientId, core.String clientVersion}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (encodedRequest == null) {
       throw new core.ArgumentError("Parameter encodedRequest is required.");
     }
+    if (clientId != null) {
+      _queryParams["clientId"] = [clientId];
+    }
     if (clientVersion != null) {
       _queryParams["clientVersion"] = [clientVersion];
     }
-    if (clientId != null) {
-      _queryParams["clientId"] = [clientId];
-    }
 
     _url = 'v4/encodedUpdates/' + commons.Escaper.ecapeVariable('$encodedRequest');
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 591 matching lines @@
   core.String threatEntryType;
   /**
    * The type of threat posed by entries present in the list.
    * Possible string values are:
    * - "THREAT_TYPE_UNSPECIFIED" : Unknown.
    * - "MALWARE" : Malware threat type.
    * - "SOCIAL_ENGINEERING" : Social engineering threat type.
    * - "UNWANTED_SOFTWARE" : Unwanted software threat type.
    * - "POTENTIALLY_HARMFUL_APPLICATION" : Potentially harmful application
    * threat type.
+   * - "SOCIAL_ENGINEERING_INTERNAL" : Social engineering threat type for
+   * internal use.
+   * - "API_ABUSE" : API abuse threat type.
    * - "MALICIOUS_BINARY" : Malicious binary threat type.
+   * - "CSD_WHITELIST" : Client side detection whitelist threat type.
+   * - "CSD_DOWNLOAD_WHITELIST" : Client side download detection whitelist
+   * threat type.
+   * - "CLIENT_INCIDENT" : Client incident threat type.
+   * - "CLIENT_INCIDENT_WHITELIST" : Whitelist used when detecting client
+   * incident threats.
+   * This enum was never launched and should be re-used for the next list.
+   * - "APK_MALWARE_OFFLINE" : List used for offline APK checks in PAM.
+   * - "SUBRESOURCE_FILTER" : Patterns to be used for activating the subresource
+   * filter. Interstitial
+   * will not be shown for patterns from this list.
    */
   core.String threatType;
 
   ListUpdateRequest();
 
   ListUpdateRequest.fromJson(core.Map _json) {
     if (_json.containsKey("constraints")) {
       constraints = new Constraints.fromJson(_json["constraints"]);
     }
     if (_json.containsKey("platformType")) {
@@ skipping 101 matching lines @@
   core.String threatEntryType;
   /**
    * The threat type for which data is returned.
    * Possible string values are:
    * - "THREAT_TYPE_UNSPECIFIED" : Unknown.
    * - "MALWARE" : Malware threat type.
    * - "SOCIAL_ENGINEERING" : Social engineering threat type.
    * - "UNWANTED_SOFTWARE" : Unwanted software threat type.
    * - "POTENTIALLY_HARMFUL_APPLICATION" : Potentially harmful application
    * threat type.
+   * - "SOCIAL_ENGINEERING_INTERNAL" : Social engineering threat type for
+   * internal use.
+   * - "API_ABUSE" : API abuse threat type.
    * - "MALICIOUS_BINARY" : Malicious binary threat type.
+   * - "CSD_WHITELIST" : Client side detection whitelist threat type.
+   * - "CSD_DOWNLOAD_WHITELIST" : Client side download detection whitelist
+   * threat type.
+   * - "CLIENT_INCIDENT" : Client incident threat type.
+   * - "CLIENT_INCIDENT_WHITELIST" : Whitelist used when detecting client
+   * incident threats.
+   * This enum was never launched and should be re-used for the next list.
+   * - "APK_MALWARE_OFFLINE" : List used for offline APK checks in PAM.
+   * - "SUBRESOURCE_FILTER" : Patterns to be used for activating the subresource
+   * filter. Interstitial
+   * will not be shown for patterns from this list.
    */
   core.String threatType;
 
   ListUpdateResponse();
 
   ListUpdateResponse.fromJson(core.Map _json) {
     if (_json.containsKey("additions")) {
       additions = _json["additions"].map((value) => new ThreatEntrySet.fromJson(value)).toList();
     }
     if (_json.containsKey("checksum")) {
@@ skipping 477 matching lines @@
   core.String threatEntryType;
   /**
    * The threat type posed by the list's entries.
    * Possible string values are:
    * - "THREAT_TYPE_UNSPECIFIED" : Unknown.
    * - "MALWARE" : Malware threat type.
    * - "SOCIAL_ENGINEERING" : Social engineering threat type.
    * - "UNWANTED_SOFTWARE" : Unwanted software threat type.
    * - "POTENTIALLY_HARMFUL_APPLICATION" : Potentially harmful application
    * threat type.
+   * - "SOCIAL_ENGINEERING_INTERNAL" : Social engineering threat type for
+   * internal use.
+   * - "API_ABUSE" : API abuse threat type.
    * - "MALICIOUS_BINARY" : Malicious binary threat type.
+   * - "CSD_WHITELIST" : Client side detection whitelist threat type.
+   * - "CSD_DOWNLOAD_WHITELIST" : Client side download detection whitelist
+   * threat type.
+   * - "CLIENT_INCIDENT" : Client incident threat type.
+   * - "CLIENT_INCIDENT_WHITELIST" : Whitelist used when detecting client
+   * incident threats.
+   * This enum was never launched and should be re-used for the next list.
+   * - "APK_MALWARE_OFFLINE" : List used for offline APK checks in PAM.
+   * - "SUBRESOURCE_FILTER" : Patterns to be used for activating the subresource
+   * filter. Interstitial
+   * will not be shown for patterns from this list.
    */
   core.String threatType;
 
   ThreatListDescriptor();
 
   ThreatListDescriptor.fromJson(core.Map _json) {
     if (_json.containsKey("platformType")) {
       platformType = _json["platformType"];
     }
     if (_json.containsKey("threatEntryType")) {
@@ skipping 58 matching lines @@
   core.String threatEntryType;
   /**
    * The threat type matching this threat.
    * Possible string values are:
    * - "THREAT_TYPE_UNSPECIFIED" : Unknown.
    * - "MALWARE" : Malware threat type.
    * - "SOCIAL_ENGINEERING" : Social engineering threat type.
    * - "UNWANTED_SOFTWARE" : Unwanted software threat type.
    * - "POTENTIALLY_HARMFUL_APPLICATION" : Potentially harmful application
    * threat type.
+   * - "SOCIAL_ENGINEERING_INTERNAL" : Social engineering threat type for
+   * internal use.
+   * - "API_ABUSE" : API abuse threat type.
    * - "MALICIOUS_BINARY" : Malicious binary threat type.
+   * - "CSD_WHITELIST" : Client side detection whitelist threat type.
+   * - "CSD_DOWNLOAD_WHITELIST" : Client side download detection whitelist
+   * threat type.
+   * - "CLIENT_INCIDENT" : Client incident threat type.
+   * - "CLIENT_INCIDENT_WHITELIST" : Whitelist used when detecting client
+   * incident threats.
+   * This enum was never launched and should be re-used for the next list.
+   * - "APK_MALWARE_OFFLINE" : List used for offline APK checks in PAM.
+   * - "SUBRESOURCE_FILTER" : Patterns to be used for activating the subresource
+   * filter. Interstitial
+   * will not be shown for patterns from this list.
    */
   core.String threatType;
 
   ThreatMatch();
 
   ThreatMatch.fromJson(core.Map _json) {
     if (_json.containsKey("cacheDuration")) {
       cacheDuration = _json["cacheDuration"];
     }
     if (_json.containsKey("platformType")) {
@@ skipping 29 matching lines @@
     }
     if (threatEntryType != null) {
       _json["threatEntryType"] = threatEntryType;
     }
     if (threatType != null) {
       _json["threatType"] = threatType;
     }
     return _json;
   }
 }