Api-roll 43: 2016-12-13

generated/googleapis/lib/servicecontrol/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.servicecontrol.v1;
 
 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;
@@ skipping 29 matching lines @@
 
   ServicesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Checks an operation with Google Service Control to decide whether
    * the given operation should proceed. It should be called before the
    * operation is executed.
    *
    * If feasible, the client should cache the check results and reuse them for
-   * up to 60s. In case of server errors, the client may rely on the cached
+   * 60 seconds. In case of server errors, the client can rely on the cached
    * results for longer time.
    *
+   * NOTE: the `CheckRequest` has the size limit of 1MB.
+   *
    * This method requires the `servicemanagement.services.check` permission
    * on the specified service. For more information, see
    * [Google Cloud IAM](https://cloud.google.com/iam).
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [serviceName] - The service name as specified in its service configuration.
    * For example,
@@ skipping 30 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new CheckResponse.fromJson(data));
   }
 
   /**
-   * Reports operations to Google Service Control. It should be called
-   * after the operation is completed.
+   * Reports operation results to Google Service Control, such as logs and
+   * metrics. It should be called after an operation is completed.
    *
-   * If feasible, the client should aggregate reporting data for up to 5s to
-   * reduce API traffic. Limiting aggregation to 5s is to reduce data loss
-   * during client crashes. Clients should carefully choose the aggregation
-   * window to avoid data loss risk more than 0.01% for business and
-   * compliance reasons.
+   * If feasible, the client should aggregate reporting data for up to 5
+   * seconds to reduce API traffic. Limiting aggregation to 5 seconds is to
+   * reduce data loss during client crashes. Clients should carefully choose
+   * the aggregation time window to avoid data loss risk more than 0.01%
+   * for business and compliance reasons.
+   *
+   * NOTE: the `ReportRequest` has the size limit of 1MB.
    *
    * This method requires the `servicemanagement.services.report` permission
    * on the specified service. For more information, see
    * [Google Cloud IAM](https://cloud.google.com/iam).
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [serviceName] - The service name as specified in its service configuration.
@@ skipping 1055 matching lines @@
     }
     if (details != null) {
       _json["details"] = details;
     }
     if (message != null) {
       _json["message"] = message;
     }
     return _json;
   }
 }