Api-Roll 53: 2017-08-21

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 685 matching lines @@
   }
 }
 
 /** Authentication information for the operation. */
 class AuthenticationInfo {
   /**
    * The authority selector specified by the requestor, if any.
    * It is not guaranteed that the principal was allowed to use this authority.
    */
   core.String authoritySelector;
-  /** The email address of the authenticated user making the request. */
+  /**
+   * The email address of the authenticated user making the request.
+   * For privacy reasons, the principal email address is redacted for all
+   * read-only operations that fail with a "permission denied" error.
+   */
   core.String principalEmail;
 
   AuthenticationInfo();
 
   AuthenticationInfo.fromJson(core.Map _json) {
     if (_json.containsKey("authoritySelector")) {
       authoritySelector = _json["authoritySelector"];
     }
     if (_json.containsKey("principalEmail")) {
       principalEmail = _json["principalEmail"];
@@ skipping 1258 matching lines @@
    * For QuotaGroup-based quota, this is QuotaGroup.name
    * For QuotaLimit-based quota, this is QuotaLimit.name
    * See: google.api.Quota
    * Deprecated: Use quota_metrics to get per quota group limit exceeded status.
    */
   core.List<core.String> limitExceeded;
   /**
    * Map of quota group name to the actual number of tokens consumed. If the
    * quota check was not successful, then this will not be populated due to no
    * quota consumption.
-   * Deprecated: Use quota_metrics to get per quota group usage.
+   *
+   * We are not merging this field with 'quota_metrics' field because of the
+   * complexity of scaling in Chemist client code base. For simplicity, we will
+   * keep this field for Castor (that scales quota usage) and 'quota_metrics'
+   * for SuperQuota (that doesn't scale quota usage).
    */
   core.Map<core.String, core.int> quotaConsumed;
   /**
    * Quota metrics to indicate the usage. Depending on the check request, one or
    * more of the following metrics will be included:
    *
    * 1. For rate quota, per quota group or per quota metric incremental usage
    * will be specified using the following delta metric:
    *   "serviceruntime.googleapis.com/api/consumer/quota_used_count"
    *
@@ skipping 53 matching lines @@
    * Fully qualified name of the API method for which this quota operation is
    * requested. This name is used for matching quota rules or metric rules and
    * billing status rules defined in service configuration. This field is not
    * required if the quota operation is performed on non-API resources.
    *
    * Example of an RPC method name:
    *     google.example.library.v1.LibraryService.CreateShelf
    */
   core.String methodName;
   /**
-   * Identity of the operation. This must be unique within the scope of the
-   * service that generated the operation. If the service calls AllocateQuota
-   * and ReleaseQuota on the same operation, the two calls should carry the
-   * same ID.
+   * Identity of the operation. This is expected to be unique within the scope
+   * of the service that generated the operation, and guarantees idempotency in
+   * case of retries.
    *
    * UUID version 4 is recommended, though not required. In scenarios where an
    * operation is computed from existing information and an idempotent id is
    * desirable for deduplication purpose, UUID version 5 is recommended. See
    * RFC 4122 for details.
    */
   core.String operationId;
   /**
    * Represents information about this operation. Each MetricValueSet
    * corresponds to a metric defined in the service configuration.
@@ skipping 653 matching lines @@
     }
     if (details != null) {
       _json["details"] = details;
     }
     if (message != null) {
       _json["message"] = message;
     }
     return _json;
   }
 }