Api-roll 42: 2016-11-08

generated/googleapis/lib/servicemanagement/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.servicemanagement.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_1;
@@ skipping 39 matching lines @@
       _requester = client;
 
   /**
    * Gets the latest state of a long-running operation.  Clients can use this
    * method to poll the operation result at intervals as recommended by the API
    * service.
    *
    * Request parameters:
    *
    * [name] - The name of the operation resource.
-   * Value must have pattern "^operations/.*$".
+   * Value must have pattern "^operations/.+$".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http_1.Client] completes with an error when making a REST
    * call, this method will complete with the same error.
    */
   async.Future<Operation> get(core.String name) {
@@ skipping 262 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new GenerateConfigReportResponse.fromJson(data));
   }
 
   /**
-   * Gets a managed service.
+   * Gets a managed service. Authentication is required unless the service is
+   * public.
    *
    * Request parameters:
    *
    * [serviceName] - The name of the service.  See the `ServiceManager` overview
    * for naming
    * requirements.  For example: `example.googleapis.com`.
    *
    * Completes with a [ManagedService].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
@@ skipping 28 matching lines @@
 
   /**
    * Gets a service configuration (version) for a managed service.
    *
    * Request parameters:
    *
    * [serviceName] - The name of the service.  See the
    * [overview](/service-management/overview)
    * for naming requirements.  For example: `example.googleapis.com`.
    *
-   * [configId] - null
+   * [configId] - The id of the service configuration resource.
    *
    * Completes with a [Service].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http_1.Client] completes with an error when making a REST
    * call, this method will complete with the same error.
    */
   async.Future<Service> getConfig(core.String serviceName, {core.String configId}) {
@@ skipping 29 matching lines @@
    * set.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * requested.
    * `resource` is usually specified as a path. For example, a Project
    * resource is specified as `projects/{project}`.
-   * Value must have pattern "^services/[^/]*$".
+   * Value must have pattern "^services/[^/]+$".
    *
    * Completes with a [Policy].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http_1.Client] completes with an error when making a REST
    * call, this method will complete with the same error.
    */
   async.Future<Policy> getIamPolicy(GetIamPolicyRequest request, core.String resource) {
@@ skipping 17 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Policy.fromJson(data));
   }
 
   /**
-   * Lists all managed services.
+   * Lists all managed services. The result is limited to services that the
+   * caller has "servicemanagement.services.get" permission for. If the request
+   * is made without authentication, it returns only public services that are
+   * available to everyone.
    *
    * Request parameters:
    *
    * [pageSize] - Requested size of the next page of data.
    *
    * [producerProjectId] - Include services produced by the specified project.
    *
    * [pageToken] - Token identifying which result to start with; returned by a
    * previous list
    * call.
@@ skipping 41 matching lines @@
    * existing policy.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * specified.
    * `resource` is usually specified as a path. For example, a Project
    * resource is specified as `projects/{project}`.
-   * Value must have pattern "^services/[^/]*$".
+   * Value must have pattern "^services/[^/]+$".
    *
    * Completes with a [Policy].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http_1.Client] completes with an error when making a REST
    * call, this method will complete with the same error.
    */
   async.Future<Policy> setIamPolicy(SetIamPolicyRequest request, core.String resource) {
@@ skipping 27 matching lines @@
    * Returns permissions that a caller has on the specified resource.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
    * requested.
    * `resource` is usually specified as a path. For example, a Project
    * resource is specified as `projects/{project}`.
-   * Value must have pattern "^services/[^/]*$".
+   * Value must have pattern "^services/[^/]+$".
    *
    * Completes with a [TestIamPermissionsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http_1.Client] completes with an error when making a REST
    * call, this method will complete with the same error.
    */
   async.Future<TestIamPermissionsResponse> testIamPermissions(TestIamPermissionsRequest request, core.String resource) {
@@ skipping 129 matching lines @@
 
   /**
    * Gets a service configuration (version) for a managed service.
    *
    * Request parameters:
    *
    * [serviceName] - The name of the service.  See the
    * [overview](/service-management/overview)
    * for naming requirements.  For example: `example.googleapis.com`.
    *
-   * [configId] - null
+   * [configId] - The id of the service configuration resource.
    *
    * Completes with a [Service].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http_1.Client] completes with an error when making a REST
    * call, this method will complete with the same error.
    */
   async.Future<Service> get(core.String serviceName, core.String configId) {
@@ skipping 467 matching lines @@
   }
 }
 
 /**
  * Configuration for an anthentication provider, including support for
  * [JSON Web Token
  * (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
  */
 class AuthProvider {
   /**
+   * The list of JWT
+   * [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
+   * that are allowed to access. A JWT containing any of these audiences will
+   * be accepted. When this setting is absent, only JWTs with audience
+   * "https://Service_name/API_name"
+   * will be accepted. For example, if no audiences are in the setting,
+   * LibraryService API will only accept JWTs with the following audience
+   * "https://library-example.googleapis.com/google.example.library.v1.LibraryService".
+   *
+   * Example:
+   *
+   *     audiences: bookstore_android.apps.googleusercontent.com,
+   *                bookstore_web.apps.googleusercontent.com
+   */
+  core.String audiences;
+  /**
    * The unique identifier of the auth provider. It will be referred to by
    * `AuthRequirement.provider_id`.
    *
    * Example: "bookstore_auth".
    */
   core.String id;
   /**
    * Identifies the principal that issued the JWT. See
    * https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1
    * Usually a URL or an email address.
@@ skipping 14 matching lines @@
    * - can be inferred from the email domain of the issuer (e.g. a Google
    * service account).
    *
    * Example: https://www.googleapis.com/oauth2/v1/certs
    */
   core.String jwksUri;
 
   AuthProvider();
 
   AuthProvider.fromJson(core.Map _json) {
+    if (_json.containsKey("audiences")) {
+      audiences = _json["audiences"];
+    }
     if (_json.containsKey("id")) {
       id = _json["id"];
     }
     if (_json.containsKey("issuer")) {
       issuer = _json["issuer"];
     }
     if (_json.containsKey("jwksUri")) {
       jwksUri = _json["jwksUri"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
+    if (audiences != null) {
+      _json["audiences"] = audiences;
+    }
     if (id != null) {
       _json["id"] = id;
     }
     if (issuer != null) {
       _json["issuer"] = issuer;
     }
     if (jwksUri != null) {
       _json["jwksUri"] = jwksUri;
     }
     return _json;
   }
 }
 
 /**
  * User-defined authentication requirements, including support for
  * [JSON Web Token
  * (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
  */
 class AuthRequirement {
   /**
+   * NOTE: This will be deprecated soon, once AuthProvider.audiences is
+   * implemented and accepted in all the runtime components.
+   *
    * The list of JWT
    * [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
    * that are allowed to access. A JWT containing any of these audiences will
    * be accepted. When this setting is absent, only JWTs with audience
    * "https://Service_name/API_name"
    * will be accepted. For example, if no audiences are in the setting,
    * LibraryService API will only accept JWTs with the following audience
    * "https://library-example.googleapis.com/google.example.library.v1.LibraryService".
    *
    * Example:
@@ skipping 230 matching lines @@
    *
    * * `allUsers`: A special identifier that represents anyone who is
    *    on the internet; with or without a Google account.
    *
    * * `allAuthenticatedUsers`: A special identifier that represents anyone
    *    who is authenticated with a Google account or a service account.
    *
    * * `user:{emailid}`: An email address that represents a specific Google
    *    account. For example, `alice@gmail.com` or `joe@example.com`.
    *
+   *
    * * `serviceAccount:{emailid}`: An email address that represents a service
    *    account. For example, `my-other-app@appspot.gserviceaccount.com`.
    *
    * * `group:{emailid}`: An email address that represents a Google group.
    *    For example, `admins@example.com`.
    *
    * * `domain:{domain}`: A Google Apps domain name that represents all the
    *    users of that domain. For example, `google.com` or `example.com`.
    */
   core.List<core.String> members;
@@ skipping 73 matching lines @@
     return _json;
   }
 }
 
 /** A condition to be met. */
 class Condition {
   /**
    * Trusted attributes supplied by the IAM system.
    * Possible string values are:
    * - "NO_ATTR" : Default non-attribute.
-   * - "AUTHORITY" : Either principal or (if present) authority
-   * - "ATTRIBUTION" : selector
-   * Always the original principal, but making clear
+   * - "AUTHORITY" : Either principal or (if present) authority selector.
+   * - "ATTRIBUTION" : The principal (even if an authority selector is present),
+   * which
+   * must only be used for attribution, not authorization.
    */
   core.String iam;
   /**
    * An operator to apply the subject with.
    * Possible string values are:
    * - "NO_OP" : Default no-op.
    * - "EQUALS" : DEPRECATED. Use IN instead.
    * - "NOT_EQUALS" : DEPRECATED. Use NOT_IN instead.
    * - "IN" : Set-inclusion check.
    * - "NOT_IN" : Set-exclusion check.
@@ skipping 619 matching lines @@
   }
 }
 
 /** Request message for DisableService method. */
 class DisableServiceRequest {
   /**
    * The identity of consumer resource which service disablement will be
    * applied to.
    *
    * The Google Service Management implementation accepts the following
-   * forms: "project:<project_id>", "project_number:<project_number>".
+   * forms:
+   * - "project:<project_id>"
    *
    * Note: this is made compatible with
    * google.api.servicecontrol.v1.Operation.consumer_id.
    */
   core.String consumerId;
 
   DisableServiceRequest();
 
   DisableServiceRequest.fromJson(core.Map _json) {
     if (_json.containsKey("consumerId")) {
@@ skipping 192 matching lines @@
   }
 }
 
 /** Request message for EnableService method. */
 class EnableServiceRequest {
   /**
    * The identity of consumer resource which service enablement will be
    * applied to.
    *
    * The Google Service Management implementation accepts the following
-   * forms: "project:<project_id>", "project_number:<project_number>".
+   * forms:
+   * - "project:<project_id>"
    *
    * Note: this is made compatible with
    * google.api.servicecontrol.v1.Operation.consumer_id.
    */
   core.String consumerId;
 
   EnableServiceRequest();
 
   EnableServiceRequest.fromJson(core.Map _json) {
     if (_json.containsKey("consumerId")) {
@@ skipping 674 matching lines @@
  *     Variable = "{" FieldPath [ "=" Segments ] "}" ;
  *     FieldPath = IDENT { "." IDENT } ;
  *     Verb     = ":" LITERAL ;
  *
  * The syntax `*` matches a single path segment. It follows the semantics of
  * [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String
  * Expansion.
  *
  * The syntax `**` matches zero or more path segments. It follows the semantics
  * of [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.3 Reserved
- * Expansion.
+ * Expansion. NOTE: it must be the last segment in the path except the Verb.
  *
  * The syntax `LITERAL` matches literal text in the URL path.
  *
  * The syntax `Variable` matches the entire path as specified by its template;
  * this nested template must not contain further variables. If a variable
  * matches a single path segment, its template may be omitted, e.g. `{var}`
  * is equivalent to `{var=*}`.
  *
  * NOTE: the field paths in variables and in the `body` must not refer to
  * repeated fields or map fields.
@@ skipping 243 matching lines @@
     return _json;
   }
 }
 
 /** Response message for `ListServices` method. */
 class ListServicesResponse {
   /**
    * Token that can be passed to `ListServices` to resume a paginated query.
    */
   core.String nextPageToken;
-  /** The results of the query. */
+  /** The returned services will only have the name field set. */
   core.List<ManagedService> services;
 
   ListServicesResponse();
 
   ListServicesResponse.fromJson(core.Map _json) {
     if (_json.containsKey("nextPageToken")) {
       nextPageToken = _json["nextPageToken"];
     }
     if (_json.containsKey("services")) {
       services = _json["services"].map((value) => new ManagedService.fromJson(value)).toList();
@@ skipping 141 matching lines @@
       _json["name"] = name;
     }
     return _json;
   }
 }
 
 /**
  * Logging configuration of the service.
  *
  * The following example shows how to configure logs to be sent to the
- * producer and consumer projects. In the example,
- * the `library.googleapis.com/activity_history` log is
- * sent to both the producer and consumer projects, whereas
- * the `library.googleapis.com/purchase_history` log is only sent to the
- * producer project:
+ * producer and consumer projects. In the example, the `activity_history`
+ * log is sent to both the producer and consumer projects, whereas the
+ * `purchase_history` log is only sent to the producer project.
  *
  *     monitored_resources:
  *     - type: library.googleapis.com/branch
  *       labels:
  *       - key: /city
  *         description: The city where the library branch is located in.
  *       - key: /name
  *         description: The name of the branch.
  *     logs:
- *     - name: library.googleapis.com/activity_history
+ *     - name: activity_history
  *       labels:
  *       - key: /customer_id
- *     - name: library.googleapis.com/purchase_history
+ *     - name: purchase_history
  *     logging:
  *       producer_destinations:
  *       - monitored_resource: library.googleapis.com/branch
  *         logs:
- *         - library.googleapis.com/activity_history
- *         - library.googleapis.com/purchase_history
+ *         - activity_history
+ *         - purchase_history
  *       consumer_destinations:
  *       - monitored_resource: library.googleapis.com/branch
  *         logs:
- *         - library.googleapis.com/activity_history
+ *         - activity_history
  */
 class Logging {
   /**
    * Logging configurations for sending logs to the consumer project.
    * There can be multiple consumer destinations, each one must have a
    * different monitored resource type. A log can be used in at most
    * one consumer destination.
    */
   core.List<LoggingDestination> consumerDestinations;
   /**
@@ skipping 27 matching lines @@
   }
 }
 
 /**
  * Configuration of a specific logging destination (the producer project
  * or the consumer project).
  */
 class LoggingDestination {
   /**
    * Names of the logs to be sent to this destination. Each name must
-   * be defined in the Service.logs section.
+   * be defined in the Service.logs section. If the log name is
+   * not a domain scoped name, it will be automatically prefixed with
+   * the service name followed by "/".
    */
   core.List<core.String> logs;
   /**
-   * The monitored resource type. The type must be defined in
+   * The monitored resource type. The type must be defined in the
    * Service.monitored_resources section.
    */
   core.String monitoredResource;
 
   LoggingDestination();
 
   LoggingDestination.fromJson(core.Map _json) {
     if (_json.containsKey("logs")) {
       logs = _json["logs"];
     }
@@ skipping 170 matching lines @@
     if (responseTypeUrl != null) {
       _json["responseTypeUrl"] = responseTypeUrl;
     }
     if (syntax != null) {
       _json["syntax"] = syntax;
     }
     return _json;
   }
 }
 
-/** Defines a metric type and its schema. */
+/**
+ * Defines a metric type and its schema. Once a metric descriptor is created,
+ * deleting or altering it stops data collection and makes the metric type's
+ * existing data unusable.
+ */
 class MetricDescriptor {
   /**
    * A detailed description of the metric, which can be used in documentation.
    */
   core.String description;
   /**
    * A concise name for the metric, which can be displayed in user interfaces.
    * Use sentence case without an ending period, for example "Request count".
    */
   core.String displayName;
   /**
-   * The set of labels that can be used to describe a specific instance of this
-   * metric type. For example, the
-   * `compute.googleapis.com/instance/network/received_bytes_count` metric type
-   * has a label, `loadbalanced`, that specifies whether the traffic was
-   * received through a load balanced IP address.
+   * The set of labels that can be used to describe a specific
+   * instance of this metric type. For example, the
+   * `appengine.googleapis.com/http/server/response_latencies` metric
+   * type has a label for the HTTP response code, `response_code`, so
+   * you can look at latencies for successful responses or just
+   * for responses that failed.
    */
   core.List<LabelDescriptor> labels;
   /**
    * Whether the metric records instantaneous values, changes to a value, etc.
+   * Some combinations of `metric_kind` and `value_type` might not be supported.
    * Possible string values are:
    * - "METRIC_KIND_UNSPECIFIED" : Do not use this default value.
    * - "GAUGE" : An instantaneous measurement of a value.
    * - "DELTA" : The change in a value during a time interval.
    * - "CUMULATIVE" : A value accumulated over a time interval.  Cumulative
    * measurements in a time series should have the same start time
    * and increasing end times, until an event resets the cumulative
    * value to zero and sets a new start time for the following
    * points.
    */
   core.String metricKind;
   /**
-   * Resource name. The format of the name may vary between different
-   * implementations. For examples:
+   * The resource name of the metric descriptor. Depending on the
+   * implementation, the name typically includes: (1) the parent resource name
+   * that defines the scope of the metric type or of its data; and (2) the
+   * metric's URL-encoded type, which also appears in the `type` field of this
+   * descriptor. For example, following is the resource name of a custom
+   * metric within the GCP project 123456789:
    *
-   *     projects/{project_id}/metricDescriptors/{type=**}
-   *     metricDescriptors/{type=**}
+   * "projects/123456789/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
    */
   core.String name;
   /**
-   * The metric type including a DNS name prefix, for example
-   * `"compute.googleapis.com/instance/cpu/utilization"`. Metric types
-   * should use a natural hierarchical grouping such as the following:
+   * The metric type, including its DNS name prefix. The type is not
+   * URL-encoded.  All user-defined metric types have the DNS name
+   * `custom.googleapis.com`.  Metric types should use a natural hierarchical
+   * grouping. For example:
    *
-   *     compute.googleapis.com/instance/cpu/utilization
-   *     compute.googleapis.com/instance/disk/read_ops_count
-   *     compute.googleapis.com/instance/network/received_bytes_count
-   *
-   * Note that if the metric type changes, the monitoring data will be
-   * discontinued, and anything depends on it will break, such as monitoring
-   * dashboards, alerting rules and quota limits. Therefore, once a metric has
-   * been published, its type should be immutable.
+   *     "custom.googleapis.com/invoice/paid/amount"
+   *     "appengine.googleapis.com/http/server/response_latencies"
    */
   core.String type;
   /**
    * The unit in which the metric value is reported. It is only applicable
    * if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
    * supported units are a subset of [The Unified Code for Units of
    * Measure](http://unitsofmeasure.org/ucum.html) standard:
    *
    * **Basic units (UNIT)**
    *
@@ skipping 51 matching lines @@
    *
    * * `Annotation` is just a comment if it follows a `UNIT` and is
    *    equivalent to `1` if it is used alone. For examples,
    *    `{requests}/s == 1/s`, `By{transmitted}/s == By/s`.
    * * `NAME` is a sequence of non-blank printable ASCII characters not
    *    containing '{' or '}'.
    */
   core.String unit;
   /**
    * Whether the measurement is an integer, a floating-point number, etc.
+   * Some combinations of `metric_kind` and `value_type` might not be supported.
    * Possible string values are:
    * - "VALUE_TYPE_UNSPECIFIED" : Do not use this default value.
    * - "BOOL" : The value is a boolean.
    * This value type can be used only if the metric kind is `GAUGE`.
    * - "INT64" : The value is a signed 64-bit integer.
    * - "DOUBLE" : The value is a double precision floating point number.
    * - "STRING" : The value is a text string.
    * This value type can be used only if the metric kind is `GAUGE`.
    * - "DISTRIBUTION" : The value is a `Distribution`.
    * - "MONEY" : The value is money.
@@ skipping 427 matching lines @@
  * This resource represents a long-running operation that is the result of a
  * network API call.
  */
 class Operation {
   /**
    * If the value is `false`, it means the operation is still in progress.
    * If true, the operation is completed, and either `error` or `response` is
    * available.
    */
   core.bool done;
-  /** The error result of the operation in case of failure. */
+  /** The error result of the operation in case of failure or cancellation. */
   Status error;
   /**
    * Service-specific metadata associated with the operation.  It typically
    * contains progress information and common metadata such as create time.
    * Some services might not provide such metadata.  Any method that returns a
    * long-running operation should document the metadata type, if any.
    *
    * The values for Object must be JSON objects. It can consist of `num`,
    * `String`, `bool` and `null` as well as `Map` and `List` values.
    */
@@ skipping 537 matching lines @@
       _json["notIn"] = notIn;
     }
     if (permissions != null) {
       _json["permissions"] = permissions;
     }
     return _json;
   }
 }
 
 /**
- * `Service` is the root object of the configuration schema. It
- * describes basic information like the name of the service and the
- * exposed API interfaces, and delegates other aspects to configuration
- * sub-sections.
+ * `Service` is the root object of Google service configuration schema. It
+ * describes basic information about a service, such as the name and the
+ * title, and delegates other aspects to sub-sections. Each sub-section is
+ * either a proto message or a repeated proto message that configures a
+ * specific aspect, such as auth. See each proto message definition for details.
  *
  * Example:
  *
  *     type: google.api.Service
- *     config_version: 1
+ *     config_version: 3
  *     name: calendar.googleapis.com
  *     title: Google Calendar API
  *     apis:
- *     - name: google.calendar.Calendar
+ *     - name: google.calendar.v3.Calendar
  *     backend:
  *       rules:
- *       - selector: "*"
+ *       - selector: "google.calendar.v3.*"
  *         address: calendar.example.com
  */
 class Service {
   /**
    * A list of API interfaces exported by this service. Only the `name` field
    * of the google.protobuf.Api needs to be provided by the configuration
    * author, as the remaining fields will be derived from the IDL during the
    * normalization process. It is an error to specify an API interface here
    * which cannot be resolved against the associated IDL files.
    */
@@ skipping 34 matching lines @@
    */
   core.List<Enum> enums;
   /** HTTP configuration. */
   Http http;
   /**
    * A unique ID for a specific instance of this message, typically assigned
    * by the client for tracking purpose. If empty, the server may choose to
    * generate one instead.
    */
   core.String id;
-  /** Logging configuration of the service. */
+  /** Logging configuration. */
   Logging logging;
   /** Defines the logs used by this service. */
   core.List<LogDescriptor> logs;
   /** Defines the metrics used by this service. */
   core.List<MetricDescriptor> metrics;
   /**
    * Defines the monitored resources used by this service. This is required
    * by the Service.monitoring and Service.logging configurations.
    */
   core.List<MonitoredResourceDescriptor> monitoredResources;
-  /** Monitoring configuration of the service. */
+  /** Monitoring configuration. */
   Monitoring monitoring;
   /**
    * The DNS address at which this service is available,
    * e.g. `calendar.googleapis.com`.
    */
   core.String name;
   /**
    * The id of the Google developer project that owns the service.
    * Members of this project can manage the service configuration,
    * manage consumption of the service, etc.
    */
   core.String producerProjectId;
-  /** Configuration for system parameters. */
+  /** System parameter configuration. */
   SystemParameters systemParameters;
   /**
    * A list of all proto message types included in this API service.
    * It serves similar purpose as [google.api.Service.types], except that
    * these types are not needed by user-defined APIs. Therefore, they will not
    * show up in the generated discovery doc. This field should only be used
    * to define system APIs in ESF.
    */
   core.List<Type> systemTypes;
   /** The product title associated with this service. */
@@ skipping 927 matching lines @@
     return _json;
   }
 }
 
 /**
  * A visibility rule provides visibility configuration for an individual API
  * element.
  */
 class VisibilityRule {
   /**
-   * Lists the visibility labels for this rule. Any of the listed labels grants
-   * visibility to the element.
+   * A comma-separated list of visibility labels that apply to the `selector`.
+   * Any of the listed labels can be used to grant the visibility.
    *
    * If a rule has multiple labels, removing one of the labels but not all of
    * them can break clients.
    *
    * Example:
    *
    *     visibility:
    *       rules:
    *       - selector: google.calendar.Calendar.EnhancedSearch
    *         restriction: GOOGLE_INTERNAL, TRUSTED_TESTER
@@ skipping 24 matching lines @@
     var _json = new core.Map();
     if (restriction != null) {
       _json["restriction"] = restriction;
     }
     if (selector != null) {
       _json["selector"] = selector;
     }
     return _json;
   }
 }