docs: update generated docs (#981)
diff --git a/docs/dyn/servicemanagement_v1.services.configs.html b/docs/dyn/servicemanagement_v1.services.configs.html
index d256384..28c1a7e 100644
--- a/docs/dyn/servicemanagement_v1.services.configs.html
+++ b/docs/dyn/servicemanagement_v1.services.configs.html
@@ -81,7 +81,7 @@
<code><a href="#get">get(serviceName, configId, view=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a service configuration (version) for a managed service.</p>
<p class="toc_element">
- <code><a href="#list">list(serviceName, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(serviceName, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists the history of the service configuration for a managed service,</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -130,273 +130,6 @@
# - selector: "*"
# requirements:
# provider_id: google_calendar_auth
- "control": { # Selects and configures the service controller used by the service. The # Configuration for the service control plane.
- # service controller handles features like abuse, quota, billing, logging,
- # monitoring, etc.
- "environment": "A String", # The service control environment to use. If empty, no control plane
- # feature (like quota and billing) will be enabled.
- },
- "types": [ # A list of all proto message types included in this API service.
- # Types referenced directly or indirectly by the `apis` are
- # automatically included. Messages which are not referenced but
- # shall be included, such as types used by the `google.protobuf.Any` type,
- # should be listed here by name. Example:
- #
- # types:
- # - name: google.protobuf.Int32
- { # A protocol buffer message type.
- "fields": [ # The list of fields.
- { # A single field of a message type.
- "number": 42, # The field number.
- "name": "A String", # The field name.
- "kind": "A String", # The field type.
- "jsonName": "A String", # The field JSON name.
- "cardinality": "A String", # The field cardinality.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
- "packed": True or False, # Whether to use alternative packed wire representation.
- "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
- # types. The first type has index 1; zero means the type is not in the list.
- "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
- # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
- },
- ],
- "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
- "A String",
- ],
- "name": "A String", # The fully qualified message name.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax.
- "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- },
- ],
- "sourceInfo": { # Source information used to create a Service Config # Output only. The source information for this configuration if available.
- "sourceFiles": [ # All files used during config generation.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
- },
- "name": "A String", # The service name, which is a DNS-like logical identifier for the
- # service, such as `calendar.googleapis.com`. The service name
- # typically goes through DNS verification to make sure the owner
- # of the service also owns the DNS name.
- "title": "A String", # The product title for this service.
- "logs": [ # Defines the logs used by this service.
- { # A description of a log type. Example in YAML format:
- #
- # - name: library.googleapis.com/activity_history
- # description: The history of borrowing and returning library items.
- # display_name: Activity
- # labels:
- # - key: /customer_id
- # description: Identifier of a library customer
- "labels": [ # The set of labels that are available to describe a specific log entry.
- # Runtime requests that contain labels not specified here are
- # considered invalid.
- { # A description of a label.
- "valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
- "description": "A String", # A human-readable description for the label.
- },
- ],
- "description": "A String", # A human-readable description of this log. This information appears in
- # the documentation and can contain details.
- "displayName": "A String", # The human-readable name for this log. This information appears on
- # the user interface and should be concise.
- "name": "A String", # The name of the log. It must be less than 512 characters long and can
- # include the following characters: upper- and lower-case alphanumeric
- # characters [A-Za-z0-9], and punctuation characters including
- # slash, underscore, hyphen, period [/_-.].
- },
- ],
- "metrics": [ # Defines the metrics used by this service.
- { # 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.
- "type": "A String", # 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` or `external.googleapis.com`. Metric types should
- # use a natural hierarchical grouping. For example:
- #
- # "custom.googleapis.com/invoice/paid/amount"
- # "external.googleapis.com/prometheus/up"
- # "appengine.googleapis.com/http/server/response_latencies"
- "labels": [ # 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.
- { # A description of a label.
- "valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
- "description": "A String", # A human-readable description for the label.
- },
- ],
- "description": "A String", # A detailed description of the metric, which can be used in documentation.
- "monitoredResourceTypes": [ # Read-only. If present, then a time
- # series, which is identified partially by
- # a metric type and a MonitoredResourceDescriptor, that is associated
- # with this metric type can only be associated with one of the monitored
- # resource types listed here.
- "A String",
- ],
- "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
- # Use sentence case without an ending period, for example "Request count".
- # This field is optional but it is recommended to be set for any metrics
- # associated with user-visible concepts, such as Quota.
- "metadata": { # Additional annotations that can be used to guide the usage of a metric. # Optional. Metadata which can be used to guide usage of the metric.
- "launchStage": "A String", # Deprecated. Must use the MetricDescriptor.launch_stage instead.
- "ingestDelay": "A String", # The delay of data points caused by ingestion. Data points older than this
- # age are guaranteed to be ingested and available to be read, excluding
- # data loss due to errors.
- "samplePeriod": "A String", # The sampling period of metric data points. For metrics which are written
- # periodically, consecutive data points are stored at this time interval,
- # excluding data loss due to errors. Metrics with a higher granularity have
- # a smaller sampling period.
- },
- "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc.
- # Some combinations of `metric_kind` and `value_type` might not be supported.
- "unit": "A String", # The units in which the metric value is reported. It is only applicable
- # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit`
- # defines the representation of the stored metric values.
- #
- # Different systems may scale the values to be more easily displayed (so a
- # value of `0.02KBy` _might_ be displayed as `20By`, and a value of
- # `3523KBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is
- # `KBy`, then the value of the metric is always in thousands of bytes, no
- # matter how it may be displayed..
- #
- # If you want a custom metric to record the exact number of CPU-seconds used
- # by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is
- # `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005
- # CPU-seconds, then the value is written as `12005`.
- #
- # Alternatively, if you want a custom metric to record data in a more
- # granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
- # `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`),
- # or use `Kis{CPU}` and write `11.723` (which is `12005/1024`).
- #
- # The supported units are a subset of [The Unified Code for Units of
- # Measure](http://unitsofmeasure.org/ucum.html) standard:
- #
- # **Basic units (UNIT)**
- #
- # * `bit` bit
- # * `By` byte
- # * `s` second
- # * `min` minute
- # * `h` hour
- # * `d` day
- #
- # **Prefixes (PREFIX)**
- #
- # * `k` kilo (10^3)
- # * `M` mega (10^6)
- # * `G` giga (10^9)
- # * `T` tera (10^12)
- # * `P` peta (10^15)
- # * `E` exa (10^18)
- # * `Z` zetta (10^21)
- # * `Y` yotta (10^24)
- #
- # * `m` milli (10^-3)
- # * `u` micro (10^-6)
- # * `n` nano (10^-9)
- # * `p` pico (10^-12)
- # * `f` femto (10^-15)
- # * `a` atto (10^-18)
- # * `z` zepto (10^-21)
- # * `y` yocto (10^-24)
- #
- # * `Ki` kibi (2^10)
- # * `Mi` mebi (2^20)
- # * `Gi` gibi (2^30)
- # * `Ti` tebi (2^40)
- # * `Pi` pebi (2^50)
- #
- # **Grammar**
- #
- # The grammar also includes these connectors:
- #
- # * `/` division or ratio (as an infix operator). For examples,
- # `kBy/{email}` or `MiBy/10ms` (although you should almost never
- # have `/s` in a metric `unit`; rates should always be computed at
- # query time from the underlying cumulative or delta value).
- # * `.` multiplication or composition (as an infix operator). For
- # examples, `GBy.d` or `k{watt}.h`.
- #
- # The grammar for a unit is as follows:
- #
- # Expression = Component { "." Component } { "/" Component } ;
- #
- # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
- # | Annotation
- # | "1"
- # ;
- #
- # Annotation = "{" NAME "}" ;
- #
- # Notes:
- #
- # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
- # is used alone, then the unit is equivalent to `1`. For examples,
- # `{request}/s == 1/s`, `By{transmitted}/s == By/s`.
- # * `NAME` is a sequence of non-blank printable ASCII characters not
- # containing `{` or `}`.
- # * `1` represents a unitary [dimensionless
- # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
- # as in `1/s`. It is typically used when none of the basic units are
- # appropriate. For example, "new users per day" can be represented as
- # `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new
- # users). Alternatively, "thousands of page views per day" would be
- # represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric
- # value of `5.3` would mean "5300 page views per day").
- # * `%` represents dimensionless value of 1/100, and annotates values giving
- # a percentage (so the metric values are typically in the range of 0..100,
- # and a metric value `3` means "3 percent").
- # * `10^2.%` indicates a metric contains a ratio, typically in the range
- # 0..1, that will be multiplied by 100 and displayed as a percentage
- # (so a metric value `0.03` means "3 percent").
- "launchStage": "A String", # Optional. The launch stage of the metric definition.
- "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
- # Some combinations of `metric_kind` and `value_type` might not be supported.
- "name": "A String", # The resource name of the metric descriptor.
- },
- ],
"enums": [ # A list of all enum types included in this API service. Enums
# referenced directly or indirectly by the `apis` are automatically
# included. Enums which are not referenced but shall be included
@@ -408,530 +141,414 @@
"options": [ # Protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
- "name": "A String", # Enum type name.
- "syntax": "A String", # The source syntax.
+ "enumvalue": [ # Enum value definitions.
+ { # Enum value definition.
+ "name": "A String", # Enum value name.
+ "options": [ # Protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "number": 42, # Enum value number.
+ },
+ ],
"sourceContext": { # `SourceContext` represents information about the source of a # The source context.
# protobuf element, like the file in which it is defined.
"fileName": "A String", # The path-qualified name of the .proto file that contained the associated
# protobuf element. For example: `"google/protobuf/source_context.proto"`.
},
- "enumvalue": [ # Enum value definitions.
- { # Enum value definition.
- "name": "A String", # Enum value name.
- "number": 42, # Enum value number.
- "options": [ # Protocol buffer options.
+ "name": "A String", # Enum type name.
+ "syntax": "A String", # The source syntax.
+ },
+ ],
+ "backend": { # `Backend` defines the backend configuration for a service. # API backend configuration.
+ "rules": [ # A list of API backend rules that apply to individual API methods.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # A backend rule provides configuration for an individual API element.
+ "disableAuth": True or False, # When disable_auth is true, a JWT ID token won't be generated and the
+ # original "Authorization" HTTP header will be preserved. If the header is
+ # used to carry the original token and is expected by the backend, this
+ # field must be set to true to preserve the header.
+ "address": "A String", # The address of the API backend.
+ #
+ # The scheme is used to determine the backend protocol and security.
+ # The following schemes are accepted:
+ #
+ # SCHEME PROTOCOL SECURITY
+ # http:// HTTP None
+ # https:// HTTP TLS
+ # grpc:// gRPC None
+ # grpcs:// gRPC TLS
+ #
+ # It is recommended to explicitly include a scheme. Leaving out the scheme
+ # may cause constrasting behaviors across platforms.
+ #
+ # If the port is unspecified, the default is:
+ # - 80 for schemes without TLS
+ # - 443 for schemes with TLS
+ #
+ # For HTTP backends, use protocol
+ # to specify the protocol version.
+ "minDeadline": 3.14, # Minimum deadline in seconds needed for this method. Calls having deadline
+ # value lower than this will be rejected.
+ "selector": "A String", # Selects the methods to which this rule applies.
+ #
+ # Refer to selector for syntax details.
+ "protocol": "A String", # The protocol used for sending a request to the backend.
+ # The supported values are "http/1.1" and "h2".
+ #
+ # The default value is inferred from the scheme in the
+ # address field:
+ #
+ # SCHEME PROTOCOL
+ # http:// http/1.1
+ # https:// http/1.1
+ # grpc:// h2
+ # grpcs:// h2
+ #
+ # For secure HTTP backends (https://) that support HTTP/2, set this field
+ # to "h2" for improved performance.
+ #
+ # Configuring this field to non-default values is only supported for secure
+ # HTTP backends. This field will be ignored for all other backends.
+ #
+ # See
+ # https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
+ # for more details on the supported values.
+ "operationDeadline": 3.14, # The number of seconds to wait for the completion of a long running
+ # operation. The default is no deadline.
+ "pathTranslation": "A String",
+ "jwtAudience": "A String", # The JWT audience is used when generating a JWT ID token for the backend.
+ # This ID token will be added in the HTTP "authorization" header, and sent
+ # to the backend.
+ "deadline": 3.14, # The number of seconds to wait for a response from a request. The default
+ # varies based on the request protocol and deployment environment.
+ },
+ ],
+ },
+ "systemTypes": [ # 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.
+ { # A protocol buffer message type.
+ "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
+ "A String",
+ ],
+ "fields": [ # The list of fields.
+ { # A single field of a message type.
+ "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
+ # types. The first type has index 1; zero means the type is not in the list.
+ "name": "A String", # The field name.
+ "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
+ "packed": True or False, # Whether to use alternative packed wire representation.
+ "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
+ # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
+ "cardinality": "A String", # The field cardinality.
+ "jsonName": "A String", # The field JSON name.
+ "kind": "A String", # The field type.
+ "options": [ # The protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
+ "number": 42, # The field number.
},
],
- },
- ],
- "authentication": { # `Authentication` defines the authentication configuration for an API. # Auth configuration.
- #
- # Example for an API targeted for external use:
- #
- # name: calendar.googleapis.com
- # authentication:
- # providers:
- # - id: google_calendar_auth
- # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
- # issuer: https://securetoken.google.com
- # rules:
- # - selector: "*"
- # requirements:
- # provider_id: google_calendar_auth
- "rules": [ # A list of authentication rules that apply to individual API methods.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # Authentication rules for the service.
- #
- # By default, if a method has any authentication requirements, every request
- # must include a valid credential matching one of the requirements.
- # It's an error to include more than one kind of credential in a single
- # request.
- #
- # If a method doesn't have any auth requirements, request credentials will be
- # ignored.
- "oauth": { # OAuth scopes are a way to define data and permissions on data. For example, # The requirements for OAuth credentials.
- # there are scopes defined for "Read-only access to Google Calendar" and
- # "Access to Cloud Platform". Users can consent to a scope for an application,
- # giving it permission to access that data on their behalf.
- #
- # OAuth scope specifications should be fairly coarse grained; a user will need
- # to see and understand the text description of what your scope means.
- #
- # In most cases: use one or at most two OAuth scopes for an entire family of
- # products. If your product has multiple APIs, you should probably be sharing
- # the OAuth scope across all of those APIs.
- #
- # When you need finer grained OAuth consent screens: talk with your product
- # management about how developers will use them in practice.
- #
- # Please note that even though each of the canonical scopes is enough for a
- # request to be accepted and passed to the backend, a request can still fail
- # due to the backend requiring additional scopes or permissions.
- "canonicalScopes": "A String", # The list of publicly documented OAuth scopes that are allowed access. An
- # OAuth token containing any of these scopes will be accepted.
- #
- # Example:
- #
- # canonical_scopes: https://www.googleapis.com/auth/calendar,
- # https://www.googleapis.com/auth/calendar.read
- },
- "requirements": [ # Requirements for additional authentication providers.
- { # User-defined authentication requirements, including support for
- # [JSON Web Token
- # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
- "audiences": "A String", # 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:
- #
- # audiences: bookstore_android.apps.googleusercontent.com,
- # bookstore_web.apps.googleusercontent.com
- "providerId": "A String", # id from authentication provider.
- #
- # Example:
- #
- # provider_id: bookstore_auth
- },
- ],
- "allowWithoutCredential": True or False, # If true, the service accepts API keys without any other credential.
- "selector": "A String", # Selects the methods to which this rule applies.
- #
- # Refer to selector for syntax details.
- },
- ],
- "providers": [ # Defines a set of authentication providers that a service supports.
- { # Configuration for an authentication provider, including support for
- # [JSON Web Token
- # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
- "audiences": "A String", # 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, JWTs with audiences:
- # - "https://[service.name]/[google.protobuf.Api.name]"
- # - "https://[service.name]/"
- # will be accepted.
- # For example, if no audiences are in the setting, LibraryService API will
- # accept JWTs with the following audiences:
- # -
- # https://library-example.googleapis.com/google.example.library.v1.LibraryService
- # - https://library-example.googleapis.com/
- #
- # Example:
- #
- # audiences: bookstore_android.apps.googleusercontent.com,
- # bookstore_web.apps.googleusercontent.com
- "jwtLocations": [ # Defines the locations to extract the JWT.
- #
- # JWT locations can be either from HTTP headers or URL query parameters.
- # The rule is that the first match wins. The checking order is: checking
- # all headers first, then URL query parameters.
- #
- # If not specified, default to use following 3 locations:
- # 1) Authorization: Bearer
- # 2) x-goog-iap-jwt-assertion
- # 3) access_token query parameter
- #
- # Default locations can be specified as followings:
- # jwt_locations:
- # - header: Authorization
- # value_prefix: "Bearer "
- # - header: x-goog-iap-jwt-assertion
- # - query: access_token
- { # Specifies a location to extract JWT from an API request.
- "query": "A String", # Specifies URL query parameter name to extract JWT token.
- "header": "A String", # Specifies HTTP header name to extract JWT token.
- "valuePrefix": "A String", # The value prefix. The value format is "value_prefix{token}"
- # Only applies to "in" header type. Must be empty for "in" query type.
- # If not empty, the header value has to match (case sensitive) this prefix.
- # If not matched, JWT will not be extracted. If matched, JWT will be
- # extracted after the prefix is removed.
- #
- # For example, for "Authorization: Bearer {JWT}",
- # value_prefix="Bearer " with a space at the end.
- },
- ],
- "issuer": "A String", # 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.
- #
- # Example: https://securetoken.google.com
- # Example: 1234567-compute@developer.gserviceaccount.com
- "id": "A String", # The unique identifier of the auth provider. It will be referred to by
- # `AuthRequirement.provider_id`.
- #
- # Example: "bookstore_auth".
- "jwksUri": "A String", # URL of the provider's public key set to validate signature of the JWT. See
- # [OpenID
- # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).
- # Optional if the key set document:
- # - can be retrieved from
- # [OpenID
- # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
- # the issuer.
- # - can be inferred from the email domain of the issuer (e.g. a Google
- # service account).
- #
- # Example: https://www.googleapis.com/oauth2/v1/certs
- "authorizationUrl": "A String", # Redirect URL if JWT token is required but not present or is expired.
- # Implement authorizationUrl of securityDefinitions in OpenAPI spec.
- },
- ],
- },
- "documentation": { # `Documentation` provides the information for describing a service. # Additional API documentation.
- #
- # Example:
- # <pre><code>documentation:
- # summary: >
- # The Google Calendar API gives access
- # to most calendar features.
- # pages:
- # - name: Overview
- # content: &#40;== include google/foo/overview.md ==&#41;
- # - name: Tutorial
- # content: &#40;== include google/foo/tutorial.md ==&#41;
- # subpages;
- # - name: Java
- # content: &#40;== include google/foo/tutorial_java.md ==&#41;
- # rules:
- # - selector: google.calendar.Calendar.Get
- # description: >
- # ...
- # - selector: google.calendar.Calendar.Put
- # description: >
- # ...
- # </code></pre>
- # Documentation is provided in markdown syntax. In addition to
- # standard markdown features, definition lists, tables and fenced
- # code blocks are supported. Section headers can be provided and are
- # interpreted relative to the section nesting of the context where
- # a documentation fragment is embedded.
- #
- # Documentation from the IDL is merged with documentation defined
- # via the config at normalization time, where documentation provided
- # by config rules overrides IDL provided.
- #
- # A number of constructs specific to the API platform are supported
- # in documentation text.
- #
- # In order to reference a proto element, the following
- # notation can be used:
- # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
- # To override the display text used for the link, this can be used:
- # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
- # Text can be excluded from doc using the following notation:
- # <pre><code>&#40;-- internal comment --&#41;</code></pre>
- #
- # A few directives are available in documentation. Note that
- # directives must appear on a single line to be properly
- # identified. The `include` directive includes a markdown file from
- # an external source:
- # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
- # The `resource_for` directive marks a message to be the resource of
- # a collection in REST view. If it is not specified, tools attempt
- # to infer the resource from the operations in a collection:
- # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
- # The directive `suppress_warning` does not directly affect documentation
- # and is documented together with service config validation.
- "documentationRootUrl": "A String", # The URL to the root of documentation.
- "serviceRootUrl": "A String", # Specifies the service root url if the default one (the service name
- # from the yaml file) is not suitable. This can be seen in any fully
- # specified service urls as well as sections that show a base that other
- # urls are relative to.
- "rules": [ # A list of documentation rules that apply to individual API elements.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A documentation rule provides information about individual API elements.
- "description": "A String", # Description of the selected API(s).
- "deprecationDescription": "A String", # Deprecation description of the selected element(s). It can be provided if
- # an element is marked as `deprecated`.
- "selector": "A String", # The selector is a comma-separated list of patterns. Each pattern is a
- # qualified name of the element which may end in "*", indicating a wildcard.
- # Wildcards are only allowed at the end and for a whole component of the
- # qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A
- # wildcard will match one or more components. To specify a default for all
- # applicable elements, the whole pattern "*" is used.
- },
- ],
- "pages": [ # The top level pages for the documentation set.
- { # Represents a documentation page. A page can contain subpages to represent
- # nested documentation set structure.
- "name": "A String", # The name of the page. It will be used as an identity of the page to
- # generate URI of the page, text of the link to this page in navigation,
- # etc. The full page name (start from the root page name to this page
- # concatenated with `.`) can be used as reference to the page in your
- # documentation. For example:
- # <pre><code>pages:
- # - name: Tutorial
- # content: &#40;== include tutorial.md ==&#41;
- # subpages:
- # - name: Java
- # content: &#40;== include tutorial_java.md ==&#41;
- # </code></pre>
- # You can reference `Java` page using Markdown reference link syntax:
- # `Java`.
- "subpages": [ # Subpages of this page. The order of subpages specified here will be
- # honored in the generated docset.
- # Object with schema name: Page
- ],
- "content": "A String", # The Markdown content of the page. You can use <code>&#40;== include {path}
- # ==&#41;</code> to include content from a Markdown file.
- },
- ],
- "summary": "A String", # A short summary of what the service does. Can only be provided by
- # plain text.
- "overview": "A String", # Declares a single overview page. For example:
- # <pre><code>documentation:
- # summary: ...
- # overview: &#40;== include overview.md ==&#41;
- # </code></pre>
- # This is a shortcut for the following declaration (using pages style):
- # <pre><code>documentation:
- # summary: ...
- # pages:
- # - name: Overview
- # content: &#40;== include overview.md ==&#41;
- # </code></pre>
- # Note: you cannot specify both `overview` field and `pages` field.
- },
- "apis": [ # 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.
- { # Api is a light-weight descriptor for an API Interface.
- #
- # Interfaces are also described as "protocol buffer services" in some contexts,
- # such as by the "service" keyword in a .proto file, but they are different
- # from API Services, which represent a concrete implementation of an interface
- # as opposed to simply a description of methods and bindings. They are also
- # sometimes simply referred to as "APIs" in other contexts, such as the name of
- # this message itself. See https://cloud.google.com/apis/design/glossary for
- # detailed terminology.
- "options": [ # Any metadata attached to the interface.
+ "options": [ # The protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
- "syntax": "A String", # The source syntax of the service.
- "sourceContext": { # `SourceContext` represents information about the source of a # Source context for the protocol buffer service represented by this
- # message.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- "mixins": [ # Included interfaces. See Mixin.
- { # Declares an API Interface to be included in this interface. The including
- # interface must redeclare all the methods from the included interface, but
- # documentation and options are inherited as follows:
- #
- # - If after comment and whitespace stripping, the documentation
- # string of the redeclared method is empty, it will be inherited
- # from the original method.
- #
- # - Each annotation belonging to the service config (http,
- # visibility) which is not set in the redeclared method will be
- # inherited.
- #
- # - If an http annotation is inherited, the path pattern will be
- # modified as follows. Any version prefix will be replaced by the
- # version of the including interface plus the root path if
- # specified.
- #
- # Example of a simple mixin:
- #
- # package google.acl.v1;
- # service AccessControl {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v1/{resource=**}:getAcl";
- # }
- # }
- #
- # package google.storage.v2;
- # service Storage {
- # // rpc GetAcl(GetAclRequest) returns (Acl);
- #
- # // Get a data record.
- # rpc GetData(GetDataRequest) returns (Data) {
- # option (google.api.http).get = "/v2/{resource=**}";
- # }
- # }
- #
- # Example of a mixin configuration:
- #
- # apis:
- # - name: google.storage.v2.Storage
- # mixins:
- # - name: google.acl.v1.AccessControl
- #
- # The mixin construct implies that all methods in `AccessControl` are
- # also declared with same name and request/response types in
- # `Storage`. A documentation generator or annotation processor will
- # see the effective `Storage.GetAcl` method after inherting
- # documentation and annotations as follows:
- #
- # service Storage {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v2/{resource=**}:getAcl";
- # }
- # ...
- # }
- #
- # Note how the version in the path pattern changed from `v1` to `v2`.
- #
- # If the `root` field in the mixin is specified, it should be a
- # relative path under which inherited HTTP paths are placed. Example:
- #
- # apis:
- # - name: google.storage.v2.Storage
- # mixins:
- # - name: google.acl.v1.AccessControl
- # root: acls
- #
- # This implies the following inherited HTTP annotation:
- #
- # service Storage {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v2/acls/{resource=**}:getAcl";
- # }
- # ...
- # }
- "name": "A String", # The fully qualified name of the interface which is included.
- "root": "A String", # If non-empty specifies a path under which inherited HTTP paths
- # are rooted.
- },
- ],
- "version": "A String", # A version string for this interface. If specified, must have the form
- # `major-version.minor-version`, as in `1.10`. If the minor version is
- # omitted, it defaults to zero. If the entire version field is empty, the
- # major version is derived from the package name, as outlined below. If the
- # field is not empty, the version in the package name will be verified to be
- # consistent with what is provided here.
- #
- # The versioning schema uses [semantic
- # versioning](http://semver.org) where the major version number
- # indicates a breaking change and the minor version an additive,
- # non-breaking change. Both version numbers are signals to users
- # what to expect from different versions, and should be carefully
- # chosen based on the product plan.
- #
- # The major version is also reflected in the package name of the
- # interface, which must end in `v<major-version>`, as in
- # `google.feature.v1`. For major versions 0 and 1, the suffix can
- # be omitted. Zero major versions must only be used for
- # experimental, non-GA interfaces.
- "methods": [ # The methods of this interface, in unspecified order.
- { # Method represents a method of an API interface.
- "requestTypeUrl": "A String", # A URL of the input message type.
- "name": "A String", # The simple name of this method.
- "responseStreaming": True or False, # If true, the response is streamed.
- "requestStreaming": True or False, # If true, the request is streamed.
- "options": [ # Any metadata attached to the method.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax of this method.
- "responseTypeUrl": "A String", # The URL of the output message type.
- },
- ],
- "name": "A String", # The fully qualified name of this interface, including package name
- # followed by the interface's simple name.
+ "syntax": "A String", # The source syntax.
+ "name": "A String", # The fully qualified message name.
},
],
- "customError": { # Customize service error responses. For example, list any service # Custom error configuration.
- # specific protobuf types that can appear in error detail lists of
- # error responses.
- #
- # Example:
- #
- # custom_error:
- # types:
- # - google.foo.v1.CustomError
- # - google.foo.v1.AnotherError
- "types": [ # The list of custom error detail types, e.g. 'google.foo.v1.CustomError'.
- "A String",
- ],
- "rules": [ # The list of custom error rules that apply to individual API messages.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A custom error rule.
- "isErrorType": True or False, # Mark this message as possible payload in error response. Otherwise,
- # objects of this type will be filtered when they appear in error payload.
- "selector": "A String", # Selects messages to which this rule applies.
- #
- # Refer to selector for syntax details.
+ "name": "A String", # The service name, which is a DNS-like logical identifier for the
+ # service, such as `calendar.googleapis.com`. The service name
+ # typically goes through DNS verification to make sure the owner
+ # of the service also owns the DNS name.
+ "sourceInfo": { # Source information used to create a Service Config # Output only. The source information for this configuration if available.
+ "sourceFiles": [ # All files used during config generation.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
},
- "id": "A String", # A unique ID for a specific instance of this message, typically assigned
- # by the client for tracking purpose. Must be no longer than 63 characters
- # and only lower case letters, digits, '.', '_' and '-' are allowed. If
- # empty, the server may choose to generate one instead.
+ "billing": { # Billing related configuration of the service. # Billing configuration.
+ #
+ # The following example shows how to configure monitored resources and metrics
+ # for billing, `consumer_destinations` is the only supported destination and
+ # the monitored resources need at least one label key
+ # `cloud.googleapis.com/location` to indicate the location of the billing
+ # usage, using different monitored resources between monitoring and billing is
+ # recommended so they can be evolved independently:
+ #
+ #
+ # monitored_resources:
+ # - type: library.googleapis.com/billing_branch
+ # labels:
+ # - key: cloud.googleapis.com/location
+ # description: |
+ # Predefined label to support billing location restriction.
+ # - key: city
+ # description: |
+ # Custom label to define the city where the library branch is located
+ # in.
+ # - key: name
+ # description: Custom label to define the name of the library branch.
+ # metrics:
+ # - name: library.googleapis.com/book/borrowed_count
+ # metric_kind: DELTA
+ # value_type: INT64
+ # unit: "1"
+ # billing:
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/billing_branch
+ # metrics:
+ # - library.googleapis.com/book/borrowed_count
+ "consumerDestinations": [ # Billing configurations for sending metrics to the consumer project.
+ # There can be multiple consumer destinations per service, each one must have
+ # a different monitored resource type. A metric can be used in at most
+ # one consumer destination.
+ { # Configuration of a specific billing destination (Currently only support
+ # bill against consumer project).
+ "metrics": [ # Names of the metrics to report to this billing destination.
+ # Each name must be defined in Service.metrics section.
+ "A String",
+ ],
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ },
+ ],
+ },
+ "monitoring": { # Monitoring configuration of the service. # Monitoring configuration.
+ #
+ # The example below shows how to configure monitored resources and metrics
+ # for monitoring. In the example, a monitored resource and two metrics are
+ # defined. The `library.googleapis.com/book/returned_count` metric is sent
+ # to both producer and consumer projects, whereas the
+ # `library.googleapis.com/book/num_overdue` metric is only sent to the
+ # consumer project.
+ #
+ # monitored_resources:
+ # - type: library.googleapis.com/Branch
+ # display_name: "Library Branch"
+ # description: "A branch of a library."
+ # launch_stage: GA
+ # labels:
+ # - key: resource_container
+ # description: "The Cloud container (ie. project id) for the Branch."
+ # - key: location
+ # description: "The location of the library branch."
+ # - key: branch_id
+ # description: "The id of the branch."
+ # metrics:
+ # - name: library.googleapis.com/book/returned_count
+ # display_name: "Books Returned"
+ # description: "The count of books that have been returned."
+ # launch_stage: GA
+ # metric_kind: DELTA
+ # value_type: INT64
+ # unit: "1"
+ # labels:
+ # - key: customer_id
+ # description: "The id of the customer."
+ # - name: library.googleapis.com/book/num_overdue
+ # display_name: "Books Overdue"
+ # description: "The current number of overdue books."
+ # launch_stage: GA
+ # metric_kind: GAUGE
+ # value_type: INT64
+ # unit: "1"
+ # labels:
+ # - key: customer_id
+ # description: "The id of the customer."
+ # monitoring:
+ # producer_destinations:
+ # - monitored_resource: library.googleapis.com/Branch
+ # metrics:
+ # - library.googleapis.com/book/returned_count
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/Branch
+ # metrics:
+ # - library.googleapis.com/book/returned_count
+ # - library.googleapis.com/book/num_overdue
+ "producerDestinations": [ # Monitoring configurations for sending metrics to the producer project.
+ # There can be multiple producer destinations. A monitored resource type may
+ # appear in multiple monitoring destinations if different aggregations are
+ # needed for different sets of metrics associated with that monitored
+ # resource type. A monitored resource and metric pair may only be used once
+ # in the Monitoring configuration.
+ { # Configuration of a specific monitoring destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ "metrics": [ # Types of the metrics to report to this monitoring destination.
+ # Each type must be defined in Service.metrics section.
+ "A String",
+ ],
+ },
+ ],
+ "consumerDestinations": [ # Monitoring configurations for sending metrics to the consumer project.
+ # There can be multiple consumer destinations. A monitored resource type may
+ # appear in multiple monitoring destinations if different aggregations are
+ # needed for different sets of metrics associated with that monitored
+ # resource type. A monitored resource and metric pair may only be used once
+ # in the Monitoring configuration.
+ { # Configuration of a specific monitoring destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ "metrics": [ # Types of the metrics to report to this monitoring destination.
+ # Each type must be defined in Service.metrics section.
+ "A String",
+ ],
+ },
+ ],
+ },
+ "logging": { # Logging configuration of the service. # Logging configuration.
+ #
+ # The following example shows how to configure logs to be sent to the
+ # 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: activity_history
+ # labels:
+ # - key: /customer_id
+ # - name: purchase_history
+ # logging:
+ # producer_destinations:
+ # - monitored_resource: library.googleapis.com/branch
+ # logs:
+ # - activity_history
+ # - purchase_history
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/branch
+ # logs:
+ # - activity_history
+ "producerDestinations": [ # Logging configurations for sending logs to the producer project.
+ # There can be multiple producer destinations, each one must have a
+ # different monitored resource type. A log can be used in at most
+ # one producer destination.
+ { # Configuration of a specific logging destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
+ # Service.monitored_resources section.
+ "logs": [ # Names of the logs to be sent to this destination. Each name must
+ # 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 "/".
+ "A String",
+ ],
+ },
+ ],
+ "consumerDestinations": [ # 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.
+ { # Configuration of a specific logging destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
+ # Service.monitored_resources section.
+ "logs": [ # Names of the logs to be sent to this destination. Each name must
+ # 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 "/".
+ "A String",
+ ],
+ },
+ ],
+ },
+ "control": { # Selects and configures the service controller used by the service. The # Configuration for the service control plane.
+ # service controller handles features like abuse, quota, billing, logging,
+ # monitoring, etc.
+ "environment": "A String", # The service control environment to use. If empty, no control plane
+ # feature (like quota and billing) will be enabled.
+ },
"usage": { # Configuration controlling usage of a service. # Configuration controlling usage of this service.
"requirements": [ # Requirements that must be satisfied before a consumer project can use the
# service. Each requirement is of the form <service.name>/<requirement-id>;
# for example 'serviceusage.googleapis.com/billing-enabled'.
"A String",
],
+ "serviceIdentity": { # The per-product per-project service identity for a service. # The configuration of a per-product per-project service identity.
+ #
+ #
+ # Use this field to configure per-product per-project service identity.
+ # Example of a service identity configuration.
+ #
+ # usage:
+ # service_identity:
+ # - service_account_parent: "projects/123456789"
+ # display_name: "Cloud XXX Service Agent"
+ # description: "Used as the identity of Cloud XXX to access resources"
+ "serviceAccountParent": "A String", # A service account project that hosts the service accounts.
+ #
+ # An example name would be:
+ # `projects/123456789`
+ "description": "A String", # Optional. A user-specified opaque description of the service account.
+ # Must be less than or equal to 256 UTF-8 bytes.
+ "displayName": "A String", # Optional. A user-specified name for the service account.
+ # Must be less than or equal to 100 UTF-8 bytes.
+ },
"rules": [ # A list of usage rules that apply to individual API methods.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
@@ -960,16 +577,16 @@
# rules:
# - selector: "google.example.library.v1.LibraryService.CreateBook"
# allow_unregistered_calls: true
+ "skipServiceControl": True or False, # If true, the selected method should skip service control and the control
+ # plane features, such as quota and billing, will not be available.
+ # This flag is used by Google Cloud Endpoints to bypass checks for internal
+ # methods, such as service health check methods.
"selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
# methods in all APIs.
#
# Refer to selector for syntax details.
"allowUnregisteredCalls": True or False, # If true, the selected method allows unregistered calls, e.g. calls
# that don't identify any user or application.
- "skipServiceControl": True or False, # If true, the selected method should skip service control and the control
- # plane features, such as quota and billing, will not be available.
- # This flag is used by Google Cloud Endpoints to bypass checks for internal
- # methods, such as service health check methods.
},
],
"producerNotificationChannel": "A String", # The full resource name of a channel used for sending notifications to the
@@ -980,78 +597,82 @@
# channel. To use Google Cloud Pub/Sub as the channel, this must be the name
# of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format
# documented in https://cloud.google.com/pubsub/docs/overview.
- "serviceIdentity": { # The per-product per-project service identity for a service. # The configuration of a per-product per-project service identity.
- #
- #
- # Use this field to configure per-product per-project service identity.
- # Example of a service identity configuration.
- #
- # usage:
- # service_identity:
- # - service_account_parent: "projects/123456789"
- # display_name: "Cloud XXX Service Agent"
- # description: "Used as the identity of Cloud XXX to access resources"
- "displayName": "A String", # Optional. A user-specified name for the service account.
- # Must be less than or equal to 100 UTF-8 bytes.
- "description": "A String", # Optional. A user-specified opaque description of the service account.
- # Must be less than or equal to 256 UTF-8 bytes.
- "serviceAccountParent": "A String", # A service account project that hosts the service accounts.
- #
- # An example name would be:
- # `projects/123456789`
- },
},
- "endpoints": [ # Configuration for network endpoints. If this is empty, then an endpoint
- # with the same name as the service is automatically generated to service all
- # defined APIs.
- { # `Endpoint` describes a network endpoint that serves a set of APIs.
- # A service may expose any number of endpoints, and all endpoints share the
- # same service configuration, such as quota configuration and monitoring
- # configuration.
- #
- # Example service configuration:
- #
- # name: library-example.googleapis.com
- # endpoints:
- # # Below entry makes 'google.example.library.v1.Library'
- # # API be served from endpoint address library-example.googleapis.com.
- # # It also allows HTTP OPTIONS calls to be passed to the backend, for
- # # it to decide whether the subsequent cross-origin request is
- # # allowed to proceed.
- # - name: library-example.googleapis.com
- # allow_cors: true
- "name": "A String", # The canonical name of this endpoint.
- "target": "A String", # The specification of an Internet routable address of API frontend that will
- # handle requests to this [API
- # Endpoint](https://cloud.google.com/apis/design/glossary). It should be
- # either a valid IPv4 address or a fully-qualified domain name. For example,
- # "8.8.8.8" or "myservice.appspot.com".
- "allowCors": True or False, # Allowing
- # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
- # cross-domain traffic, would allow the backends served from this endpoint to
- # receive and respond to HTTP OPTIONS requests. The response will be used by
- # the browser to determine whether the subsequent cross-origin request is
- # allowed to proceed.
- "features": [ # The list of features enabled on this endpoint.
+ "types": [ # A list of all proto message types included in this API service.
+ # Types referenced directly or indirectly by the `apis` are
+ # automatically included. Messages which are not referenced but
+ # shall be included, such as types used by the `google.protobuf.Any` type,
+ # should be listed here by name. Example:
+ #
+ # types:
+ # - name: google.protobuf.Int32
+ { # A protocol buffer message type.
+ "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
"A String",
],
- "aliases": [ # DEPRECATED: This field is no longer supported. Instead of using aliases,
- # please specify multiple google.api.Endpoint for each of the intended
- # aliases.
- #
- # Additional names that this endpoint will be hosted on.
- "A String",
+ "fields": [ # The list of fields.
+ { # A single field of a message type.
+ "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
+ # types. The first type has index 1; zero means the type is not in the list.
+ "name": "A String", # The field name.
+ "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
+ "packed": True or False, # Whether to use alternative packed wire representation.
+ "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
+ # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
+ "cardinality": "A String", # The field cardinality.
+ "jsonName": "A String", # The field JSON name.
+ "kind": "A String", # The field type.
+ "options": [ # The protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "number": 42, # The field number.
+ },
],
+ "options": [ # The protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "syntax": "A String", # The source syntax.
+ "name": "A String", # The fully qualified message name.
},
],
- "configVersion": 42, # The semantic version of the service configuration. The config version
- # affects the interpretation of the service configuration. For example,
- # certain features are enabled by default for certain config versions.
- #
- # The latest config version is `3`.
"http": { # Defines the HTTP configuration for an API service. It contains a list of # HTTP configuration.
# HttpRule, each specifying the mapping of an RPC method
# to one or more HTTP REST API methods.
+ "fullyDecodeReservedExpansion": True or False, # When set to true, URL path parameters will be fully URI-decoded except in
+ # cases of single segment matches in reserved expansion, where "%2F" will be
+ # left encoded.
+ #
+ # The default behavior is to not decode RFC 6570 reserved characters in multi
+ # segment matches.
"rules": [ # A list of HTTP configuration rules that apply to individual API methods.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
@@ -1324,10 +945,29 @@
# If an API needs to use a JSON array for request or response body, it can map
# the request or response body to a repeated field. However, some gRPC
# Transcoding implementations may not support this feature.
+ "put": "A String", # Maps to HTTP PUT. Used for replacing a resource.
"selector": "A String", # Selects a method to which this rule applies.
#
# Refer to selector for syntax details.
- "put": "A String", # Maps to HTTP PUT. Used for replacing a resource.
+ "post": "A String", # Maps to HTTP POST. Used for creating a resource or performing an action.
+ "responseBody": "A String", # Optional. The name of the response field whose value is mapped to the HTTP
+ # response body. When omitted, the entire response message will be used
+ # as the HTTP response body.
+ #
+ # NOTE: The referred field must be present at the top-level of the response
+ # message type.
+ "body": "A String", # The name of the request field whose value is mapped to the HTTP request
+ # body, or `*` for mapping all request fields not captured by the path
+ # pattern to the HTTP body, or omitted for not having any HTTP request body.
+ #
+ # NOTE: the referred field must be present at the top-level of the request
+ # message type.
+ "patch": "A String", # Maps to HTTP PATCH. Used for updating a resource.
+ "additionalBindings": [ # Additional HTTP bindings for the selector. Nested bindings must
+ # not contain an `additional_bindings` field themselves (that is,
+ # the nesting may only be one level deep).
+ # Object with schema name: HttpRule
+ ],
"custom": { # A custom pattern is used for defining custom HTTP verb. # The custom pattern is used for specifying an HTTP method that is not
# included in the `pattern` field, such as HEAD, or "*" to leave the
# HTTP method unspecified for this rule. The wild-card rule is useful
@@ -1335,378 +975,354 @@
"path": "A String", # The path matched by this custom verb.
"kind": "A String", # The name of this custom HTTP verb.
},
- "responseBody": "A String", # Optional. The name of the response field whose value is mapped to the HTTP
- # response body. When omitted, the entire response message will be used
- # as the HTTP response body.
- #
- # NOTE: The referred field must be present at the top-level of the response
- # message type.
"allowHalfDuplex": True or False, # When this flag is set to true, HTTP requests will be allowed to invoke a
# half-duplex streaming method.
- "additionalBindings": [ # Additional HTTP bindings for the selector. Nested bindings must
- # not contain an `additional_bindings` field themselves (that is,
- # the nesting may only be one level deep).
- # Object with schema name: HttpRule
- ],
- "patch": "A String", # Maps to HTTP PATCH. Used for updating a resource.
+ "delete": "A String", # Maps to HTTP DELETE. Used for deleting a resource.
"get": "A String", # Maps to HTTP GET. Used for listing and getting information about
# resources.
- "post": "A String", # Maps to HTTP POST. Used for creating a resource or performing an action.
- "body": "A String", # The name of the request field whose value is mapped to the HTTP request
- # body, or `*` for mapping all request fields not captured by the path
- # pattern to the HTTP body, or omitted for not having any HTTP request body.
- #
- # NOTE: the referred field must be present at the top-level of the request
- # message type.
- "delete": "A String", # Maps to HTTP DELETE. Used for deleting a resource.
},
],
- "fullyDecodeReservedExpansion": True or False, # When set to true, URL path parameters will be fully URI-decoded except in
- # cases of single segment matches in reserved expansion, where "%2F" will be
- # left encoded.
+ },
+ "logs": [ # Defines the logs used by this service.
+ { # A description of a log type. Example in YAML format:
#
- # The default behavior is to not decode RFC 6570 reserved characters in multi
- # segment matches.
- },
- "billing": { # Billing related configuration of the service. # Billing configuration.
- #
- # The following example shows how to configure monitored resources and metrics
- # for billing, `consumer_destinations` is the only supported destination and
- # the monitored resources need at least one label key
- # `cloud.googleapis.com/location` to indicate the location of the billing
- # usage, using different monitored resources between monitoring and billing is
- # recommended so they can be evolved independently:
- #
- #
- # monitored_resources:
- # - type: library.googleapis.com/billing_branch
- # labels:
- # - key: cloud.googleapis.com/location
- # description: |
- # Predefined label to support billing location restriction.
- # - key: city
- # description: |
- # Custom label to define the city where the library branch is located
- # in.
- # - key: name
- # description: Custom label to define the name of the library branch.
- # metrics:
- # - name: library.googleapis.com/book/borrowed_count
- # metric_kind: DELTA
- # value_type: INT64
- # unit: "1"
- # billing:
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/billing_branch
- # metrics:
- # - library.googleapis.com/book/borrowed_count
- "consumerDestinations": [ # Billing configurations for sending metrics to the consumer project.
- # There can be multiple consumer destinations per service, each one must have
- # a different monitored resource type. A metric can be used in at most
- # one consumer destination.
- { # Configuration of a specific billing destination (Currently only support
- # bill against consumer project).
- "metrics": [ # Names of the metrics to report to this billing destination.
- # Each name must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
- },
- ],
- },
- "systemTypes": [ # 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.
- { # A protocol buffer message type.
- "fields": [ # The list of fields.
- { # A single field of a message type.
- "number": 42, # The field number.
- "name": "A String", # The field name.
- "kind": "A String", # The field type.
- "jsonName": "A String", # The field JSON name.
- "cardinality": "A String", # The field cardinality.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
- "packed": True or False, # Whether to use alternative packed wire representation.
- "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
- # types. The first type has index 1; zero means the type is not in the list.
- "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
- # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
- },
- ],
- "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
- "A String",
- ],
- "name": "A String", # The fully qualified message name.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax.
- "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- },
- ],
- "logging": { # Logging configuration of the service. # Logging configuration.
- #
- # The following example shows how to configure logs to be sent to the
- # 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: activity_history
- # labels:
- # - key: /customer_id
- # - name: purchase_history
- # logging:
- # producer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # logs:
- # - activity_history
- # - purchase_history
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # logs:
- # - activity_history
- "consumerDestinations": [ # 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.
- { # Configuration of a specific logging destination (the producer project
- # or the consumer project).
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
- # Service.monitored_resources section.
- "logs": [ # Names of the logs to be sent to this destination. Each name must
- # 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 "/".
- "A String",
- ],
- },
- ],
- "producerDestinations": [ # Logging configurations for sending logs to the producer project.
- # There can be multiple producer destinations, each one must have a
- # different monitored resource type. A log can be used in at most
- # one producer destination.
- { # Configuration of a specific logging destination (the producer project
- # or the consumer project).
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
- # Service.monitored_resources section.
- "logs": [ # Names of the logs to be sent to this destination. Each name must
- # 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 "/".
- "A String",
- ],
- },
- ],
- },
- "monitoredResources": [ # Defines the monitored resources used by this service. This is required
- # by the Service.monitoring and Service.logging configurations.
- { # An object that describes the schema of a MonitoredResource object using a
- # type name and a set of labels. For example, the monitored resource
- # descriptor for Google Compute Engine VM instances has a type of
- # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
- # `"zone"` to identify particular VM instances.
- #
- # Different APIs can support different monitored resource types. APIs generally
- # provide a `list` method that returns the monitored resource descriptors used
- # by the API.
- "launchStage": "A String", # Optional. The launch stage of the monitored resource definition.
- "name": "A String", # Optional. The resource name of the monitored resource descriptor:
- # `"projects/{project_id}/monitoredResourceDescriptors/{type}"` where
- # {type} is the value of the `type` field in this object and
- # {project_id} is a project ID that provides API-specific context for
- # accessing the type. APIs that do not use project information can use the
- # resource name format `"monitoredResourceDescriptors/{type}"`.
- "labels": [ # Required. A set of labels used to describe instances of this monitored
- # resource type. For example, an individual Google Cloud SQL database is
- # identified by values for the labels `"database_id"` and `"zone"`.
+ # - name: library.googleapis.com/activity_history
+ # description: The history of borrowing and returning library items.
+ # display_name: Activity
+ # labels:
+ # - key: /customer_id
+ # description: Identifier of a library customer
+ "description": "A String", # A human-readable description of this log. This information appears in
+ # the documentation and can contain details.
+ "labels": [ # The set of labels that are available to describe a specific log entry.
+ # Runtime requests that contain labels not specified here are
+ # considered invalid.
{ # A description of a label.
"valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
"description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
},
],
- "type": "A String", # Required. The monitored resource type. For example, the type
- # `"cloudsql_database"` represents databases in Google Cloud SQL.
- # The maximum length of this value is 256 characters.
- "description": "A String", # Optional. A detailed description of the monitored resource type that might
- # be used in documentation.
- "displayName": "A String", # Optional. A concise name for the monitored resource type that might be
- # displayed in user interfaces. It should be a Title Cased Noun Phrase,
- # without any article or other determiners. For example,
- # `"Google Cloud SQL Database"`.
+ "displayName": "A String", # The human-readable name for this log. This information appears on
+ # the user interface and should be concise.
+ "name": "A String", # The name of the log. It must be less than 512 characters long and can
+ # include the following characters: upper- and lower-case alphanumeric
+ # characters [A-Za-z0-9], and punctuation characters including
+ # slash, underscore, hyphen, period [/_-.].
},
],
- "monitoring": { # Monitoring configuration of the service. # Monitoring configuration.
- #
- # The example below shows how to configure monitored resources and metrics
- # for monitoring. In the example, a monitored resource and two metrics are
- # defined. The `library.googleapis.com/book/returned_count` metric is sent
- # to both producer and consumer projects, whereas the
- # `library.googleapis.com/book/overdue_count` metric is only sent to the
- # consumer 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.
- # metrics:
- # - name: library.googleapis.com/book/returned_count
- # metric_kind: DELTA
- # value_type: INT64
- # labels:
- # - key: /customer_id
- # - name: library.googleapis.com/book/overdue_count
- # metric_kind: GAUGE
- # value_type: INT64
- # labels:
- # - key: /customer_id
- # monitoring:
- # producer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # metrics:
- # - library.googleapis.com/book/returned_count
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # metrics:
- # - library.googleapis.com/book/returned_count
- # - library.googleapis.com/book/overdue_count
- "producerDestinations": [ # Monitoring configurations for sending metrics to the producer project.
- # There can be multiple producer destinations. A monitored resouce type may
- # appear in multiple monitoring destinations if different aggregations are
- # needed for different sets of metrics associated with that monitored
- # resource type. A monitored resource and metric pair may only be used once
- # in the Monitoring configuration.
- { # Configuration of a specific monitoring destination (the producer project
- # or the consumer project).
- "metrics": [ # Types of the metrics to report to this monitoring destination.
- # Each type must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
+ "metrics": [ # Defines the metrics used by this service.
+ { # 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.
+ #
+ # The following are specific rules for service defined Monitoring metric
+ # descriptors:
+ #
+ # * `type`, `metric_kind`, `value_type`, `description`, and `display_name`
+ # fields are all required. The `unit` field must be specified
+ # if the `value_type` is any of DOUBLE, INT64, DISTRIBUTION.
+ # * Maximum of default 500 metric descriptors per service is allowed.
+ # * Maximum of default 10 labels per metric descriptor is allowed.
+ #
+ # The default maximum limit can be overridden. Please follow
+ # https://cloud.google.com/monitoring/quotas
+ "unit": "A String", # The units in which the metric value is reported. It is only applicable
+ # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit`
+ # defines the representation of the stored metric values.
+ #
+ # Different systems may scale the values to be more easily displayed (so a
+ # value of `0.02KBy` _might_ be displayed as `20By`, and a value of
+ # `3523KBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is
+ # `KBy`, then the value of the metric is always in thousands of bytes, no
+ # matter how it may be displayed..
+ #
+ # If you want a custom metric to record the exact number of CPU-seconds used
+ # by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is
+ # `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005
+ # CPU-seconds, then the value is written as `12005`.
+ #
+ # Alternatively, if you want a custom metric to record data in a more
+ # granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
+ # `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`),
+ # or use `Kis{CPU}` and write `11.723` (which is `12005/1024`).
+ #
+ # The supported units are a subset of [The Unified Code for Units of
+ # Measure](http://unitsofmeasure.org/ucum.html) standard:
+ #
+ # **Basic units (UNIT)**
+ #
+ # * `bit` bit
+ # * `By` byte
+ # * `s` second
+ # * `min` minute
+ # * `h` hour
+ # * `d` day
+ # * `1` dimensionless
+ #
+ # **Prefixes (PREFIX)**
+ #
+ # * `k` kilo (10^3)
+ # * `M` mega (10^6)
+ # * `G` giga (10^9)
+ # * `T` tera (10^12)
+ # * `P` peta (10^15)
+ # * `E` exa (10^18)
+ # * `Z` zetta (10^21)
+ # * `Y` yotta (10^24)
+ #
+ # * `m` milli (10^-3)
+ # * `u` micro (10^-6)
+ # * `n` nano (10^-9)
+ # * `p` pico (10^-12)
+ # * `f` femto (10^-15)
+ # * `a` atto (10^-18)
+ # * `z` zepto (10^-21)
+ # * `y` yocto (10^-24)
+ #
+ # * `Ki` kibi (2^10)
+ # * `Mi` mebi (2^20)
+ # * `Gi` gibi (2^30)
+ # * `Ti` tebi (2^40)
+ # * `Pi` pebi (2^50)
+ #
+ # **Grammar**
+ #
+ # The grammar also includes these connectors:
+ #
+ # * `/` division or ratio (as an infix operator). For examples,
+ # `kBy/{email}` or `MiBy/10ms` (although you should almost never
+ # have `/s` in a metric `unit`; rates should always be computed at
+ # query time from the underlying cumulative or delta value).
+ # * `.` multiplication or composition (as an infix operator). For
+ # examples, `GBy.d` or `k{watt}.h`.
+ #
+ # The grammar for a unit is as follows:
+ #
+ # Expression = Component { "." Component } { "/" Component } ;
+ #
+ # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
+ # | Annotation
+ # | "1"
+ # ;
+ #
+ # Annotation = "{" NAME "}" ;
+ #
+ # Notes:
+ #
+ # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
+ # is used alone, then the unit is equivalent to `1`. For examples,
+ # `{request}/s == 1/s`, `By{transmitted}/s == By/s`.
+ # * `NAME` is a sequence of non-blank printable ASCII characters not
+ # containing `{` or `}`.
+ # * `1` represents a unitary [dimensionless
+ # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
+ # as in `1/s`. It is typically used when none of the basic units are
+ # appropriate. For example, "new users per day" can be represented as
+ # `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new
+ # users). Alternatively, "thousands of page views per day" would be
+ # represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric
+ # value of `5.3` would mean "5300 page views per day").
+ # * `%` represents dimensionless value of 1/100, and annotates values giving
+ # a percentage (so the metric values are typically in the range of 0..100,
+ # and a metric value `3` means "3 percent").
+ # * `10^2.%` indicates a metric contains a ratio, typically in the range
+ # 0..1, that will be multiplied by 100 and displayed as a percentage
+ # (so a metric value `0.03` means "3 percent").
+ "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
+ # Use sentence case without an ending period, for example "Request count".
+ # This field is optional but it is recommended to be set for any metrics
+ # associated with user-visible concepts, such as Quota.
+ "monitoredResourceTypes": [ # Read-only. If present, then a time
+ # series, which is identified partially by
+ # a metric type and a MonitoredResourceDescriptor, that is associated
+ # with this metric type can only be associated with one of the monitored
+ # resource types listed here.
+ "A String",
+ ],
+ "metadata": { # Additional annotations that can be used to guide the usage of a metric. # Optional. Metadata which can be used to guide usage of the metric.
+ "samplePeriod": "A String", # The sampling period of metric data points. For metrics which are written
+ # periodically, consecutive data points are stored at this time interval,
+ # excluding data loss due to errors. Metrics with a higher granularity have
+ # a smaller sampling period.
+ "ingestDelay": "A String", # The delay of data points caused by ingestion. Data points older than this
+ # age are guaranteed to be ingested and available to be read, excluding
+ # data loss due to errors.
+ "launchStage": "A String", # Deprecated. Must use the MetricDescriptor.launch_stage instead.
},
- ],
- "consumerDestinations": [ # Monitoring configurations for sending metrics to the consumer project.
- # There can be multiple consumer destinations. A monitored resouce type may
- # appear in multiple monitoring destinations if different aggregations are
- # needed for different sets of metrics associated with that monitored
- # resource type. A monitored resource and metric pair may only be used once
- # in the Monitoring configuration.
- { # Configuration of a specific monitoring destination (the producer project
- # or the consumer project).
- "metrics": [ # Types of the metrics to report to this monitoring destination.
- # Each type must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
- },
- ],
- },
- "systemParameters": { # ### System parameter configuration # System parameter configuration.
+ "name": "A String", # The resource name of the metric descriptor.
+ "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
+ # Some combinations of `metric_kind` and `value_type` might not be supported.
+ "launchStage": "A String", # Optional. The launch stage of the metric definition.
+ "type": "A String", # The metric type, including its DNS name prefix. The type is not
+ # URL-encoded.
+ #
+ # All service defined metrics must be prefixed with the service name, in the
+ # format of `{service name}/{relative metric name}`, such as
+ # `cloudsql.googleapis.com/database/cpu/utilization`. The relative metric
+ # name must follow:
+ #
+ # * Only upper and lower-case letters, digits, '/' and underscores '_' are
+ # allowed.
+ # * The maximum number of characters allowed for the relative_metric_name is
+ # 100.
+ #
+ # All user-defined metric types have the DNS name
+ # `custom.googleapis.com`, `external.googleapis.com`, or
+ # `logging.googleapis.com/user/`.
+ #
+ # Metric types should use a natural hierarchical grouping. For example:
+ #
+ # "custom.googleapis.com/invoice/paid/amount"
+ # "external.googleapis.com/prometheus/up"
+ # "appengine.googleapis.com/http/server/response_latencies"
+ "description": "A String", # A detailed description of the metric, which can be used in documentation.
+ "labels": [ # The set of labels that can be used to describe a specific
+ # instance of this metric type.
+ #
+ # The label key name must follow:
+ #
+ # * Only upper and lower-case letters, digits and underscores (_) are
+ # allowed.
+ # * Label name must start with a letter or digit.
+ # * The maximum length of a label name is 100 characters.
+ #
+ # 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.
+ { # A description of a label.
+ "valueType": "A String", # The type of data that can be assigned to the label.
+ "description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
+ },
+ ],
+ "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc.
+ # Some combinations of `metric_kind` and `value_type` might not be supported.
+ },
+ ],
+ "documentation": { # `Documentation` provides the information for describing a service. # Additional API documentation.
#
- # A system parameter is a special kind of parameter defined by the API
- # system, not by an individual API. It is typically mapped to an HTTP header
- # and/or a URL query parameter. This configuration specifies which methods
- # change the names of the system parameters.
- "rules": [ # Define system parameters.
- #
- # The parameters defined here will override the default parameters
- # implemented by the system. If this field is missing from the service
- # config, default system parameters will be used. Default system parameters
- # and names is implementation-dependent.
- #
- # Example: define api key for all methods
- #
- # system_parameters
- # rules:
- # - selector: "*"
- # parameters:
- # - name: api_key
- # url_query_parameter: api_key
- #
- #
- # Example: define 2 api key names for a specific method.
- #
- # system_parameters
- # rules:
- # - selector: "/ListShelves"
- # parameters:
- # - name: api_key
- # http_header: Api-Key1
- # - name: api_key
- # http_header: Api-Key2
+ # Example:
+ # <pre><code>documentation:
+ # summary: >
+ # The Google Calendar API gives access
+ # to most calendar features.
+ # pages:
+ # - name: Overview
+ # content: &#40;== include google/foo/overview.md ==&#41;
+ # - name: Tutorial
+ # content: &#40;== include google/foo/tutorial.md ==&#41;
+ # subpages;
+ # - name: Java
+ # content: &#40;== include google/foo/tutorial_java.md ==&#41;
+ # rules:
+ # - selector: google.calendar.Calendar.Get
+ # description: >
+ # ...
+ # - selector: google.calendar.Calendar.Put
+ # description: >
+ # ...
+ # </code></pre>
+ # Documentation is provided in markdown syntax. In addition to
+ # standard markdown features, definition lists, tables and fenced
+ # code blocks are supported. Section headers can be provided and are
+ # interpreted relative to the section nesting of the context where
+ # a documentation fragment is embedded.
+ #
+ # Documentation from the IDL is merged with documentation defined
+ # via the config at normalization time, where documentation provided
+ # by config rules overrides IDL provided.
+ #
+ # A number of constructs specific to the API platform are supported
+ # in documentation text.
+ #
+ # In order to reference a proto element, the following
+ # notation can be used:
+ # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
+ # To override the display text used for the link, this can be used:
+ # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
+ # Text can be excluded from doc using the following notation:
+ # <pre><code>&#40;-- internal comment --&#41;</code></pre>
+ #
+ # A few directives are available in documentation. Note that
+ # directives must appear on a single line to be properly
+ # identified. The `include` directive includes a markdown file from
+ # an external source:
+ # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
+ # The `resource_for` directive marks a message to be the resource of
+ # a collection in REST view. If it is not specified, tools attempt
+ # to infer the resource from the operations in a collection:
+ # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
+ # The directive `suppress_warning` does not directly affect documentation
+ # and is documented together with service config validation.
+ "serviceRootUrl": "A String", # Specifies the service root url if the default one (the service name
+ # from the yaml file) is not suitable. This can be seen in any fully
+ # specified service urls as well as sections that show a base that other
+ # urls are relative to.
+ "overview": "A String", # Declares a single overview page. For example:
+ # <pre><code>documentation:
+ # summary: ...
+ # overview: &#40;== include overview.md ==&#41;
+ # </code></pre>
+ # This is a shortcut for the following declaration (using pages style):
+ # <pre><code>documentation:
+ # summary: ...
+ # pages:
+ # - name: Overview
+ # content: &#40;== include overview.md ==&#41;
+ # </code></pre>
+ # Note: you cannot specify both `overview` field and `pages` field.
+ "documentationRootUrl": "A String", # The URL to the root of documentation.
+ "rules": [ # A list of documentation rules that apply to individual API elements.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
- { # Define a system parameter rule mapping system parameter definitions to
- # methods.
- "parameters": [ # Define parameters. Multiple names may be defined for a parameter.
- # For a given method call, only one of them should be used. If multiple
- # names are used the behavior is implementation-dependent.
- # If none of the specified names are present the behavior is
- # parameter-dependent.
- { # Define a parameter's name and location. The parameter may be passed as either
- # an HTTP header or a URL query parameter, and if both are passed the behavior
- # is implementation-dependent.
- "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
- "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
- # sensitive.
- "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
- # insensitive.
- },
- ],
- "selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
- # methods in all APIs.
- #
- # Refer to selector for syntax details.
+ { # A documentation rule provides information about individual API elements.
+ "deprecationDescription": "A String", # Deprecation description of the selected element(s). It can be provided if
+ # an element is marked as `deprecated`.
+ "description": "A String", # Description of the selected API(s).
+ "selector": "A String", # The selector is a comma-separated list of patterns. Each pattern is a
+ # qualified name of the element which may end in "*", indicating a wildcard.
+ # Wildcards are only allowed at the end and for a whole component of the
+ # qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A
+ # wildcard will match one or more components. To specify a default for all
+ # applicable elements, the whole pattern "*" is used.
},
],
+ "pages": [ # The top level pages for the documentation set.
+ { # Represents a documentation page. A page can contain subpages to represent
+ # nested documentation set structure.
+ "content": "A String", # The Markdown content of the page. You can use <code>&#40;== include {path}
+ # ==&#41;</code> to include content from a Markdown file.
+ "name": "A String", # The name of the page. It will be used as an identity of the page to
+ # generate URI of the page, text of the link to this page in navigation,
+ # etc. The full page name (start from the root page name to this page
+ # concatenated with `.`) can be used as reference to the page in your
+ # documentation. For example:
+ # <pre><code>pages:
+ # - name: Tutorial
+ # content: &#40;== include tutorial.md ==&#41;
+ # subpages:
+ # - name: Java
+ # content: &#40;== include tutorial_java.md ==&#41;
+ # </code></pre>
+ # You can reference `Java` page using Markdown reference link syntax:
+ # `Java`.
+ "subpages": [ # Subpages of this page. The order of subpages specified here will be
+ # honored in the generated docset.
+ # Object with schema name: Page
+ ],
+ },
+ ],
+ "summary": "A String", # A short summary of what the service does. Can only be provided by
+ # plain text.
},
+ "configVersion": 42, # The semantic version of the service configuration. The config version
+ # affects the interpretation of the service configuration. For example,
+ # certain features are enabled by default for certain config versions.
+ #
+ # The latest config version is `3`.
"quota": { # Quota configuration helps to achieve fairness and budgeting in service # Quota configuration.
# usage.
#
@@ -1757,23 +1373,32 @@
# metric_kind: DELTA
# value_type: INT64
#
+ "metricRules": [ # List of `MetricRule` definitions, each one mapping a selected method to one
+ # or more metrics.
+ { # Bind API methods to metrics. Binding a method to a metric causes that
+ # metric's configured quota behaviors to apply to the method call.
+ "selector": "A String", # Selects the methods to which this rule applies.
+ #
+ # Refer to selector for syntax details.
+ "metricCosts": { # Metrics to update when the selected methods are called, and the associated
+ # cost applied to each metric.
+ #
+ # The key of the map is the metric name, and the values are the amount
+ # increased for the metric against which the quota limits are defined.
+ # The value must not be negative.
+ "a_key": "A String",
+ },
+ },
+ ],
"limits": [ # List of `QuotaLimit` definitions for the service.
{ # `QuotaLimit` defines a specific limit that applies over a specified duration
# for a limit type. There can be at most one limit for a duration and limit
# type combination defined within a `QuotaGroup`.
- "displayName": "A String", # User-visible display name for this limit.
- # Optional. If not set, the UI will provide a default display name based on
- # the quota configuration. This field can be used to override the default
- # display name generated from the configuration.
- "maxLimit": "A String", # Maximum number of tokens that can be consumed during the specified
- # duration. Client application developers can override the default limit up
- # to this maximum. If specified, this value cannot be set to a value less
- # than the default limit. If not specified, it is set to the default limit.
- #
- # To allow clients to apply overrides with no upper bound, set this to -1,
- # indicating unlimited maximum quota.
- #
- # Used by group-based quotas only.
+ "values": { # Tiered limit values. You must specify this as a key:value pair, with an
+ # integer value that is the maximum number of requests allowed for the
+ # specified unit. Currently only STANDARD is supported.
+ "a_key": "A String",
+ },
"duration": "A String", # Duration of this limit in textual notation. Must be "100s" or "1d".
#
# Used by group-based quotas only.
@@ -1785,15 +1410,13 @@
# defaults to 0, indicating that there is no free tier for this service.
#
# Used by group-based quotas only.
- "unit": "A String", # Specify the unit of the quota limit. It uses the same syntax as
- # Metric.unit. The supported unit kinds are determined by the quota
- # backend system.
- #
- # Here are some examples:
- # * "1/min/{project}" for quota per minute per project.
- #
- # Note: the order of unit components is insignificant.
- # The "1" at the beginning is required to follow the metric unit syntax.
+ "displayName": "A String", # User-visible display name for this limit.
+ # Optional. If not set, the UI will provide a default display name based on
+ # the quota configuration. This field can be used to override the default
+ # display name generated from the configuration.
+ "description": "A String", # Optional. User-visible, extended description for this quota limit.
+ # Should be used only when more context is needed to understand this limit
+ # than provided by the limit's display name (see: `display_name`).
"defaultLimit": "A String", # Default number of tokens that can be consumed during the specified
# duration. This is the number of tokens assigned when a client
# application developer activates the service for his/her project.
@@ -1804,43 +1427,568 @@
# negative values are allowed.
#
# Used by group-based quotas only.
- "values": { # Tiered limit values. You must specify this as a key:value pair, with an
- # integer value that is the maximum number of requests allowed for the
- # specified unit. Currently only STANDARD is supported.
- "a_key": "A String",
- },
"name": "A String", # Name of the quota limit.
#
# The name must be provided, and it must be unique within the service. The
# name can only include alphanumeric characters as well as '-'.
#
# The maximum length of the limit name is 64 characters.
+ "maxLimit": "A String", # Maximum number of tokens that can be consumed during the specified
+ # duration. Client application developers can override the default limit up
+ # to this maximum. If specified, this value cannot be set to a value less
+ # than the default limit. If not specified, it is set to the default limit.
+ #
+ # To allow clients to apply overrides with no upper bound, set this to -1,
+ # indicating unlimited maximum quota.
+ #
+ # Used by group-based quotas only.
"metric": "A String", # The name of the metric this quota limit applies to. The quota limits with
# the same metric will be checked together during runtime. The metric must be
# defined within the service config.
- "description": "A String", # Optional. User-visible, extended description for this quota limit.
- # Should be used only when more context is needed to understand this limit
- # than provided by the limit's display name (see: `display_name`).
+ "unit": "A String", # Specify the unit of the quota limit. It uses the same syntax as
+ # Metric.unit. The supported unit kinds are determined by the quota
+ # backend system.
+ #
+ # Here are some examples:
+ # * "1/min/{project}" for quota per minute per project.
+ #
+ # Note: the order of unit components is insignificant.
+ # The "1" at the beginning is required to follow the metric unit syntax.
},
],
- "metricRules": [ # List of `MetricRule` definitions, each one mapping a selected method to one
- # or more metrics.
- { # Bind API methods to metrics. Binding a method to a metric causes that
- # metric's configured quota behaviors to apply to the method call.
- "metricCosts": { # Metrics to update when the selected methods are called, and the associated
- # cost applied to each metric.
+ },
+ "customError": { # Customize service error responses. For example, list any service # Custom error configuration.
+ # specific protobuf types that can appear in error detail lists of
+ # error responses.
+ #
+ # Example:
+ #
+ # custom_error:
+ # types:
+ # - google.foo.v1.CustomError
+ # - google.foo.v1.AnotherError
+ "types": [ # The list of custom error detail types, e.g. 'google.foo.v1.CustomError'.
+ "A String",
+ ],
+ "rules": [ # The list of custom error rules that apply to individual API messages.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # A custom error rule.
+ "selector": "A String", # Selects messages to which this rule applies.
#
- # The key of the map is the metric name, and the values are the amount
- # increased for the metric against which the quota limits are defined.
- # The value must not be negative.
- "a_key": "A String",
+ # Refer to selector for syntax details.
+ "isErrorType": True or False, # Mark this message as possible payload in error response. Otherwise,
+ # objects of this type will be filtered when they appear in error payload.
+ },
+ ],
+ },
+ "authentication": { # `Authentication` defines the authentication configuration for an API. # Auth configuration.
+ #
+ # Example for an API targeted for external use:
+ #
+ # name: calendar.googleapis.com
+ # authentication:
+ # providers:
+ # - id: google_calendar_auth
+ # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+ # issuer: https://securetoken.google.com
+ # rules:
+ # - selector: "*"
+ # requirements:
+ # provider_id: google_calendar_auth
+ "rules": [ # A list of authentication rules that apply to individual API methods.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # Authentication rules for the service.
+ #
+ # By default, if a method has any authentication requirements, every request
+ # must include a valid credential matching one of the requirements.
+ # It's an error to include more than one kind of credential in a single
+ # request.
+ #
+ # If a method doesn't have any auth requirements, request credentials will be
+ # ignored.
+ "oauth": { # OAuth scopes are a way to define data and permissions on data. For example, # The requirements for OAuth credentials.
+ # there are scopes defined for "Read-only access to Google Calendar" and
+ # "Access to Cloud Platform". Users can consent to a scope for an application,
+ # giving it permission to access that data on their behalf.
+ #
+ # OAuth scope specifications should be fairly coarse grained; a user will need
+ # to see and understand the text description of what your scope means.
+ #
+ # In most cases: use one or at most two OAuth scopes for an entire family of
+ # products. If your product has multiple APIs, you should probably be sharing
+ # the OAuth scope across all of those APIs.
+ #
+ # When you need finer grained OAuth consent screens: talk with your product
+ # management about how developers will use them in practice.
+ #
+ # Please note that even though each of the canonical scopes is enough for a
+ # request to be accepted and passed to the backend, a request can still fail
+ # due to the backend requiring additional scopes or permissions.
+ "canonicalScopes": "A String", # The list of publicly documented OAuth scopes that are allowed access. An
+ # OAuth token containing any of these scopes will be accepted.
+ #
+ # Example:
+ #
+ # canonical_scopes: https://www.googleapis.com/auth/calendar,
+ # https://www.googleapis.com/auth/calendar.read
},
+ "requirements": [ # Requirements for additional authentication providers.
+ { # User-defined authentication requirements, including support for
+ # [JSON Web Token
+ # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
+ "providerId": "A String", # id from authentication provider.
+ #
+ # Example:
+ #
+ # provider_id: bookstore_auth
+ "audiences": "A String", # 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:
+ #
+ # audiences: bookstore_android.apps.googleusercontent.com,
+ # bookstore_web.apps.googleusercontent.com
+ },
+ ],
+ "allowWithoutCredential": True or False, # If true, the service accepts API keys without any other credential.
"selector": "A String", # Selects the methods to which this rule applies.
#
# Refer to selector for syntax details.
},
],
+ "providers": [ # Defines a set of authentication providers that a service supports.
+ { # Configuration for an authentication provider, including support for
+ # [JSON Web Token
+ # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
+ "id": "A String", # The unique identifier of the auth provider. It will be referred to by
+ # `AuthRequirement.provider_id`.
+ #
+ # Example: "bookstore_auth".
+ "issuer": "A String", # 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.
+ #
+ # Example: https://securetoken.google.com
+ # Example: 1234567-compute@developer.gserviceaccount.com
+ "jwksUri": "A String", # URL of the provider's public key set to validate signature of the JWT. See
+ # [OpenID
+ # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).
+ # Optional if the key set document:
+ # - can be retrieved from
+ # [OpenID
+ # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
+ # the issuer.
+ # - can be inferred from the email domain of the issuer (e.g. a Google
+ # service account).
+ #
+ # Example: https://www.googleapis.com/oauth2/v1/certs
+ "audiences": "A String", # 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, JWTs with audiences:
+ # - "https://[service.name]/[google.protobuf.Api.name]"
+ # - "https://[service.name]/"
+ # will be accepted.
+ # For example, if no audiences are in the setting, LibraryService API will
+ # accept JWTs with the following audiences:
+ # -
+ # https://library-example.googleapis.com/google.example.library.v1.LibraryService
+ # - https://library-example.googleapis.com/
+ #
+ # Example:
+ #
+ # audiences: bookstore_android.apps.googleusercontent.com,
+ # bookstore_web.apps.googleusercontent.com
+ "authorizationUrl": "A String", # Redirect URL if JWT token is required but not present or is expired.
+ # Implement authorizationUrl of securityDefinitions in OpenAPI spec.
+ "jwtLocations": [ # Defines the locations to extract the JWT.
+ #
+ # JWT locations can be either from HTTP headers or URL query parameters.
+ # The rule is that the first match wins. The checking order is: checking
+ # all headers first, then URL query parameters.
+ #
+ # If not specified, default to use following 3 locations:
+ # 1) Authorization: Bearer
+ # 2) x-goog-iap-jwt-assertion
+ # 3) access_token query parameter
+ #
+ # Default locations can be specified as followings:
+ # jwt_locations:
+ # - header: Authorization
+ # value_prefix: "Bearer "
+ # - header: x-goog-iap-jwt-assertion
+ # - query: access_token
+ { # Specifies a location to extract JWT from an API request.
+ "query": "A String", # Specifies URL query parameter name to extract JWT token.
+ "valuePrefix": "A String", # The value prefix. The value format is "value_prefix{token}"
+ # Only applies to "in" header type. Must be empty for "in" query type.
+ # If not empty, the header value has to match (case sensitive) this prefix.
+ # If not matched, JWT will not be extracted. If matched, JWT will be
+ # extracted after the prefix is removed.
+ #
+ # For example, for "Authorization: Bearer {JWT}",
+ # value_prefix="Bearer " with a space at the end.
+ "header": "A String", # Specifies HTTP header name to extract JWT token.
+ },
+ ],
+ },
+ ],
},
+ "title": "A String", # The product title for this service.
+ "producerProjectId": "A String", # The Google project that owns this service.
+ "apis": [ # 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.
+ { # Api is a light-weight descriptor for an API Interface.
+ #
+ # Interfaces are also described as "protocol buffer services" in some contexts,
+ # such as by the "service" keyword in a .proto file, but they are different
+ # from API Services, which represent a concrete implementation of an interface
+ # as opposed to simply a description of methods and bindings. They are also
+ # sometimes simply referred to as "APIs" in other contexts, such as the name of
+ # this message itself. See https://cloud.google.com/apis/design/glossary for
+ # detailed terminology.
+ "sourceContext": { # `SourceContext` represents information about the source of a # Source context for the protocol buffer service represented by this
+ # message.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "syntax": "A String", # The source syntax of the service.
+ "methods": [ # The methods of this interface, in unspecified order.
+ { # Method represents a method of an API interface.
+ "options": [ # Any metadata attached to the method.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "responseStreaming": True or False, # If true, the response is streamed.
+ "syntax": "A String", # The source syntax of this method.
+ "requestTypeUrl": "A String", # A URL of the input message type.
+ "name": "A String", # The simple name of this method.
+ "responseTypeUrl": "A String", # The URL of the output message type.
+ "requestStreaming": True or False, # If true, the request is streamed.
+ },
+ ],
+ "name": "A String", # The fully qualified name of this interface, including package name
+ # followed by the interface's simple name.
+ "version": "A String", # A version string for this interface. If specified, must have the form
+ # `major-version.minor-version`, as in `1.10`. If the minor version is
+ # omitted, it defaults to zero. If the entire version field is empty, the
+ # major version is derived from the package name, as outlined below. If the
+ # field is not empty, the version in the package name will be verified to be
+ # consistent with what is provided here.
+ #
+ # The versioning schema uses [semantic
+ # versioning](http://semver.org) where the major version number
+ # indicates a breaking change and the minor version an additive,
+ # non-breaking change. Both version numbers are signals to users
+ # what to expect from different versions, and should be carefully
+ # chosen based on the product plan.
+ #
+ # The major version is also reflected in the package name of the
+ # interface, which must end in `v<major-version>`, as in
+ # `google.feature.v1`. For major versions 0 and 1, the suffix can
+ # be omitted. Zero major versions must only be used for
+ # experimental, non-GA interfaces.
+ "options": [ # Any metadata attached to the interface.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "mixins": [ # Included interfaces. See Mixin.
+ { # Declares an API Interface to be included in this interface. The including
+ # interface must redeclare all the methods from the included interface, but
+ # documentation and options are inherited as follows:
+ #
+ # - If after comment and whitespace stripping, the documentation
+ # string of the redeclared method is empty, it will be inherited
+ # from the original method.
+ #
+ # - Each annotation belonging to the service config (http,
+ # visibility) which is not set in the redeclared method will be
+ # inherited.
+ #
+ # - If an http annotation is inherited, the path pattern will be
+ # modified as follows. Any version prefix will be replaced by the
+ # version of the including interface plus the root path if
+ # specified.
+ #
+ # Example of a simple mixin:
+ #
+ # package google.acl.v1;
+ # service AccessControl {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v1/{resource=**}:getAcl";
+ # }
+ # }
+ #
+ # package google.storage.v2;
+ # service Storage {
+ # // rpc GetAcl(GetAclRequest) returns (Acl);
+ #
+ # // Get a data record.
+ # rpc GetData(GetDataRequest) returns (Data) {
+ # option (google.api.http).get = "/v2/{resource=**}";
+ # }
+ # }
+ #
+ # Example of a mixin configuration:
+ #
+ # apis:
+ # - name: google.storage.v2.Storage
+ # mixins:
+ # - name: google.acl.v1.AccessControl
+ #
+ # The mixin construct implies that all methods in `AccessControl` are
+ # also declared with same name and request/response types in
+ # `Storage`. A documentation generator or annotation processor will
+ # see the effective `Storage.GetAcl` method after inherting
+ # documentation and annotations as follows:
+ #
+ # service Storage {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v2/{resource=**}:getAcl";
+ # }
+ # ...
+ # }
+ #
+ # Note how the version in the path pattern changed from `v1` to `v2`.
+ #
+ # If the `root` field in the mixin is specified, it should be a
+ # relative path under which inherited HTTP paths are placed. Example:
+ #
+ # apis:
+ # - name: google.storage.v2.Storage
+ # mixins:
+ # - name: google.acl.v1.AccessControl
+ # root: acls
+ #
+ # This implies the following inherited HTTP annotation:
+ #
+ # service Storage {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v2/acls/{resource=**}:getAcl";
+ # }
+ # ...
+ # }
+ "root": "A String", # If non-empty specifies a path under which inherited HTTP paths
+ # are rooted.
+ "name": "A String", # The fully qualified name of the interface which is included.
+ },
+ ],
+ },
+ ],
+ "id": "A String", # A unique ID for a specific instance of this message, typically assigned
+ # by the client for tracking purpose. Must be no longer than 63 characters
+ # and only lower case letters, digits, '.', '_' and '-' are allowed. If
+ # empty, the server may choose to generate one instead.
+ "endpoints": [ # Configuration for network endpoints. If this is empty, then an endpoint
+ # with the same name as the service is automatically generated to service all
+ # defined APIs.
+ { # `Endpoint` describes a network endpoint that serves a set of APIs.
+ # A service may expose any number of endpoints, and all endpoints share the
+ # same service configuration, such as quota configuration and monitoring
+ # configuration.
+ #
+ # Example service configuration:
+ #
+ # name: library-example.googleapis.com
+ # endpoints:
+ # # Below entry makes 'google.example.library.v1.Library'
+ # # API be served from endpoint address library-example.googleapis.com.
+ # # It also allows HTTP OPTIONS calls to be passed to the backend, for
+ # # it to decide whether the subsequent cross-origin request is
+ # # allowed to proceed.
+ # - name: library-example.googleapis.com
+ # allow_cors: true
+ "name": "A String", # The canonical name of this endpoint.
+ "allowCors": True or False, # Allowing
+ # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
+ # cross-domain traffic, would allow the backends served from this endpoint to
+ # receive and respond to HTTP OPTIONS requests. The response will be used by
+ # the browser to determine whether the subsequent cross-origin request is
+ # allowed to proceed.
+ "target": "A String", # The specification of an Internet routable address of API frontend that will
+ # handle requests to this [API
+ # Endpoint](https://cloud.google.com/apis/design/glossary). It should be
+ # either a valid IPv4 address or a fully-qualified domain name. For example,
+ # "8.8.8.8" or "myservice.appspot.com".
+ "aliases": [ # DEPRECATED: This field is no longer supported. Instead of using aliases,
+ # please specify multiple google.api.Endpoint for each of the intended
+ # aliases.
+ #
+ # Additional names that this endpoint will be hosted on.
+ "A String",
+ ],
+ },
+ ],
+ "systemParameters": { # ### System parameter configuration # System parameter configuration.
+ #
+ # A system parameter is a special kind of parameter defined by the API
+ # system, not by an individual API. It is typically mapped to an HTTP header
+ # and/or a URL query parameter. This configuration specifies which methods
+ # change the names of the system parameters.
+ "rules": [ # Define system parameters.
+ #
+ # The parameters defined here will override the default parameters
+ # implemented by the system. If this field is missing from the service
+ # config, default system parameters will be used. Default system parameters
+ # and names is implementation-dependent.
+ #
+ # Example: define api key for all methods
+ #
+ # system_parameters
+ # rules:
+ # - selector: "*"
+ # parameters:
+ # - name: api_key
+ # url_query_parameter: api_key
+ #
+ #
+ # Example: define 2 api key names for a specific method.
+ #
+ # system_parameters
+ # rules:
+ # - selector: "/ListShelves"
+ # parameters:
+ # - name: api_key
+ # http_header: Api-Key1
+ # - name: api_key
+ # http_header: Api-Key2
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # Define a system parameter rule mapping system parameter definitions to
+ # methods.
+ "parameters": [ # Define parameters. Multiple names may be defined for a parameter.
+ # For a given method call, only one of them should be used. If multiple
+ # names are used the behavior is implementation-dependent.
+ # If none of the specified names are present the behavior is
+ # parameter-dependent.
+ { # Define a parameter's name and location. The parameter may be passed as either
+ # an HTTP header or a URL query parameter, and if both are passed the behavior
+ # is implementation-dependent.
+ "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
+ "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
+ # insensitive.
+ "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
+ # sensitive.
+ },
+ ],
+ "selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
+ # methods in all APIs.
+ #
+ # Refer to selector for syntax details.
+ },
+ ],
+ },
+ "monitoredResources": [ # Defines the monitored resources used by this service. This is required
+ # by the Service.monitoring and Service.logging configurations.
+ { # An object that describes the schema of a MonitoredResource object using a
+ # type name and a set of labels. For example, the monitored resource
+ # descriptor for Google Compute Engine VM instances has a type of
+ # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
+ # `"zone"` to identify particular VM instances.
+ #
+ # Different services can support different monitored resource types.
+ #
+ # The following are specific rules to service defined monitored resources for
+ # Monitoring and Logging:
+ #
+ # * The `type`, `display_name`, `description`, `labels` and `launch_stage`
+ # fields are all required.
+ # * The first label of the monitored resource descriptor must be
+ # `resource_container`. There are legacy monitored resource descritptors
+ # start with `project_id`.
+ # * It must include a `location` label.
+ # * Maximum of default 5 service defined monitored resource descriptors
+ # is allowed per service.
+ # * Maximum of default 10 labels per monitored resource is allowed.
+ #
+ # The default maximum limit can be overridden. Please follow
+ # https://cloud.google.com/monitoring/quotas
+ "name": "A String", # Optional. The resource name of the monitored resource descriptor:
+ # `"projects/{project_id}/monitoredResourceDescriptors/{type}"` where
+ # {type} is the value of the `type` field in this object and
+ # {project_id} is a project ID that provides API-specific context for
+ # accessing the type. APIs that do not use project information can use the
+ # resource name format `"monitoredResourceDescriptors/{type}"`.
+ "launchStage": "A String", # Optional. The launch stage of the monitored resource definition.
+ "displayName": "A String", # Optional. A concise name for the monitored resource type that might be
+ # displayed in user interfaces. It should be a Title Cased Noun Phrase,
+ # without any article or other determiners. For example,
+ # `"Google Cloud SQL Database"`.
+ "labels": [ # Required. A set of labels used to describe instances of this monitored
+ # resource type.
+ # The label key name must follow:
+ #
+ # * Only upper and lower-case letters, digits and underscores (_) are
+ # allowed.
+ # * Label name must start with a letter or digit.
+ # * The maximum length of a label name is 100 characters.
+ #
+ # For example, an individual Google Cloud SQL database is
+ # identified by values for the labels `database_id` and `location`.
+ { # A description of a label.
+ "valueType": "A String", # The type of data that can be assigned to the label.
+ "description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
+ },
+ ],
+ "description": "A String", # Optional. A detailed description of the monitored resource type that might
+ # be used in documentation.
+ "type": "A String", # Required. The monitored resource type. For example, the type
+ # `cloudsql_database` represents databases in Google Cloud SQL.
+ #
+ # All service defined monitored resource types must be prefixed with the
+ # service name, in the format of `{service name}/{relative resource name}`.
+ # The relative resource name must follow:
+ #
+ # * Only upper and lower-case letters and digits are allowed.
+ # * It must start with upper case character and is recommended to use Upper
+ # Camel Case style.
+ # * The maximum number of characters allowed for the relative_resource_name
+ # is 100.
+ #
+ # Note there are legacy service monitored resources not following this rule.
+ },
+ ],
"context": { # `Context` defines which contexts an API requests. # Context configuration.
#
# Example:
@@ -1882,14 +2030,6 @@
# **NOTE:** All service configuration rules follow "last one wins" order.
{ # A context rule provides information about the context for an individual API
# element.
- "allowedRequestExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
- # side channel from client to backend.
- "A String",
- ],
- "allowedResponseExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
- # side channel from backend to client.
- "A String",
- ],
"selector": "A String", # Selects the methods to which this rule applies.
#
# Refer to selector for syntax details.
@@ -1899,73 +2039,14 @@
"provided": [ # A list of full type names of provided contexts.
"A String",
],
- },
- ],
- },
- "producerProjectId": "A String", # The Google project that owns this service.
- "backend": { # `Backend` defines the backend configuration for a service. # API backend configuration.
- "rules": [ # A list of API backend rules that apply to individual API methods.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A backend rule provides configuration for an individual API element.
- "operationDeadline": 3.14, # The number of seconds to wait for the completion of a long running
- # operation. The default is no deadline.
- "minDeadline": 3.14, # Minimum deadline in seconds needed for this method. Calls having deadline
- # value lower than this will be rejected.
- "address": "A String", # The address of the API backend.
- #
- # The scheme is used to determine the backend protocol and security.
- # The following schemes are accepted:
- #
- # SCHEME PROTOCOL SECURITY
- # http:// HTTP None
- # https:// HTTP TLS
- # grpc:// gRPC None
- # grpcs:// gRPC TLS
- #
- # It is recommended to explicitly include a scheme. Leaving out the scheme
- # may cause constrasting behaviors across platforms.
- #
- # If the port is unspecified, the default is:
- # - 80 for schemes without TLS
- # - 443 for schemes with TLS
- #
- # For HTTP backends, use protocol
- # to specify the protocol version.
- "pathTranslation": "A String",
- "selector": "A String", # Selects the methods to which this rule applies.
- #
- # Refer to selector for syntax details.
- "jwtAudience": "A String", # The JWT audience is used when generating a JWT ID token for the backend.
- # This ID token will be added in the HTTP "authorization" header, and sent
- # to the backend.
- "disableAuth": True or False, # When disable_auth is true, a JWT ID token won't be generated and the
- # original "Authorization" HTTP header will be preserved. If the header is
- # used to carry the original token and is expected by the backend, this
- # field must be set to true to preserve the header.
- "deadline": 3.14, # The number of seconds to wait for a response from a request. The default
- # varies based on the request protocol and deployment environment.
- "protocol": "A String", # The protocol used for sending a request to the backend.
- # The supported values are "http/1.1" and "h2".
- #
- # The default value is inferred from the scheme in the
- # address field:
- #
- # SCHEME PROTOCOL
- # http:// http/1.1
- # https:// http/1.1
- # grpc:// h2
- # grpcs:// h2
- #
- # For secure HTTP backends (https://) that support HTTP/2, set this field
- # to "h2" for improved performance.
- #
- # Configuring this field to non-default values is only supported for secure
- # HTTP backends. This field will be ignored for all other backends.
- #
- # See
- # https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
- # for more details on the supported values.
+ "allowedRequestExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
+ # side channel from client to backend.
+ "A String",
+ ],
+ "allowedResponseExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
+ # side channel from backend to client.
+ "A String",
+ ],
},
],
},
@@ -2002,273 +2083,6 @@
# - selector: "*"
# requirements:
# provider_id: google_calendar_auth
- "control": { # Selects and configures the service controller used by the service. The # Configuration for the service control plane.
- # service controller handles features like abuse, quota, billing, logging,
- # monitoring, etc.
- "environment": "A String", # The service control environment to use. If empty, no control plane
- # feature (like quota and billing) will be enabled.
- },
- "types": [ # A list of all proto message types included in this API service.
- # Types referenced directly or indirectly by the `apis` are
- # automatically included. Messages which are not referenced but
- # shall be included, such as types used by the `google.protobuf.Any` type,
- # should be listed here by name. Example:
- #
- # types:
- # - name: google.protobuf.Int32
- { # A protocol buffer message type.
- "fields": [ # The list of fields.
- { # A single field of a message type.
- "number": 42, # The field number.
- "name": "A String", # The field name.
- "kind": "A String", # The field type.
- "jsonName": "A String", # The field JSON name.
- "cardinality": "A String", # The field cardinality.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
- "packed": True or False, # Whether to use alternative packed wire representation.
- "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
- # types. The first type has index 1; zero means the type is not in the list.
- "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
- # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
- },
- ],
- "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
- "A String",
- ],
- "name": "A String", # The fully qualified message name.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax.
- "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- },
- ],
- "sourceInfo": { # Source information used to create a Service Config # Output only. The source information for this configuration if available.
- "sourceFiles": [ # All files used during config generation.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
- },
- "name": "A String", # The service name, which is a DNS-like logical identifier for the
- # service, such as `calendar.googleapis.com`. The service name
- # typically goes through DNS verification to make sure the owner
- # of the service also owns the DNS name.
- "title": "A String", # The product title for this service.
- "logs": [ # Defines the logs used by this service.
- { # A description of a log type. Example in YAML format:
- #
- # - name: library.googleapis.com/activity_history
- # description: The history of borrowing and returning library items.
- # display_name: Activity
- # labels:
- # - key: /customer_id
- # description: Identifier of a library customer
- "labels": [ # The set of labels that are available to describe a specific log entry.
- # Runtime requests that contain labels not specified here are
- # considered invalid.
- { # A description of a label.
- "valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
- "description": "A String", # A human-readable description for the label.
- },
- ],
- "description": "A String", # A human-readable description of this log. This information appears in
- # the documentation and can contain details.
- "displayName": "A String", # The human-readable name for this log. This information appears on
- # the user interface and should be concise.
- "name": "A String", # The name of the log. It must be less than 512 characters long and can
- # include the following characters: upper- and lower-case alphanumeric
- # characters [A-Za-z0-9], and punctuation characters including
- # slash, underscore, hyphen, period [/_-.].
- },
- ],
- "metrics": [ # Defines the metrics used by this service.
- { # 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.
- "type": "A String", # 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` or `external.googleapis.com`. Metric types should
- # use a natural hierarchical grouping. For example:
- #
- # "custom.googleapis.com/invoice/paid/amount"
- # "external.googleapis.com/prometheus/up"
- # "appengine.googleapis.com/http/server/response_latencies"
- "labels": [ # 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.
- { # A description of a label.
- "valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
- "description": "A String", # A human-readable description for the label.
- },
- ],
- "description": "A String", # A detailed description of the metric, which can be used in documentation.
- "monitoredResourceTypes": [ # Read-only. If present, then a time
- # series, which is identified partially by
- # a metric type and a MonitoredResourceDescriptor, that is associated
- # with this metric type can only be associated with one of the monitored
- # resource types listed here.
- "A String",
- ],
- "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
- # Use sentence case without an ending period, for example "Request count".
- # This field is optional but it is recommended to be set for any metrics
- # associated with user-visible concepts, such as Quota.
- "metadata": { # Additional annotations that can be used to guide the usage of a metric. # Optional. Metadata which can be used to guide usage of the metric.
- "launchStage": "A String", # Deprecated. Must use the MetricDescriptor.launch_stage instead.
- "ingestDelay": "A String", # The delay of data points caused by ingestion. Data points older than this
- # age are guaranteed to be ingested and available to be read, excluding
- # data loss due to errors.
- "samplePeriod": "A String", # The sampling period of metric data points. For metrics which are written
- # periodically, consecutive data points are stored at this time interval,
- # excluding data loss due to errors. Metrics with a higher granularity have
- # a smaller sampling period.
- },
- "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc.
- # Some combinations of `metric_kind` and `value_type` might not be supported.
- "unit": "A String", # The units in which the metric value is reported. It is only applicable
- # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit`
- # defines the representation of the stored metric values.
- #
- # Different systems may scale the values to be more easily displayed (so a
- # value of `0.02KBy` _might_ be displayed as `20By`, and a value of
- # `3523KBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is
- # `KBy`, then the value of the metric is always in thousands of bytes, no
- # matter how it may be displayed..
- #
- # If you want a custom metric to record the exact number of CPU-seconds used
- # by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is
- # `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005
- # CPU-seconds, then the value is written as `12005`.
- #
- # Alternatively, if you want a custom metric to record data in a more
- # granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
- # `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`),
- # or use `Kis{CPU}` and write `11.723` (which is `12005/1024`).
- #
- # The supported units are a subset of [The Unified Code for Units of
- # Measure](http://unitsofmeasure.org/ucum.html) standard:
- #
- # **Basic units (UNIT)**
- #
- # * `bit` bit
- # * `By` byte
- # * `s` second
- # * `min` minute
- # * `h` hour
- # * `d` day
- #
- # **Prefixes (PREFIX)**
- #
- # * `k` kilo (10^3)
- # * `M` mega (10^6)
- # * `G` giga (10^9)
- # * `T` tera (10^12)
- # * `P` peta (10^15)
- # * `E` exa (10^18)
- # * `Z` zetta (10^21)
- # * `Y` yotta (10^24)
- #
- # * `m` milli (10^-3)
- # * `u` micro (10^-6)
- # * `n` nano (10^-9)
- # * `p` pico (10^-12)
- # * `f` femto (10^-15)
- # * `a` atto (10^-18)
- # * `z` zepto (10^-21)
- # * `y` yocto (10^-24)
- #
- # * `Ki` kibi (2^10)
- # * `Mi` mebi (2^20)
- # * `Gi` gibi (2^30)
- # * `Ti` tebi (2^40)
- # * `Pi` pebi (2^50)
- #
- # **Grammar**
- #
- # The grammar also includes these connectors:
- #
- # * `/` division or ratio (as an infix operator). For examples,
- # `kBy/{email}` or `MiBy/10ms` (although you should almost never
- # have `/s` in a metric `unit`; rates should always be computed at
- # query time from the underlying cumulative or delta value).
- # * `.` multiplication or composition (as an infix operator). For
- # examples, `GBy.d` or `k{watt}.h`.
- #
- # The grammar for a unit is as follows:
- #
- # Expression = Component { "." Component } { "/" Component } ;
- #
- # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
- # | Annotation
- # | "1"
- # ;
- #
- # Annotation = "{" NAME "}" ;
- #
- # Notes:
- #
- # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
- # is used alone, then the unit is equivalent to `1`. For examples,
- # `{request}/s == 1/s`, `By{transmitted}/s == By/s`.
- # * `NAME` is a sequence of non-blank printable ASCII characters not
- # containing `{` or `}`.
- # * `1` represents a unitary [dimensionless
- # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
- # as in `1/s`. It is typically used when none of the basic units are
- # appropriate. For example, "new users per day" can be represented as
- # `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new
- # users). Alternatively, "thousands of page views per day" would be
- # represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric
- # value of `5.3` would mean "5300 page views per day").
- # * `%` represents dimensionless value of 1/100, and annotates values giving
- # a percentage (so the metric values are typically in the range of 0..100,
- # and a metric value `3` means "3 percent").
- # * `10^2.%` indicates a metric contains a ratio, typically in the range
- # 0..1, that will be multiplied by 100 and displayed as a percentage
- # (so a metric value `0.03` means "3 percent").
- "launchStage": "A String", # Optional. The launch stage of the metric definition.
- "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
- # Some combinations of `metric_kind` and `value_type` might not be supported.
- "name": "A String", # The resource name of the metric descriptor.
- },
- ],
"enums": [ # A list of all enum types included in this API service. Enums
# referenced directly or indirectly by the `apis` are automatically
# included. Enums which are not referenced but shall be included
@@ -2280,530 +2094,414 @@
"options": [ # Protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
- "name": "A String", # Enum type name.
- "syntax": "A String", # The source syntax.
+ "enumvalue": [ # Enum value definitions.
+ { # Enum value definition.
+ "name": "A String", # Enum value name.
+ "options": [ # Protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "number": 42, # Enum value number.
+ },
+ ],
"sourceContext": { # `SourceContext` represents information about the source of a # The source context.
# protobuf element, like the file in which it is defined.
"fileName": "A String", # The path-qualified name of the .proto file that contained the associated
# protobuf element. For example: `"google/protobuf/source_context.proto"`.
},
- "enumvalue": [ # Enum value definitions.
- { # Enum value definition.
- "name": "A String", # Enum value name.
- "number": 42, # Enum value number.
- "options": [ # Protocol buffer options.
+ "name": "A String", # Enum type name.
+ "syntax": "A String", # The source syntax.
+ },
+ ],
+ "backend": { # `Backend` defines the backend configuration for a service. # API backend configuration.
+ "rules": [ # A list of API backend rules that apply to individual API methods.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # A backend rule provides configuration for an individual API element.
+ "disableAuth": True or False, # When disable_auth is true, a JWT ID token won't be generated and the
+ # original "Authorization" HTTP header will be preserved. If the header is
+ # used to carry the original token and is expected by the backend, this
+ # field must be set to true to preserve the header.
+ "address": "A String", # The address of the API backend.
+ #
+ # The scheme is used to determine the backend protocol and security.
+ # The following schemes are accepted:
+ #
+ # SCHEME PROTOCOL SECURITY
+ # http:// HTTP None
+ # https:// HTTP TLS
+ # grpc:// gRPC None
+ # grpcs:// gRPC TLS
+ #
+ # It is recommended to explicitly include a scheme. Leaving out the scheme
+ # may cause constrasting behaviors across platforms.
+ #
+ # If the port is unspecified, the default is:
+ # - 80 for schemes without TLS
+ # - 443 for schemes with TLS
+ #
+ # For HTTP backends, use protocol
+ # to specify the protocol version.
+ "minDeadline": 3.14, # Minimum deadline in seconds needed for this method. Calls having deadline
+ # value lower than this will be rejected.
+ "selector": "A String", # Selects the methods to which this rule applies.
+ #
+ # Refer to selector for syntax details.
+ "protocol": "A String", # The protocol used for sending a request to the backend.
+ # The supported values are "http/1.1" and "h2".
+ #
+ # The default value is inferred from the scheme in the
+ # address field:
+ #
+ # SCHEME PROTOCOL
+ # http:// http/1.1
+ # https:// http/1.1
+ # grpc:// h2
+ # grpcs:// h2
+ #
+ # For secure HTTP backends (https://) that support HTTP/2, set this field
+ # to "h2" for improved performance.
+ #
+ # Configuring this field to non-default values is only supported for secure
+ # HTTP backends. This field will be ignored for all other backends.
+ #
+ # See
+ # https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
+ # for more details on the supported values.
+ "operationDeadline": 3.14, # The number of seconds to wait for the completion of a long running
+ # operation. The default is no deadline.
+ "pathTranslation": "A String",
+ "jwtAudience": "A String", # The JWT audience is used when generating a JWT ID token for the backend.
+ # This ID token will be added in the HTTP "authorization" header, and sent
+ # to the backend.
+ "deadline": 3.14, # The number of seconds to wait for a response from a request. The default
+ # varies based on the request protocol and deployment environment.
+ },
+ ],
+ },
+ "systemTypes": [ # 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.
+ { # A protocol buffer message type.
+ "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
+ "A String",
+ ],
+ "fields": [ # The list of fields.
+ { # A single field of a message type.
+ "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
+ # types. The first type has index 1; zero means the type is not in the list.
+ "name": "A String", # The field name.
+ "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
+ "packed": True or False, # Whether to use alternative packed wire representation.
+ "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
+ # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
+ "cardinality": "A String", # The field cardinality.
+ "jsonName": "A String", # The field JSON name.
+ "kind": "A String", # The field type.
+ "options": [ # The protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
+ "number": 42, # The field number.
},
],
- },
- ],
- "authentication": { # `Authentication` defines the authentication configuration for an API. # Auth configuration.
- #
- # Example for an API targeted for external use:
- #
- # name: calendar.googleapis.com
- # authentication:
- # providers:
- # - id: google_calendar_auth
- # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
- # issuer: https://securetoken.google.com
- # rules:
- # - selector: "*"
- # requirements:
- # provider_id: google_calendar_auth
- "rules": [ # A list of authentication rules that apply to individual API methods.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # Authentication rules for the service.
- #
- # By default, if a method has any authentication requirements, every request
- # must include a valid credential matching one of the requirements.
- # It's an error to include more than one kind of credential in a single
- # request.
- #
- # If a method doesn't have any auth requirements, request credentials will be
- # ignored.
- "oauth": { # OAuth scopes are a way to define data and permissions on data. For example, # The requirements for OAuth credentials.
- # there are scopes defined for "Read-only access to Google Calendar" and
- # "Access to Cloud Platform". Users can consent to a scope for an application,
- # giving it permission to access that data on their behalf.
- #
- # OAuth scope specifications should be fairly coarse grained; a user will need
- # to see and understand the text description of what your scope means.
- #
- # In most cases: use one or at most two OAuth scopes for an entire family of
- # products. If your product has multiple APIs, you should probably be sharing
- # the OAuth scope across all of those APIs.
- #
- # When you need finer grained OAuth consent screens: talk with your product
- # management about how developers will use them in practice.
- #
- # Please note that even though each of the canonical scopes is enough for a
- # request to be accepted and passed to the backend, a request can still fail
- # due to the backend requiring additional scopes or permissions.
- "canonicalScopes": "A String", # The list of publicly documented OAuth scopes that are allowed access. An
- # OAuth token containing any of these scopes will be accepted.
- #
- # Example:
- #
- # canonical_scopes: https://www.googleapis.com/auth/calendar,
- # https://www.googleapis.com/auth/calendar.read
- },
- "requirements": [ # Requirements for additional authentication providers.
- { # User-defined authentication requirements, including support for
- # [JSON Web Token
- # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
- "audiences": "A String", # 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:
- #
- # audiences: bookstore_android.apps.googleusercontent.com,
- # bookstore_web.apps.googleusercontent.com
- "providerId": "A String", # id from authentication provider.
- #
- # Example:
- #
- # provider_id: bookstore_auth
- },
- ],
- "allowWithoutCredential": True or False, # If true, the service accepts API keys without any other credential.
- "selector": "A String", # Selects the methods to which this rule applies.
- #
- # Refer to selector for syntax details.
- },
- ],
- "providers": [ # Defines a set of authentication providers that a service supports.
- { # Configuration for an authentication provider, including support for
- # [JSON Web Token
- # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
- "audiences": "A String", # 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, JWTs with audiences:
- # - "https://[service.name]/[google.protobuf.Api.name]"
- # - "https://[service.name]/"
- # will be accepted.
- # For example, if no audiences are in the setting, LibraryService API will
- # accept JWTs with the following audiences:
- # -
- # https://library-example.googleapis.com/google.example.library.v1.LibraryService
- # - https://library-example.googleapis.com/
- #
- # Example:
- #
- # audiences: bookstore_android.apps.googleusercontent.com,
- # bookstore_web.apps.googleusercontent.com
- "jwtLocations": [ # Defines the locations to extract the JWT.
- #
- # JWT locations can be either from HTTP headers or URL query parameters.
- # The rule is that the first match wins. The checking order is: checking
- # all headers first, then URL query parameters.
- #
- # If not specified, default to use following 3 locations:
- # 1) Authorization: Bearer
- # 2) x-goog-iap-jwt-assertion
- # 3) access_token query parameter
- #
- # Default locations can be specified as followings:
- # jwt_locations:
- # - header: Authorization
- # value_prefix: "Bearer "
- # - header: x-goog-iap-jwt-assertion
- # - query: access_token
- { # Specifies a location to extract JWT from an API request.
- "query": "A String", # Specifies URL query parameter name to extract JWT token.
- "header": "A String", # Specifies HTTP header name to extract JWT token.
- "valuePrefix": "A String", # The value prefix. The value format is "value_prefix{token}"
- # Only applies to "in" header type. Must be empty for "in" query type.
- # If not empty, the header value has to match (case sensitive) this prefix.
- # If not matched, JWT will not be extracted. If matched, JWT will be
- # extracted after the prefix is removed.
- #
- # For example, for "Authorization: Bearer {JWT}",
- # value_prefix="Bearer " with a space at the end.
- },
- ],
- "issuer": "A String", # 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.
- #
- # Example: https://securetoken.google.com
- # Example: 1234567-compute@developer.gserviceaccount.com
- "id": "A String", # The unique identifier of the auth provider. It will be referred to by
- # `AuthRequirement.provider_id`.
- #
- # Example: "bookstore_auth".
- "jwksUri": "A String", # URL of the provider's public key set to validate signature of the JWT. See
- # [OpenID
- # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).
- # Optional if the key set document:
- # - can be retrieved from
- # [OpenID
- # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
- # the issuer.
- # - can be inferred from the email domain of the issuer (e.g. a Google
- # service account).
- #
- # Example: https://www.googleapis.com/oauth2/v1/certs
- "authorizationUrl": "A String", # Redirect URL if JWT token is required but not present or is expired.
- # Implement authorizationUrl of securityDefinitions in OpenAPI spec.
- },
- ],
- },
- "documentation": { # `Documentation` provides the information for describing a service. # Additional API documentation.
- #
- # Example:
- # <pre><code>documentation:
- # summary: >
- # The Google Calendar API gives access
- # to most calendar features.
- # pages:
- # - name: Overview
- # content: &#40;== include google/foo/overview.md ==&#41;
- # - name: Tutorial
- # content: &#40;== include google/foo/tutorial.md ==&#41;
- # subpages;
- # - name: Java
- # content: &#40;== include google/foo/tutorial_java.md ==&#41;
- # rules:
- # - selector: google.calendar.Calendar.Get
- # description: >
- # ...
- # - selector: google.calendar.Calendar.Put
- # description: >
- # ...
- # </code></pre>
- # Documentation is provided in markdown syntax. In addition to
- # standard markdown features, definition lists, tables and fenced
- # code blocks are supported. Section headers can be provided and are
- # interpreted relative to the section nesting of the context where
- # a documentation fragment is embedded.
- #
- # Documentation from the IDL is merged with documentation defined
- # via the config at normalization time, where documentation provided
- # by config rules overrides IDL provided.
- #
- # A number of constructs specific to the API platform are supported
- # in documentation text.
- #
- # In order to reference a proto element, the following
- # notation can be used:
- # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
- # To override the display text used for the link, this can be used:
- # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
- # Text can be excluded from doc using the following notation:
- # <pre><code>&#40;-- internal comment --&#41;</code></pre>
- #
- # A few directives are available in documentation. Note that
- # directives must appear on a single line to be properly
- # identified. The `include` directive includes a markdown file from
- # an external source:
- # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
- # The `resource_for` directive marks a message to be the resource of
- # a collection in REST view. If it is not specified, tools attempt
- # to infer the resource from the operations in a collection:
- # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
- # The directive `suppress_warning` does not directly affect documentation
- # and is documented together with service config validation.
- "documentationRootUrl": "A String", # The URL to the root of documentation.
- "serviceRootUrl": "A String", # Specifies the service root url if the default one (the service name
- # from the yaml file) is not suitable. This can be seen in any fully
- # specified service urls as well as sections that show a base that other
- # urls are relative to.
- "rules": [ # A list of documentation rules that apply to individual API elements.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A documentation rule provides information about individual API elements.
- "description": "A String", # Description of the selected API(s).
- "deprecationDescription": "A String", # Deprecation description of the selected element(s). It can be provided if
- # an element is marked as `deprecated`.
- "selector": "A String", # The selector is a comma-separated list of patterns. Each pattern is a
- # qualified name of the element which may end in "*", indicating a wildcard.
- # Wildcards are only allowed at the end and for a whole component of the
- # qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A
- # wildcard will match one or more components. To specify a default for all
- # applicable elements, the whole pattern "*" is used.
- },
- ],
- "pages": [ # The top level pages for the documentation set.
- { # Represents a documentation page. A page can contain subpages to represent
- # nested documentation set structure.
- "name": "A String", # The name of the page. It will be used as an identity of the page to
- # generate URI of the page, text of the link to this page in navigation,
- # etc. The full page name (start from the root page name to this page
- # concatenated with `.`) can be used as reference to the page in your
- # documentation. For example:
- # <pre><code>pages:
- # - name: Tutorial
- # content: &#40;== include tutorial.md ==&#41;
- # subpages:
- # - name: Java
- # content: &#40;== include tutorial_java.md ==&#41;
- # </code></pre>
- # You can reference `Java` page using Markdown reference link syntax:
- # `Java`.
- "subpages": [ # Subpages of this page. The order of subpages specified here will be
- # honored in the generated docset.
- # Object with schema name: Page
- ],
- "content": "A String", # The Markdown content of the page. You can use <code>&#40;== include {path}
- # ==&#41;</code> to include content from a Markdown file.
- },
- ],
- "summary": "A String", # A short summary of what the service does. Can only be provided by
- # plain text.
- "overview": "A String", # Declares a single overview page. For example:
- # <pre><code>documentation:
- # summary: ...
- # overview: &#40;== include overview.md ==&#41;
- # </code></pre>
- # This is a shortcut for the following declaration (using pages style):
- # <pre><code>documentation:
- # summary: ...
- # pages:
- # - name: Overview
- # content: &#40;== include overview.md ==&#41;
- # </code></pre>
- # Note: you cannot specify both `overview` field and `pages` field.
- },
- "apis": [ # 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.
- { # Api is a light-weight descriptor for an API Interface.
- #
- # Interfaces are also described as "protocol buffer services" in some contexts,
- # such as by the "service" keyword in a .proto file, but they are different
- # from API Services, which represent a concrete implementation of an interface
- # as opposed to simply a description of methods and bindings. They are also
- # sometimes simply referred to as "APIs" in other contexts, such as the name of
- # this message itself. See https://cloud.google.com/apis/design/glossary for
- # detailed terminology.
- "options": [ # Any metadata attached to the interface.
+ "options": [ # The protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
- "syntax": "A String", # The source syntax of the service.
- "sourceContext": { # `SourceContext` represents information about the source of a # Source context for the protocol buffer service represented by this
- # message.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- "mixins": [ # Included interfaces. See Mixin.
- { # Declares an API Interface to be included in this interface. The including
- # interface must redeclare all the methods from the included interface, but
- # documentation and options are inherited as follows:
- #
- # - If after comment and whitespace stripping, the documentation
- # string of the redeclared method is empty, it will be inherited
- # from the original method.
- #
- # - Each annotation belonging to the service config (http,
- # visibility) which is not set in the redeclared method will be
- # inherited.
- #
- # - If an http annotation is inherited, the path pattern will be
- # modified as follows. Any version prefix will be replaced by the
- # version of the including interface plus the root path if
- # specified.
- #
- # Example of a simple mixin:
- #
- # package google.acl.v1;
- # service AccessControl {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v1/{resource=**}:getAcl";
- # }
- # }
- #
- # package google.storage.v2;
- # service Storage {
- # // rpc GetAcl(GetAclRequest) returns (Acl);
- #
- # // Get a data record.
- # rpc GetData(GetDataRequest) returns (Data) {
- # option (google.api.http).get = "/v2/{resource=**}";
- # }
- # }
- #
- # Example of a mixin configuration:
- #
- # apis:
- # - name: google.storage.v2.Storage
- # mixins:
- # - name: google.acl.v1.AccessControl
- #
- # The mixin construct implies that all methods in `AccessControl` are
- # also declared with same name and request/response types in
- # `Storage`. A documentation generator or annotation processor will
- # see the effective `Storage.GetAcl` method after inherting
- # documentation and annotations as follows:
- #
- # service Storage {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v2/{resource=**}:getAcl";
- # }
- # ...
- # }
- #
- # Note how the version in the path pattern changed from `v1` to `v2`.
- #
- # If the `root` field in the mixin is specified, it should be a
- # relative path under which inherited HTTP paths are placed. Example:
- #
- # apis:
- # - name: google.storage.v2.Storage
- # mixins:
- # - name: google.acl.v1.AccessControl
- # root: acls
- #
- # This implies the following inherited HTTP annotation:
- #
- # service Storage {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v2/acls/{resource=**}:getAcl";
- # }
- # ...
- # }
- "name": "A String", # The fully qualified name of the interface which is included.
- "root": "A String", # If non-empty specifies a path under which inherited HTTP paths
- # are rooted.
- },
- ],
- "version": "A String", # A version string for this interface. If specified, must have the form
- # `major-version.minor-version`, as in `1.10`. If the minor version is
- # omitted, it defaults to zero. If the entire version field is empty, the
- # major version is derived from the package name, as outlined below. If the
- # field is not empty, the version in the package name will be verified to be
- # consistent with what is provided here.
- #
- # The versioning schema uses [semantic
- # versioning](http://semver.org) where the major version number
- # indicates a breaking change and the minor version an additive,
- # non-breaking change. Both version numbers are signals to users
- # what to expect from different versions, and should be carefully
- # chosen based on the product plan.
- #
- # The major version is also reflected in the package name of the
- # interface, which must end in `v<major-version>`, as in
- # `google.feature.v1`. For major versions 0 and 1, the suffix can
- # be omitted. Zero major versions must only be used for
- # experimental, non-GA interfaces.
- "methods": [ # The methods of this interface, in unspecified order.
- { # Method represents a method of an API interface.
- "requestTypeUrl": "A String", # A URL of the input message type.
- "name": "A String", # The simple name of this method.
- "responseStreaming": True or False, # If true, the response is streamed.
- "requestStreaming": True or False, # If true, the request is streamed.
- "options": [ # Any metadata attached to the method.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax of this method.
- "responseTypeUrl": "A String", # The URL of the output message type.
- },
- ],
- "name": "A String", # The fully qualified name of this interface, including package name
- # followed by the interface's simple name.
+ "syntax": "A String", # The source syntax.
+ "name": "A String", # The fully qualified message name.
},
],
- "customError": { # Customize service error responses. For example, list any service # Custom error configuration.
- # specific protobuf types that can appear in error detail lists of
- # error responses.
- #
- # Example:
- #
- # custom_error:
- # types:
- # - google.foo.v1.CustomError
- # - google.foo.v1.AnotherError
- "types": [ # The list of custom error detail types, e.g. 'google.foo.v1.CustomError'.
- "A String",
- ],
- "rules": [ # The list of custom error rules that apply to individual API messages.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A custom error rule.
- "isErrorType": True or False, # Mark this message as possible payload in error response. Otherwise,
- # objects of this type will be filtered when they appear in error payload.
- "selector": "A String", # Selects messages to which this rule applies.
- #
- # Refer to selector for syntax details.
+ "name": "A String", # The service name, which is a DNS-like logical identifier for the
+ # service, such as `calendar.googleapis.com`. The service name
+ # typically goes through DNS verification to make sure the owner
+ # of the service also owns the DNS name.
+ "sourceInfo": { # Source information used to create a Service Config # Output only. The source information for this configuration if available.
+ "sourceFiles": [ # All files used during config generation.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
},
- "id": "A String", # A unique ID for a specific instance of this message, typically assigned
- # by the client for tracking purpose. Must be no longer than 63 characters
- # and only lower case letters, digits, '.', '_' and '-' are allowed. If
- # empty, the server may choose to generate one instead.
+ "billing": { # Billing related configuration of the service. # Billing configuration.
+ #
+ # The following example shows how to configure monitored resources and metrics
+ # for billing, `consumer_destinations` is the only supported destination and
+ # the monitored resources need at least one label key
+ # `cloud.googleapis.com/location` to indicate the location of the billing
+ # usage, using different monitored resources between monitoring and billing is
+ # recommended so they can be evolved independently:
+ #
+ #
+ # monitored_resources:
+ # - type: library.googleapis.com/billing_branch
+ # labels:
+ # - key: cloud.googleapis.com/location
+ # description: |
+ # Predefined label to support billing location restriction.
+ # - key: city
+ # description: |
+ # Custom label to define the city where the library branch is located
+ # in.
+ # - key: name
+ # description: Custom label to define the name of the library branch.
+ # metrics:
+ # - name: library.googleapis.com/book/borrowed_count
+ # metric_kind: DELTA
+ # value_type: INT64
+ # unit: "1"
+ # billing:
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/billing_branch
+ # metrics:
+ # - library.googleapis.com/book/borrowed_count
+ "consumerDestinations": [ # Billing configurations for sending metrics to the consumer project.
+ # There can be multiple consumer destinations per service, each one must have
+ # a different monitored resource type. A metric can be used in at most
+ # one consumer destination.
+ { # Configuration of a specific billing destination (Currently only support
+ # bill against consumer project).
+ "metrics": [ # Names of the metrics to report to this billing destination.
+ # Each name must be defined in Service.metrics section.
+ "A String",
+ ],
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ },
+ ],
+ },
+ "monitoring": { # Monitoring configuration of the service. # Monitoring configuration.
+ #
+ # The example below shows how to configure monitored resources and metrics
+ # for monitoring. In the example, a monitored resource and two metrics are
+ # defined. The `library.googleapis.com/book/returned_count` metric is sent
+ # to both producer and consumer projects, whereas the
+ # `library.googleapis.com/book/num_overdue` metric is only sent to the
+ # consumer project.
+ #
+ # monitored_resources:
+ # - type: library.googleapis.com/Branch
+ # display_name: "Library Branch"
+ # description: "A branch of a library."
+ # launch_stage: GA
+ # labels:
+ # - key: resource_container
+ # description: "The Cloud container (ie. project id) for the Branch."
+ # - key: location
+ # description: "The location of the library branch."
+ # - key: branch_id
+ # description: "The id of the branch."
+ # metrics:
+ # - name: library.googleapis.com/book/returned_count
+ # display_name: "Books Returned"
+ # description: "The count of books that have been returned."
+ # launch_stage: GA
+ # metric_kind: DELTA
+ # value_type: INT64
+ # unit: "1"
+ # labels:
+ # - key: customer_id
+ # description: "The id of the customer."
+ # - name: library.googleapis.com/book/num_overdue
+ # display_name: "Books Overdue"
+ # description: "The current number of overdue books."
+ # launch_stage: GA
+ # metric_kind: GAUGE
+ # value_type: INT64
+ # unit: "1"
+ # labels:
+ # - key: customer_id
+ # description: "The id of the customer."
+ # monitoring:
+ # producer_destinations:
+ # - monitored_resource: library.googleapis.com/Branch
+ # metrics:
+ # - library.googleapis.com/book/returned_count
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/Branch
+ # metrics:
+ # - library.googleapis.com/book/returned_count
+ # - library.googleapis.com/book/num_overdue
+ "producerDestinations": [ # Monitoring configurations for sending metrics to the producer project.
+ # There can be multiple producer destinations. A monitored resource type may
+ # appear in multiple monitoring destinations if different aggregations are
+ # needed for different sets of metrics associated with that monitored
+ # resource type. A monitored resource and metric pair may only be used once
+ # in the Monitoring configuration.
+ { # Configuration of a specific monitoring destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ "metrics": [ # Types of the metrics to report to this monitoring destination.
+ # Each type must be defined in Service.metrics section.
+ "A String",
+ ],
+ },
+ ],
+ "consumerDestinations": [ # Monitoring configurations for sending metrics to the consumer project.
+ # There can be multiple consumer destinations. A monitored resource type may
+ # appear in multiple monitoring destinations if different aggregations are
+ # needed for different sets of metrics associated with that monitored
+ # resource type. A monitored resource and metric pair may only be used once
+ # in the Monitoring configuration.
+ { # Configuration of a specific monitoring destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ "metrics": [ # Types of the metrics to report to this monitoring destination.
+ # Each type must be defined in Service.metrics section.
+ "A String",
+ ],
+ },
+ ],
+ },
+ "logging": { # Logging configuration of the service. # Logging configuration.
+ #
+ # The following example shows how to configure logs to be sent to the
+ # 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: activity_history
+ # labels:
+ # - key: /customer_id
+ # - name: purchase_history
+ # logging:
+ # producer_destinations:
+ # - monitored_resource: library.googleapis.com/branch
+ # logs:
+ # - activity_history
+ # - purchase_history
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/branch
+ # logs:
+ # - activity_history
+ "producerDestinations": [ # Logging configurations for sending logs to the producer project.
+ # There can be multiple producer destinations, each one must have a
+ # different monitored resource type. A log can be used in at most
+ # one producer destination.
+ { # Configuration of a specific logging destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
+ # Service.monitored_resources section.
+ "logs": [ # Names of the logs to be sent to this destination. Each name must
+ # 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 "/".
+ "A String",
+ ],
+ },
+ ],
+ "consumerDestinations": [ # 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.
+ { # Configuration of a specific logging destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
+ # Service.monitored_resources section.
+ "logs": [ # Names of the logs to be sent to this destination. Each name must
+ # 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 "/".
+ "A String",
+ ],
+ },
+ ],
+ },
+ "control": { # Selects and configures the service controller used by the service. The # Configuration for the service control plane.
+ # service controller handles features like abuse, quota, billing, logging,
+ # monitoring, etc.
+ "environment": "A String", # The service control environment to use. If empty, no control plane
+ # feature (like quota and billing) will be enabled.
+ },
"usage": { # Configuration controlling usage of a service. # Configuration controlling usage of this service.
"requirements": [ # Requirements that must be satisfied before a consumer project can use the
# service. Each requirement is of the form <service.name>/<requirement-id>;
# for example 'serviceusage.googleapis.com/billing-enabled'.
"A String",
],
+ "serviceIdentity": { # The per-product per-project service identity for a service. # The configuration of a per-product per-project service identity.
+ #
+ #
+ # Use this field to configure per-product per-project service identity.
+ # Example of a service identity configuration.
+ #
+ # usage:
+ # service_identity:
+ # - service_account_parent: "projects/123456789"
+ # display_name: "Cloud XXX Service Agent"
+ # description: "Used as the identity of Cloud XXX to access resources"
+ "serviceAccountParent": "A String", # A service account project that hosts the service accounts.
+ #
+ # An example name would be:
+ # `projects/123456789`
+ "description": "A String", # Optional. A user-specified opaque description of the service account.
+ # Must be less than or equal to 256 UTF-8 bytes.
+ "displayName": "A String", # Optional. A user-specified name for the service account.
+ # Must be less than or equal to 100 UTF-8 bytes.
+ },
"rules": [ # A list of usage rules that apply to individual API methods.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
@@ -2832,16 +2530,16 @@
# rules:
# - selector: "google.example.library.v1.LibraryService.CreateBook"
# allow_unregistered_calls: true
+ "skipServiceControl": True or False, # If true, the selected method should skip service control and the control
+ # plane features, such as quota and billing, will not be available.
+ # This flag is used by Google Cloud Endpoints to bypass checks for internal
+ # methods, such as service health check methods.
"selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
# methods in all APIs.
#
# Refer to selector for syntax details.
"allowUnregisteredCalls": True or False, # If true, the selected method allows unregistered calls, e.g. calls
# that don't identify any user or application.
- "skipServiceControl": True or False, # If true, the selected method should skip service control and the control
- # plane features, such as quota and billing, will not be available.
- # This flag is used by Google Cloud Endpoints to bypass checks for internal
- # methods, such as service health check methods.
},
],
"producerNotificationChannel": "A String", # The full resource name of a channel used for sending notifications to the
@@ -2852,78 +2550,82 @@
# channel. To use Google Cloud Pub/Sub as the channel, this must be the name
# of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format
# documented in https://cloud.google.com/pubsub/docs/overview.
- "serviceIdentity": { # The per-product per-project service identity for a service. # The configuration of a per-product per-project service identity.
- #
- #
- # Use this field to configure per-product per-project service identity.
- # Example of a service identity configuration.
- #
- # usage:
- # service_identity:
- # - service_account_parent: "projects/123456789"
- # display_name: "Cloud XXX Service Agent"
- # description: "Used as the identity of Cloud XXX to access resources"
- "displayName": "A String", # Optional. A user-specified name for the service account.
- # Must be less than or equal to 100 UTF-8 bytes.
- "description": "A String", # Optional. A user-specified opaque description of the service account.
- # Must be less than or equal to 256 UTF-8 bytes.
- "serviceAccountParent": "A String", # A service account project that hosts the service accounts.
- #
- # An example name would be:
- # `projects/123456789`
- },
},
- "endpoints": [ # Configuration for network endpoints. If this is empty, then an endpoint
- # with the same name as the service is automatically generated to service all
- # defined APIs.
- { # `Endpoint` describes a network endpoint that serves a set of APIs.
- # A service may expose any number of endpoints, and all endpoints share the
- # same service configuration, such as quota configuration and monitoring
- # configuration.
- #
- # Example service configuration:
- #
- # name: library-example.googleapis.com
- # endpoints:
- # # Below entry makes 'google.example.library.v1.Library'
- # # API be served from endpoint address library-example.googleapis.com.
- # # It also allows HTTP OPTIONS calls to be passed to the backend, for
- # # it to decide whether the subsequent cross-origin request is
- # # allowed to proceed.
- # - name: library-example.googleapis.com
- # allow_cors: true
- "name": "A String", # The canonical name of this endpoint.
- "target": "A String", # The specification of an Internet routable address of API frontend that will
- # handle requests to this [API
- # Endpoint](https://cloud.google.com/apis/design/glossary). It should be
- # either a valid IPv4 address or a fully-qualified domain name. For example,
- # "8.8.8.8" or "myservice.appspot.com".
- "allowCors": True or False, # Allowing
- # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
- # cross-domain traffic, would allow the backends served from this endpoint to
- # receive and respond to HTTP OPTIONS requests. The response will be used by
- # the browser to determine whether the subsequent cross-origin request is
- # allowed to proceed.
- "features": [ # The list of features enabled on this endpoint.
+ "types": [ # A list of all proto message types included in this API service.
+ # Types referenced directly or indirectly by the `apis` are
+ # automatically included. Messages which are not referenced but
+ # shall be included, such as types used by the `google.protobuf.Any` type,
+ # should be listed here by name. Example:
+ #
+ # types:
+ # - name: google.protobuf.Int32
+ { # A protocol buffer message type.
+ "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
"A String",
],
- "aliases": [ # DEPRECATED: This field is no longer supported. Instead of using aliases,
- # please specify multiple google.api.Endpoint for each of the intended
- # aliases.
- #
- # Additional names that this endpoint will be hosted on.
- "A String",
+ "fields": [ # The list of fields.
+ { # A single field of a message type.
+ "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
+ # types. The first type has index 1; zero means the type is not in the list.
+ "name": "A String", # The field name.
+ "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
+ "packed": True or False, # Whether to use alternative packed wire representation.
+ "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
+ # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
+ "cardinality": "A String", # The field cardinality.
+ "jsonName": "A String", # The field JSON name.
+ "kind": "A String", # The field type.
+ "options": [ # The protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "number": 42, # The field number.
+ },
],
+ "options": [ # The protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "syntax": "A String", # The source syntax.
+ "name": "A String", # The fully qualified message name.
},
],
- "configVersion": 42, # The semantic version of the service configuration. The config version
- # affects the interpretation of the service configuration. For example,
- # certain features are enabled by default for certain config versions.
- #
- # The latest config version is `3`.
"http": { # Defines the HTTP configuration for an API service. It contains a list of # HTTP configuration.
# HttpRule, each specifying the mapping of an RPC method
# to one or more HTTP REST API methods.
+ "fullyDecodeReservedExpansion": True or False, # When set to true, URL path parameters will be fully URI-decoded except in
+ # cases of single segment matches in reserved expansion, where "%2F" will be
+ # left encoded.
+ #
+ # The default behavior is to not decode RFC 6570 reserved characters in multi
+ # segment matches.
"rules": [ # A list of HTTP configuration rules that apply to individual API methods.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
@@ -3196,10 +2898,29 @@
# If an API needs to use a JSON array for request or response body, it can map
# the request or response body to a repeated field. However, some gRPC
# Transcoding implementations may not support this feature.
+ "put": "A String", # Maps to HTTP PUT. Used for replacing a resource.
"selector": "A String", # Selects a method to which this rule applies.
#
# Refer to selector for syntax details.
- "put": "A String", # Maps to HTTP PUT. Used for replacing a resource.
+ "post": "A String", # Maps to HTTP POST. Used for creating a resource or performing an action.
+ "responseBody": "A String", # Optional. The name of the response field whose value is mapped to the HTTP
+ # response body. When omitted, the entire response message will be used
+ # as the HTTP response body.
+ #
+ # NOTE: The referred field must be present at the top-level of the response
+ # message type.
+ "body": "A String", # The name of the request field whose value is mapped to the HTTP request
+ # body, or `*` for mapping all request fields not captured by the path
+ # pattern to the HTTP body, or omitted for not having any HTTP request body.
+ #
+ # NOTE: the referred field must be present at the top-level of the request
+ # message type.
+ "patch": "A String", # Maps to HTTP PATCH. Used for updating a resource.
+ "additionalBindings": [ # Additional HTTP bindings for the selector. Nested bindings must
+ # not contain an `additional_bindings` field themselves (that is,
+ # the nesting may only be one level deep).
+ # Object with schema name: HttpRule
+ ],
"custom": { # A custom pattern is used for defining custom HTTP verb. # The custom pattern is used for specifying an HTTP method that is not
# included in the `pattern` field, such as HEAD, or "*" to leave the
# HTTP method unspecified for this rule. The wild-card rule is useful
@@ -3207,378 +2928,354 @@
"path": "A String", # The path matched by this custom verb.
"kind": "A String", # The name of this custom HTTP verb.
},
- "responseBody": "A String", # Optional. The name of the response field whose value is mapped to the HTTP
- # response body. When omitted, the entire response message will be used
- # as the HTTP response body.
- #
- # NOTE: The referred field must be present at the top-level of the response
- # message type.
"allowHalfDuplex": True or False, # When this flag is set to true, HTTP requests will be allowed to invoke a
# half-duplex streaming method.
- "additionalBindings": [ # Additional HTTP bindings for the selector. Nested bindings must
- # not contain an `additional_bindings` field themselves (that is,
- # the nesting may only be one level deep).
- # Object with schema name: HttpRule
- ],
- "patch": "A String", # Maps to HTTP PATCH. Used for updating a resource.
+ "delete": "A String", # Maps to HTTP DELETE. Used for deleting a resource.
"get": "A String", # Maps to HTTP GET. Used for listing and getting information about
# resources.
- "post": "A String", # Maps to HTTP POST. Used for creating a resource or performing an action.
- "body": "A String", # The name of the request field whose value is mapped to the HTTP request
- # body, or `*` for mapping all request fields not captured by the path
- # pattern to the HTTP body, or omitted for not having any HTTP request body.
- #
- # NOTE: the referred field must be present at the top-level of the request
- # message type.
- "delete": "A String", # Maps to HTTP DELETE. Used for deleting a resource.
},
],
- "fullyDecodeReservedExpansion": True or False, # When set to true, URL path parameters will be fully URI-decoded except in
- # cases of single segment matches in reserved expansion, where "%2F" will be
- # left encoded.
+ },
+ "logs": [ # Defines the logs used by this service.
+ { # A description of a log type. Example in YAML format:
#
- # The default behavior is to not decode RFC 6570 reserved characters in multi
- # segment matches.
- },
- "billing": { # Billing related configuration of the service. # Billing configuration.
- #
- # The following example shows how to configure monitored resources and metrics
- # for billing, `consumer_destinations` is the only supported destination and
- # the monitored resources need at least one label key
- # `cloud.googleapis.com/location` to indicate the location of the billing
- # usage, using different monitored resources between monitoring and billing is
- # recommended so they can be evolved independently:
- #
- #
- # monitored_resources:
- # - type: library.googleapis.com/billing_branch
- # labels:
- # - key: cloud.googleapis.com/location
- # description: |
- # Predefined label to support billing location restriction.
- # - key: city
- # description: |
- # Custom label to define the city where the library branch is located
- # in.
- # - key: name
- # description: Custom label to define the name of the library branch.
- # metrics:
- # - name: library.googleapis.com/book/borrowed_count
- # metric_kind: DELTA
- # value_type: INT64
- # unit: "1"
- # billing:
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/billing_branch
- # metrics:
- # - library.googleapis.com/book/borrowed_count
- "consumerDestinations": [ # Billing configurations for sending metrics to the consumer project.
- # There can be multiple consumer destinations per service, each one must have
- # a different monitored resource type. A metric can be used in at most
- # one consumer destination.
- { # Configuration of a specific billing destination (Currently only support
- # bill against consumer project).
- "metrics": [ # Names of the metrics to report to this billing destination.
- # Each name must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
- },
- ],
- },
- "systemTypes": [ # 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.
- { # A protocol buffer message type.
- "fields": [ # The list of fields.
- { # A single field of a message type.
- "number": 42, # The field number.
- "name": "A String", # The field name.
- "kind": "A String", # The field type.
- "jsonName": "A String", # The field JSON name.
- "cardinality": "A String", # The field cardinality.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
- "packed": True or False, # Whether to use alternative packed wire representation.
- "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
- # types. The first type has index 1; zero means the type is not in the list.
- "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
- # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
- },
- ],
- "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
- "A String",
- ],
- "name": "A String", # The fully qualified message name.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax.
- "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- },
- ],
- "logging": { # Logging configuration of the service. # Logging configuration.
- #
- # The following example shows how to configure logs to be sent to the
- # 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: activity_history
- # labels:
- # - key: /customer_id
- # - name: purchase_history
- # logging:
- # producer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # logs:
- # - activity_history
- # - purchase_history
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # logs:
- # - activity_history
- "consumerDestinations": [ # 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.
- { # Configuration of a specific logging destination (the producer project
- # or the consumer project).
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
- # Service.monitored_resources section.
- "logs": [ # Names of the logs to be sent to this destination. Each name must
- # 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 "/".
- "A String",
- ],
- },
- ],
- "producerDestinations": [ # Logging configurations for sending logs to the producer project.
- # There can be multiple producer destinations, each one must have a
- # different monitored resource type. A log can be used in at most
- # one producer destination.
- { # Configuration of a specific logging destination (the producer project
- # or the consumer project).
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
- # Service.monitored_resources section.
- "logs": [ # Names of the logs to be sent to this destination. Each name must
- # 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 "/".
- "A String",
- ],
- },
- ],
- },
- "monitoredResources": [ # Defines the monitored resources used by this service. This is required
- # by the Service.monitoring and Service.logging configurations.
- { # An object that describes the schema of a MonitoredResource object using a
- # type name and a set of labels. For example, the monitored resource
- # descriptor for Google Compute Engine VM instances has a type of
- # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
- # `"zone"` to identify particular VM instances.
- #
- # Different APIs can support different monitored resource types. APIs generally
- # provide a `list` method that returns the monitored resource descriptors used
- # by the API.
- "launchStage": "A String", # Optional. The launch stage of the monitored resource definition.
- "name": "A String", # Optional. The resource name of the monitored resource descriptor:
- # `"projects/{project_id}/monitoredResourceDescriptors/{type}"` where
- # {type} is the value of the `type` field in this object and
- # {project_id} is a project ID that provides API-specific context for
- # accessing the type. APIs that do not use project information can use the
- # resource name format `"monitoredResourceDescriptors/{type}"`.
- "labels": [ # Required. A set of labels used to describe instances of this monitored
- # resource type. For example, an individual Google Cloud SQL database is
- # identified by values for the labels `"database_id"` and `"zone"`.
+ # - name: library.googleapis.com/activity_history
+ # description: The history of borrowing and returning library items.
+ # display_name: Activity
+ # labels:
+ # - key: /customer_id
+ # description: Identifier of a library customer
+ "description": "A String", # A human-readable description of this log. This information appears in
+ # the documentation and can contain details.
+ "labels": [ # The set of labels that are available to describe a specific log entry.
+ # Runtime requests that contain labels not specified here are
+ # considered invalid.
{ # A description of a label.
"valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
"description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
},
],
- "type": "A String", # Required. The monitored resource type. For example, the type
- # `"cloudsql_database"` represents databases in Google Cloud SQL.
- # The maximum length of this value is 256 characters.
- "description": "A String", # Optional. A detailed description of the monitored resource type that might
- # be used in documentation.
- "displayName": "A String", # Optional. A concise name for the monitored resource type that might be
- # displayed in user interfaces. It should be a Title Cased Noun Phrase,
- # without any article or other determiners. For example,
- # `"Google Cloud SQL Database"`.
+ "displayName": "A String", # The human-readable name for this log. This information appears on
+ # the user interface and should be concise.
+ "name": "A String", # The name of the log. It must be less than 512 characters long and can
+ # include the following characters: upper- and lower-case alphanumeric
+ # characters [A-Za-z0-9], and punctuation characters including
+ # slash, underscore, hyphen, period [/_-.].
},
],
- "monitoring": { # Monitoring configuration of the service. # Monitoring configuration.
- #
- # The example below shows how to configure monitored resources and metrics
- # for monitoring. In the example, a monitored resource and two metrics are
- # defined. The `library.googleapis.com/book/returned_count` metric is sent
- # to both producer and consumer projects, whereas the
- # `library.googleapis.com/book/overdue_count` metric is only sent to the
- # consumer 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.
- # metrics:
- # - name: library.googleapis.com/book/returned_count
- # metric_kind: DELTA
- # value_type: INT64
- # labels:
- # - key: /customer_id
- # - name: library.googleapis.com/book/overdue_count
- # metric_kind: GAUGE
- # value_type: INT64
- # labels:
- # - key: /customer_id
- # monitoring:
- # producer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # metrics:
- # - library.googleapis.com/book/returned_count
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # metrics:
- # - library.googleapis.com/book/returned_count
- # - library.googleapis.com/book/overdue_count
- "producerDestinations": [ # Monitoring configurations for sending metrics to the producer project.
- # There can be multiple producer destinations. A monitored resouce type may
- # appear in multiple monitoring destinations if different aggregations are
- # needed for different sets of metrics associated with that monitored
- # resource type. A monitored resource and metric pair may only be used once
- # in the Monitoring configuration.
- { # Configuration of a specific monitoring destination (the producer project
- # or the consumer project).
- "metrics": [ # Types of the metrics to report to this monitoring destination.
- # Each type must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
+ "metrics": [ # Defines the metrics used by this service.
+ { # 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.
+ #
+ # The following are specific rules for service defined Monitoring metric
+ # descriptors:
+ #
+ # * `type`, `metric_kind`, `value_type`, `description`, and `display_name`
+ # fields are all required. The `unit` field must be specified
+ # if the `value_type` is any of DOUBLE, INT64, DISTRIBUTION.
+ # * Maximum of default 500 metric descriptors per service is allowed.
+ # * Maximum of default 10 labels per metric descriptor is allowed.
+ #
+ # The default maximum limit can be overridden. Please follow
+ # https://cloud.google.com/monitoring/quotas
+ "unit": "A String", # The units in which the metric value is reported. It is only applicable
+ # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit`
+ # defines the representation of the stored metric values.
+ #
+ # Different systems may scale the values to be more easily displayed (so a
+ # value of `0.02KBy` _might_ be displayed as `20By`, and a value of
+ # `3523KBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is
+ # `KBy`, then the value of the metric is always in thousands of bytes, no
+ # matter how it may be displayed..
+ #
+ # If you want a custom metric to record the exact number of CPU-seconds used
+ # by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is
+ # `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005
+ # CPU-seconds, then the value is written as `12005`.
+ #
+ # Alternatively, if you want a custom metric to record data in a more
+ # granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
+ # `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`),
+ # or use `Kis{CPU}` and write `11.723` (which is `12005/1024`).
+ #
+ # The supported units are a subset of [The Unified Code for Units of
+ # Measure](http://unitsofmeasure.org/ucum.html) standard:
+ #
+ # **Basic units (UNIT)**
+ #
+ # * `bit` bit
+ # * `By` byte
+ # * `s` second
+ # * `min` minute
+ # * `h` hour
+ # * `d` day
+ # * `1` dimensionless
+ #
+ # **Prefixes (PREFIX)**
+ #
+ # * `k` kilo (10^3)
+ # * `M` mega (10^6)
+ # * `G` giga (10^9)
+ # * `T` tera (10^12)
+ # * `P` peta (10^15)
+ # * `E` exa (10^18)
+ # * `Z` zetta (10^21)
+ # * `Y` yotta (10^24)
+ #
+ # * `m` milli (10^-3)
+ # * `u` micro (10^-6)
+ # * `n` nano (10^-9)
+ # * `p` pico (10^-12)
+ # * `f` femto (10^-15)
+ # * `a` atto (10^-18)
+ # * `z` zepto (10^-21)
+ # * `y` yocto (10^-24)
+ #
+ # * `Ki` kibi (2^10)
+ # * `Mi` mebi (2^20)
+ # * `Gi` gibi (2^30)
+ # * `Ti` tebi (2^40)
+ # * `Pi` pebi (2^50)
+ #
+ # **Grammar**
+ #
+ # The grammar also includes these connectors:
+ #
+ # * `/` division or ratio (as an infix operator). For examples,
+ # `kBy/{email}` or `MiBy/10ms` (although you should almost never
+ # have `/s` in a metric `unit`; rates should always be computed at
+ # query time from the underlying cumulative or delta value).
+ # * `.` multiplication or composition (as an infix operator). For
+ # examples, `GBy.d` or `k{watt}.h`.
+ #
+ # The grammar for a unit is as follows:
+ #
+ # Expression = Component { "." Component } { "/" Component } ;
+ #
+ # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
+ # | Annotation
+ # | "1"
+ # ;
+ #
+ # Annotation = "{" NAME "}" ;
+ #
+ # Notes:
+ #
+ # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
+ # is used alone, then the unit is equivalent to `1`. For examples,
+ # `{request}/s == 1/s`, `By{transmitted}/s == By/s`.
+ # * `NAME` is a sequence of non-blank printable ASCII characters not
+ # containing `{` or `}`.
+ # * `1` represents a unitary [dimensionless
+ # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
+ # as in `1/s`. It is typically used when none of the basic units are
+ # appropriate. For example, "new users per day" can be represented as
+ # `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new
+ # users). Alternatively, "thousands of page views per day" would be
+ # represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric
+ # value of `5.3` would mean "5300 page views per day").
+ # * `%` represents dimensionless value of 1/100, and annotates values giving
+ # a percentage (so the metric values are typically in the range of 0..100,
+ # and a metric value `3` means "3 percent").
+ # * `10^2.%` indicates a metric contains a ratio, typically in the range
+ # 0..1, that will be multiplied by 100 and displayed as a percentage
+ # (so a metric value `0.03` means "3 percent").
+ "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
+ # Use sentence case without an ending period, for example "Request count".
+ # This field is optional but it is recommended to be set for any metrics
+ # associated with user-visible concepts, such as Quota.
+ "monitoredResourceTypes": [ # Read-only. If present, then a time
+ # series, which is identified partially by
+ # a metric type and a MonitoredResourceDescriptor, that is associated
+ # with this metric type can only be associated with one of the monitored
+ # resource types listed here.
+ "A String",
+ ],
+ "metadata": { # Additional annotations that can be used to guide the usage of a metric. # Optional. Metadata which can be used to guide usage of the metric.
+ "samplePeriod": "A String", # The sampling period of metric data points. For metrics which are written
+ # periodically, consecutive data points are stored at this time interval,
+ # excluding data loss due to errors. Metrics with a higher granularity have
+ # a smaller sampling period.
+ "ingestDelay": "A String", # The delay of data points caused by ingestion. Data points older than this
+ # age are guaranteed to be ingested and available to be read, excluding
+ # data loss due to errors.
+ "launchStage": "A String", # Deprecated. Must use the MetricDescriptor.launch_stage instead.
},
- ],
- "consumerDestinations": [ # Monitoring configurations for sending metrics to the consumer project.
- # There can be multiple consumer destinations. A monitored resouce type may
- # appear in multiple monitoring destinations if different aggregations are
- # needed for different sets of metrics associated with that monitored
- # resource type. A monitored resource and metric pair may only be used once
- # in the Monitoring configuration.
- { # Configuration of a specific monitoring destination (the producer project
- # or the consumer project).
- "metrics": [ # Types of the metrics to report to this monitoring destination.
- # Each type must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
- },
- ],
- },
- "systemParameters": { # ### System parameter configuration # System parameter configuration.
+ "name": "A String", # The resource name of the metric descriptor.
+ "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
+ # Some combinations of `metric_kind` and `value_type` might not be supported.
+ "launchStage": "A String", # Optional. The launch stage of the metric definition.
+ "type": "A String", # The metric type, including its DNS name prefix. The type is not
+ # URL-encoded.
+ #
+ # All service defined metrics must be prefixed with the service name, in the
+ # format of `{service name}/{relative metric name}`, such as
+ # `cloudsql.googleapis.com/database/cpu/utilization`. The relative metric
+ # name must follow:
+ #
+ # * Only upper and lower-case letters, digits, '/' and underscores '_' are
+ # allowed.
+ # * The maximum number of characters allowed for the relative_metric_name is
+ # 100.
+ #
+ # All user-defined metric types have the DNS name
+ # `custom.googleapis.com`, `external.googleapis.com`, or
+ # `logging.googleapis.com/user/`.
+ #
+ # Metric types should use a natural hierarchical grouping. For example:
+ #
+ # "custom.googleapis.com/invoice/paid/amount"
+ # "external.googleapis.com/prometheus/up"
+ # "appengine.googleapis.com/http/server/response_latencies"
+ "description": "A String", # A detailed description of the metric, which can be used in documentation.
+ "labels": [ # The set of labels that can be used to describe a specific
+ # instance of this metric type.
+ #
+ # The label key name must follow:
+ #
+ # * Only upper and lower-case letters, digits and underscores (_) are
+ # allowed.
+ # * Label name must start with a letter or digit.
+ # * The maximum length of a label name is 100 characters.
+ #
+ # 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.
+ { # A description of a label.
+ "valueType": "A String", # The type of data that can be assigned to the label.
+ "description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
+ },
+ ],
+ "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc.
+ # Some combinations of `metric_kind` and `value_type` might not be supported.
+ },
+ ],
+ "documentation": { # `Documentation` provides the information for describing a service. # Additional API documentation.
#
- # A system parameter is a special kind of parameter defined by the API
- # system, not by an individual API. It is typically mapped to an HTTP header
- # and/or a URL query parameter. This configuration specifies which methods
- # change the names of the system parameters.
- "rules": [ # Define system parameters.
- #
- # The parameters defined here will override the default parameters
- # implemented by the system. If this field is missing from the service
- # config, default system parameters will be used. Default system parameters
- # and names is implementation-dependent.
- #
- # Example: define api key for all methods
- #
- # system_parameters
- # rules:
- # - selector: "*"
- # parameters:
- # - name: api_key
- # url_query_parameter: api_key
- #
- #
- # Example: define 2 api key names for a specific method.
- #
- # system_parameters
- # rules:
- # - selector: "/ListShelves"
- # parameters:
- # - name: api_key
- # http_header: Api-Key1
- # - name: api_key
- # http_header: Api-Key2
+ # Example:
+ # <pre><code>documentation:
+ # summary: >
+ # The Google Calendar API gives access
+ # to most calendar features.
+ # pages:
+ # - name: Overview
+ # content: &#40;== include google/foo/overview.md ==&#41;
+ # - name: Tutorial
+ # content: &#40;== include google/foo/tutorial.md ==&#41;
+ # subpages;
+ # - name: Java
+ # content: &#40;== include google/foo/tutorial_java.md ==&#41;
+ # rules:
+ # - selector: google.calendar.Calendar.Get
+ # description: >
+ # ...
+ # - selector: google.calendar.Calendar.Put
+ # description: >
+ # ...
+ # </code></pre>
+ # Documentation is provided in markdown syntax. In addition to
+ # standard markdown features, definition lists, tables and fenced
+ # code blocks are supported. Section headers can be provided and are
+ # interpreted relative to the section nesting of the context where
+ # a documentation fragment is embedded.
+ #
+ # Documentation from the IDL is merged with documentation defined
+ # via the config at normalization time, where documentation provided
+ # by config rules overrides IDL provided.
+ #
+ # A number of constructs specific to the API platform are supported
+ # in documentation text.
+ #
+ # In order to reference a proto element, the following
+ # notation can be used:
+ # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
+ # To override the display text used for the link, this can be used:
+ # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
+ # Text can be excluded from doc using the following notation:
+ # <pre><code>&#40;-- internal comment --&#41;</code></pre>
+ #
+ # A few directives are available in documentation. Note that
+ # directives must appear on a single line to be properly
+ # identified. The `include` directive includes a markdown file from
+ # an external source:
+ # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
+ # The `resource_for` directive marks a message to be the resource of
+ # a collection in REST view. If it is not specified, tools attempt
+ # to infer the resource from the operations in a collection:
+ # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
+ # The directive `suppress_warning` does not directly affect documentation
+ # and is documented together with service config validation.
+ "serviceRootUrl": "A String", # Specifies the service root url if the default one (the service name
+ # from the yaml file) is not suitable. This can be seen in any fully
+ # specified service urls as well as sections that show a base that other
+ # urls are relative to.
+ "overview": "A String", # Declares a single overview page. For example:
+ # <pre><code>documentation:
+ # summary: ...
+ # overview: &#40;== include overview.md ==&#41;
+ # </code></pre>
+ # This is a shortcut for the following declaration (using pages style):
+ # <pre><code>documentation:
+ # summary: ...
+ # pages:
+ # - name: Overview
+ # content: &#40;== include overview.md ==&#41;
+ # </code></pre>
+ # Note: you cannot specify both `overview` field and `pages` field.
+ "documentationRootUrl": "A String", # The URL to the root of documentation.
+ "rules": [ # A list of documentation rules that apply to individual API elements.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
- { # Define a system parameter rule mapping system parameter definitions to
- # methods.
- "parameters": [ # Define parameters. Multiple names may be defined for a parameter.
- # For a given method call, only one of them should be used. If multiple
- # names are used the behavior is implementation-dependent.
- # If none of the specified names are present the behavior is
- # parameter-dependent.
- { # Define a parameter's name and location. The parameter may be passed as either
- # an HTTP header or a URL query parameter, and if both are passed the behavior
- # is implementation-dependent.
- "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
- "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
- # sensitive.
- "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
- # insensitive.
- },
- ],
- "selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
- # methods in all APIs.
- #
- # Refer to selector for syntax details.
+ { # A documentation rule provides information about individual API elements.
+ "deprecationDescription": "A String", # Deprecation description of the selected element(s). It can be provided if
+ # an element is marked as `deprecated`.
+ "description": "A String", # Description of the selected API(s).
+ "selector": "A String", # The selector is a comma-separated list of patterns. Each pattern is a
+ # qualified name of the element which may end in "*", indicating a wildcard.
+ # Wildcards are only allowed at the end and for a whole component of the
+ # qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A
+ # wildcard will match one or more components. To specify a default for all
+ # applicable elements, the whole pattern "*" is used.
},
],
+ "pages": [ # The top level pages for the documentation set.
+ { # Represents a documentation page. A page can contain subpages to represent
+ # nested documentation set structure.
+ "content": "A String", # The Markdown content of the page. You can use <code>&#40;== include {path}
+ # ==&#41;</code> to include content from a Markdown file.
+ "name": "A String", # The name of the page. It will be used as an identity of the page to
+ # generate URI of the page, text of the link to this page in navigation,
+ # etc. The full page name (start from the root page name to this page
+ # concatenated with `.`) can be used as reference to the page in your
+ # documentation. For example:
+ # <pre><code>pages:
+ # - name: Tutorial
+ # content: &#40;== include tutorial.md ==&#41;
+ # subpages:
+ # - name: Java
+ # content: &#40;== include tutorial_java.md ==&#41;
+ # </code></pre>
+ # You can reference `Java` page using Markdown reference link syntax:
+ # `Java`.
+ "subpages": [ # Subpages of this page. The order of subpages specified here will be
+ # honored in the generated docset.
+ # Object with schema name: Page
+ ],
+ },
+ ],
+ "summary": "A String", # A short summary of what the service does. Can only be provided by
+ # plain text.
},
+ "configVersion": 42, # The semantic version of the service configuration. The config version
+ # affects the interpretation of the service configuration. For example,
+ # certain features are enabled by default for certain config versions.
+ #
+ # The latest config version is `3`.
"quota": { # Quota configuration helps to achieve fairness and budgeting in service # Quota configuration.
# usage.
#
@@ -3629,23 +3326,32 @@
# metric_kind: DELTA
# value_type: INT64
#
+ "metricRules": [ # List of `MetricRule` definitions, each one mapping a selected method to one
+ # or more metrics.
+ { # Bind API methods to metrics. Binding a method to a metric causes that
+ # metric's configured quota behaviors to apply to the method call.
+ "selector": "A String", # Selects the methods to which this rule applies.
+ #
+ # Refer to selector for syntax details.
+ "metricCosts": { # Metrics to update when the selected methods are called, and the associated
+ # cost applied to each metric.
+ #
+ # The key of the map is the metric name, and the values are the amount
+ # increased for the metric against which the quota limits are defined.
+ # The value must not be negative.
+ "a_key": "A String",
+ },
+ },
+ ],
"limits": [ # List of `QuotaLimit` definitions for the service.
{ # `QuotaLimit` defines a specific limit that applies over a specified duration
# for a limit type. There can be at most one limit for a duration and limit
# type combination defined within a `QuotaGroup`.
- "displayName": "A String", # User-visible display name for this limit.
- # Optional. If not set, the UI will provide a default display name based on
- # the quota configuration. This field can be used to override the default
- # display name generated from the configuration.
- "maxLimit": "A String", # Maximum number of tokens that can be consumed during the specified
- # duration. Client application developers can override the default limit up
- # to this maximum. If specified, this value cannot be set to a value less
- # than the default limit. If not specified, it is set to the default limit.
- #
- # To allow clients to apply overrides with no upper bound, set this to -1,
- # indicating unlimited maximum quota.
- #
- # Used by group-based quotas only.
+ "values": { # Tiered limit values. You must specify this as a key:value pair, with an
+ # integer value that is the maximum number of requests allowed for the
+ # specified unit. Currently only STANDARD is supported.
+ "a_key": "A String",
+ },
"duration": "A String", # Duration of this limit in textual notation. Must be "100s" or "1d".
#
# Used by group-based quotas only.
@@ -3657,15 +3363,13 @@
# defaults to 0, indicating that there is no free tier for this service.
#
# Used by group-based quotas only.
- "unit": "A String", # Specify the unit of the quota limit. It uses the same syntax as
- # Metric.unit. The supported unit kinds are determined by the quota
- # backend system.
- #
- # Here are some examples:
- # * "1/min/{project}" for quota per minute per project.
- #
- # Note: the order of unit components is insignificant.
- # The "1" at the beginning is required to follow the metric unit syntax.
+ "displayName": "A String", # User-visible display name for this limit.
+ # Optional. If not set, the UI will provide a default display name based on
+ # the quota configuration. This field can be used to override the default
+ # display name generated from the configuration.
+ "description": "A String", # Optional. User-visible, extended description for this quota limit.
+ # Should be used only when more context is needed to understand this limit
+ # than provided by the limit's display name (see: `display_name`).
"defaultLimit": "A String", # Default number of tokens that can be consumed during the specified
# duration. This is the number of tokens assigned when a client
# application developer activates the service for his/her project.
@@ -3676,43 +3380,568 @@
# negative values are allowed.
#
# Used by group-based quotas only.
- "values": { # Tiered limit values. You must specify this as a key:value pair, with an
- # integer value that is the maximum number of requests allowed for the
- # specified unit. Currently only STANDARD is supported.
- "a_key": "A String",
- },
"name": "A String", # Name of the quota limit.
#
# The name must be provided, and it must be unique within the service. The
# name can only include alphanumeric characters as well as '-'.
#
# The maximum length of the limit name is 64 characters.
+ "maxLimit": "A String", # Maximum number of tokens that can be consumed during the specified
+ # duration. Client application developers can override the default limit up
+ # to this maximum. If specified, this value cannot be set to a value less
+ # than the default limit. If not specified, it is set to the default limit.
+ #
+ # To allow clients to apply overrides with no upper bound, set this to -1,
+ # indicating unlimited maximum quota.
+ #
+ # Used by group-based quotas only.
"metric": "A String", # The name of the metric this quota limit applies to. The quota limits with
# the same metric will be checked together during runtime. The metric must be
# defined within the service config.
- "description": "A String", # Optional. User-visible, extended description for this quota limit.
- # Should be used only when more context is needed to understand this limit
- # than provided by the limit's display name (see: `display_name`).
+ "unit": "A String", # Specify the unit of the quota limit. It uses the same syntax as
+ # Metric.unit. The supported unit kinds are determined by the quota
+ # backend system.
+ #
+ # Here are some examples:
+ # * "1/min/{project}" for quota per minute per project.
+ #
+ # Note: the order of unit components is insignificant.
+ # The "1" at the beginning is required to follow the metric unit syntax.
},
],
- "metricRules": [ # List of `MetricRule` definitions, each one mapping a selected method to one
- # or more metrics.
- { # Bind API methods to metrics. Binding a method to a metric causes that
- # metric's configured quota behaviors to apply to the method call.
- "metricCosts": { # Metrics to update when the selected methods are called, and the associated
- # cost applied to each metric.
+ },
+ "customError": { # Customize service error responses. For example, list any service # Custom error configuration.
+ # specific protobuf types that can appear in error detail lists of
+ # error responses.
+ #
+ # Example:
+ #
+ # custom_error:
+ # types:
+ # - google.foo.v1.CustomError
+ # - google.foo.v1.AnotherError
+ "types": [ # The list of custom error detail types, e.g. 'google.foo.v1.CustomError'.
+ "A String",
+ ],
+ "rules": [ # The list of custom error rules that apply to individual API messages.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # A custom error rule.
+ "selector": "A String", # Selects messages to which this rule applies.
#
- # The key of the map is the metric name, and the values are the amount
- # increased for the metric against which the quota limits are defined.
- # The value must not be negative.
- "a_key": "A String",
+ # Refer to selector for syntax details.
+ "isErrorType": True or False, # Mark this message as possible payload in error response. Otherwise,
+ # objects of this type will be filtered when they appear in error payload.
+ },
+ ],
+ },
+ "authentication": { # `Authentication` defines the authentication configuration for an API. # Auth configuration.
+ #
+ # Example for an API targeted for external use:
+ #
+ # name: calendar.googleapis.com
+ # authentication:
+ # providers:
+ # - id: google_calendar_auth
+ # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+ # issuer: https://securetoken.google.com
+ # rules:
+ # - selector: "*"
+ # requirements:
+ # provider_id: google_calendar_auth
+ "rules": [ # A list of authentication rules that apply to individual API methods.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # Authentication rules for the service.
+ #
+ # By default, if a method has any authentication requirements, every request
+ # must include a valid credential matching one of the requirements.
+ # It's an error to include more than one kind of credential in a single
+ # request.
+ #
+ # If a method doesn't have any auth requirements, request credentials will be
+ # ignored.
+ "oauth": { # OAuth scopes are a way to define data and permissions on data. For example, # The requirements for OAuth credentials.
+ # there are scopes defined for "Read-only access to Google Calendar" and
+ # "Access to Cloud Platform". Users can consent to a scope for an application,
+ # giving it permission to access that data on their behalf.
+ #
+ # OAuth scope specifications should be fairly coarse grained; a user will need
+ # to see and understand the text description of what your scope means.
+ #
+ # In most cases: use one or at most two OAuth scopes for an entire family of
+ # products. If your product has multiple APIs, you should probably be sharing
+ # the OAuth scope across all of those APIs.
+ #
+ # When you need finer grained OAuth consent screens: talk with your product
+ # management about how developers will use them in practice.
+ #
+ # Please note that even though each of the canonical scopes is enough for a
+ # request to be accepted and passed to the backend, a request can still fail
+ # due to the backend requiring additional scopes or permissions.
+ "canonicalScopes": "A String", # The list of publicly documented OAuth scopes that are allowed access. An
+ # OAuth token containing any of these scopes will be accepted.
+ #
+ # Example:
+ #
+ # canonical_scopes: https://www.googleapis.com/auth/calendar,
+ # https://www.googleapis.com/auth/calendar.read
},
+ "requirements": [ # Requirements for additional authentication providers.
+ { # User-defined authentication requirements, including support for
+ # [JSON Web Token
+ # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
+ "providerId": "A String", # id from authentication provider.
+ #
+ # Example:
+ #
+ # provider_id: bookstore_auth
+ "audiences": "A String", # 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:
+ #
+ # audiences: bookstore_android.apps.googleusercontent.com,
+ # bookstore_web.apps.googleusercontent.com
+ },
+ ],
+ "allowWithoutCredential": True or False, # If true, the service accepts API keys without any other credential.
"selector": "A String", # Selects the methods to which this rule applies.
#
# Refer to selector for syntax details.
},
],
+ "providers": [ # Defines a set of authentication providers that a service supports.
+ { # Configuration for an authentication provider, including support for
+ # [JSON Web Token
+ # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
+ "id": "A String", # The unique identifier of the auth provider. It will be referred to by
+ # `AuthRequirement.provider_id`.
+ #
+ # Example: "bookstore_auth".
+ "issuer": "A String", # 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.
+ #
+ # Example: https://securetoken.google.com
+ # Example: 1234567-compute@developer.gserviceaccount.com
+ "jwksUri": "A String", # URL of the provider's public key set to validate signature of the JWT. See
+ # [OpenID
+ # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).
+ # Optional if the key set document:
+ # - can be retrieved from
+ # [OpenID
+ # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
+ # the issuer.
+ # - can be inferred from the email domain of the issuer (e.g. a Google
+ # service account).
+ #
+ # Example: https://www.googleapis.com/oauth2/v1/certs
+ "audiences": "A String", # 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, JWTs with audiences:
+ # - "https://[service.name]/[google.protobuf.Api.name]"
+ # - "https://[service.name]/"
+ # will be accepted.
+ # For example, if no audiences are in the setting, LibraryService API will
+ # accept JWTs with the following audiences:
+ # -
+ # https://library-example.googleapis.com/google.example.library.v1.LibraryService
+ # - https://library-example.googleapis.com/
+ #
+ # Example:
+ #
+ # audiences: bookstore_android.apps.googleusercontent.com,
+ # bookstore_web.apps.googleusercontent.com
+ "authorizationUrl": "A String", # Redirect URL if JWT token is required but not present or is expired.
+ # Implement authorizationUrl of securityDefinitions in OpenAPI spec.
+ "jwtLocations": [ # Defines the locations to extract the JWT.
+ #
+ # JWT locations can be either from HTTP headers or URL query parameters.
+ # The rule is that the first match wins. The checking order is: checking
+ # all headers first, then URL query parameters.
+ #
+ # If not specified, default to use following 3 locations:
+ # 1) Authorization: Bearer
+ # 2) x-goog-iap-jwt-assertion
+ # 3) access_token query parameter
+ #
+ # Default locations can be specified as followings:
+ # jwt_locations:
+ # - header: Authorization
+ # value_prefix: "Bearer "
+ # - header: x-goog-iap-jwt-assertion
+ # - query: access_token
+ { # Specifies a location to extract JWT from an API request.
+ "query": "A String", # Specifies URL query parameter name to extract JWT token.
+ "valuePrefix": "A String", # The value prefix. The value format is "value_prefix{token}"
+ # Only applies to "in" header type. Must be empty for "in" query type.
+ # If not empty, the header value has to match (case sensitive) this prefix.
+ # If not matched, JWT will not be extracted. If matched, JWT will be
+ # extracted after the prefix is removed.
+ #
+ # For example, for "Authorization: Bearer {JWT}",
+ # value_prefix="Bearer " with a space at the end.
+ "header": "A String", # Specifies HTTP header name to extract JWT token.
+ },
+ ],
+ },
+ ],
},
+ "title": "A String", # The product title for this service.
+ "producerProjectId": "A String", # The Google project that owns this service.
+ "apis": [ # 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.
+ { # Api is a light-weight descriptor for an API Interface.
+ #
+ # Interfaces are also described as "protocol buffer services" in some contexts,
+ # such as by the "service" keyword in a .proto file, but they are different
+ # from API Services, which represent a concrete implementation of an interface
+ # as opposed to simply a description of methods and bindings. They are also
+ # sometimes simply referred to as "APIs" in other contexts, such as the name of
+ # this message itself. See https://cloud.google.com/apis/design/glossary for
+ # detailed terminology.
+ "sourceContext": { # `SourceContext` represents information about the source of a # Source context for the protocol buffer service represented by this
+ # message.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "syntax": "A String", # The source syntax of the service.
+ "methods": [ # The methods of this interface, in unspecified order.
+ { # Method represents a method of an API interface.
+ "options": [ # Any metadata attached to the method.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "responseStreaming": True or False, # If true, the response is streamed.
+ "syntax": "A String", # The source syntax of this method.
+ "requestTypeUrl": "A String", # A URL of the input message type.
+ "name": "A String", # The simple name of this method.
+ "responseTypeUrl": "A String", # The URL of the output message type.
+ "requestStreaming": True or False, # If true, the request is streamed.
+ },
+ ],
+ "name": "A String", # The fully qualified name of this interface, including package name
+ # followed by the interface's simple name.
+ "version": "A String", # A version string for this interface. If specified, must have the form
+ # `major-version.minor-version`, as in `1.10`. If the minor version is
+ # omitted, it defaults to zero. If the entire version field is empty, the
+ # major version is derived from the package name, as outlined below. If the
+ # field is not empty, the version in the package name will be verified to be
+ # consistent with what is provided here.
+ #
+ # The versioning schema uses [semantic
+ # versioning](http://semver.org) where the major version number
+ # indicates a breaking change and the minor version an additive,
+ # non-breaking change. Both version numbers are signals to users
+ # what to expect from different versions, and should be carefully
+ # chosen based on the product plan.
+ #
+ # The major version is also reflected in the package name of the
+ # interface, which must end in `v<major-version>`, as in
+ # `google.feature.v1`. For major versions 0 and 1, the suffix can
+ # be omitted. Zero major versions must only be used for
+ # experimental, non-GA interfaces.
+ "options": [ # Any metadata attached to the interface.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "mixins": [ # Included interfaces. See Mixin.
+ { # Declares an API Interface to be included in this interface. The including
+ # interface must redeclare all the methods from the included interface, but
+ # documentation and options are inherited as follows:
+ #
+ # - If after comment and whitespace stripping, the documentation
+ # string of the redeclared method is empty, it will be inherited
+ # from the original method.
+ #
+ # - Each annotation belonging to the service config (http,
+ # visibility) which is not set in the redeclared method will be
+ # inherited.
+ #
+ # - If an http annotation is inherited, the path pattern will be
+ # modified as follows. Any version prefix will be replaced by the
+ # version of the including interface plus the root path if
+ # specified.
+ #
+ # Example of a simple mixin:
+ #
+ # package google.acl.v1;
+ # service AccessControl {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v1/{resource=**}:getAcl";
+ # }
+ # }
+ #
+ # package google.storage.v2;
+ # service Storage {
+ # // rpc GetAcl(GetAclRequest) returns (Acl);
+ #
+ # // Get a data record.
+ # rpc GetData(GetDataRequest) returns (Data) {
+ # option (google.api.http).get = "/v2/{resource=**}";
+ # }
+ # }
+ #
+ # Example of a mixin configuration:
+ #
+ # apis:
+ # - name: google.storage.v2.Storage
+ # mixins:
+ # - name: google.acl.v1.AccessControl
+ #
+ # The mixin construct implies that all methods in `AccessControl` are
+ # also declared with same name and request/response types in
+ # `Storage`. A documentation generator or annotation processor will
+ # see the effective `Storage.GetAcl` method after inherting
+ # documentation and annotations as follows:
+ #
+ # service Storage {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v2/{resource=**}:getAcl";
+ # }
+ # ...
+ # }
+ #
+ # Note how the version in the path pattern changed from `v1` to `v2`.
+ #
+ # If the `root` field in the mixin is specified, it should be a
+ # relative path under which inherited HTTP paths are placed. Example:
+ #
+ # apis:
+ # - name: google.storage.v2.Storage
+ # mixins:
+ # - name: google.acl.v1.AccessControl
+ # root: acls
+ #
+ # This implies the following inherited HTTP annotation:
+ #
+ # service Storage {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v2/acls/{resource=**}:getAcl";
+ # }
+ # ...
+ # }
+ "root": "A String", # If non-empty specifies a path under which inherited HTTP paths
+ # are rooted.
+ "name": "A String", # The fully qualified name of the interface which is included.
+ },
+ ],
+ },
+ ],
+ "id": "A String", # A unique ID for a specific instance of this message, typically assigned
+ # by the client for tracking purpose. Must be no longer than 63 characters
+ # and only lower case letters, digits, '.', '_' and '-' are allowed. If
+ # empty, the server may choose to generate one instead.
+ "endpoints": [ # Configuration for network endpoints. If this is empty, then an endpoint
+ # with the same name as the service is automatically generated to service all
+ # defined APIs.
+ { # `Endpoint` describes a network endpoint that serves a set of APIs.
+ # A service may expose any number of endpoints, and all endpoints share the
+ # same service configuration, such as quota configuration and monitoring
+ # configuration.
+ #
+ # Example service configuration:
+ #
+ # name: library-example.googleapis.com
+ # endpoints:
+ # # Below entry makes 'google.example.library.v1.Library'
+ # # API be served from endpoint address library-example.googleapis.com.
+ # # It also allows HTTP OPTIONS calls to be passed to the backend, for
+ # # it to decide whether the subsequent cross-origin request is
+ # # allowed to proceed.
+ # - name: library-example.googleapis.com
+ # allow_cors: true
+ "name": "A String", # The canonical name of this endpoint.
+ "allowCors": True or False, # Allowing
+ # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
+ # cross-domain traffic, would allow the backends served from this endpoint to
+ # receive and respond to HTTP OPTIONS requests. The response will be used by
+ # the browser to determine whether the subsequent cross-origin request is
+ # allowed to proceed.
+ "target": "A String", # The specification of an Internet routable address of API frontend that will
+ # handle requests to this [API
+ # Endpoint](https://cloud.google.com/apis/design/glossary). It should be
+ # either a valid IPv4 address or a fully-qualified domain name. For example,
+ # "8.8.8.8" or "myservice.appspot.com".
+ "aliases": [ # DEPRECATED: This field is no longer supported. Instead of using aliases,
+ # please specify multiple google.api.Endpoint for each of the intended
+ # aliases.
+ #
+ # Additional names that this endpoint will be hosted on.
+ "A String",
+ ],
+ },
+ ],
+ "systemParameters": { # ### System parameter configuration # System parameter configuration.
+ #
+ # A system parameter is a special kind of parameter defined by the API
+ # system, not by an individual API. It is typically mapped to an HTTP header
+ # and/or a URL query parameter. This configuration specifies which methods
+ # change the names of the system parameters.
+ "rules": [ # Define system parameters.
+ #
+ # The parameters defined here will override the default parameters
+ # implemented by the system. If this field is missing from the service
+ # config, default system parameters will be used. Default system parameters
+ # and names is implementation-dependent.
+ #
+ # Example: define api key for all methods
+ #
+ # system_parameters
+ # rules:
+ # - selector: "*"
+ # parameters:
+ # - name: api_key
+ # url_query_parameter: api_key
+ #
+ #
+ # Example: define 2 api key names for a specific method.
+ #
+ # system_parameters
+ # rules:
+ # - selector: "/ListShelves"
+ # parameters:
+ # - name: api_key
+ # http_header: Api-Key1
+ # - name: api_key
+ # http_header: Api-Key2
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # Define a system parameter rule mapping system parameter definitions to
+ # methods.
+ "parameters": [ # Define parameters. Multiple names may be defined for a parameter.
+ # For a given method call, only one of them should be used. If multiple
+ # names are used the behavior is implementation-dependent.
+ # If none of the specified names are present the behavior is
+ # parameter-dependent.
+ { # Define a parameter's name and location. The parameter may be passed as either
+ # an HTTP header or a URL query parameter, and if both are passed the behavior
+ # is implementation-dependent.
+ "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
+ "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
+ # insensitive.
+ "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
+ # sensitive.
+ },
+ ],
+ "selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
+ # methods in all APIs.
+ #
+ # Refer to selector for syntax details.
+ },
+ ],
+ },
+ "monitoredResources": [ # Defines the monitored resources used by this service. This is required
+ # by the Service.monitoring and Service.logging configurations.
+ { # An object that describes the schema of a MonitoredResource object using a
+ # type name and a set of labels. For example, the monitored resource
+ # descriptor for Google Compute Engine VM instances has a type of
+ # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
+ # `"zone"` to identify particular VM instances.
+ #
+ # Different services can support different monitored resource types.
+ #
+ # The following are specific rules to service defined monitored resources for
+ # Monitoring and Logging:
+ #
+ # * The `type`, `display_name`, `description`, `labels` and `launch_stage`
+ # fields are all required.
+ # * The first label of the monitored resource descriptor must be
+ # `resource_container`. There are legacy monitored resource descritptors
+ # start with `project_id`.
+ # * It must include a `location` label.
+ # * Maximum of default 5 service defined monitored resource descriptors
+ # is allowed per service.
+ # * Maximum of default 10 labels per monitored resource is allowed.
+ #
+ # The default maximum limit can be overridden. Please follow
+ # https://cloud.google.com/monitoring/quotas
+ "name": "A String", # Optional. The resource name of the monitored resource descriptor:
+ # `"projects/{project_id}/monitoredResourceDescriptors/{type}"` where
+ # {type} is the value of the `type` field in this object and
+ # {project_id} is a project ID that provides API-specific context for
+ # accessing the type. APIs that do not use project information can use the
+ # resource name format `"monitoredResourceDescriptors/{type}"`.
+ "launchStage": "A String", # Optional. The launch stage of the monitored resource definition.
+ "displayName": "A String", # Optional. A concise name for the monitored resource type that might be
+ # displayed in user interfaces. It should be a Title Cased Noun Phrase,
+ # without any article or other determiners. For example,
+ # `"Google Cloud SQL Database"`.
+ "labels": [ # Required. A set of labels used to describe instances of this monitored
+ # resource type.
+ # The label key name must follow:
+ #
+ # * Only upper and lower-case letters, digits and underscores (_) are
+ # allowed.
+ # * Label name must start with a letter or digit.
+ # * The maximum length of a label name is 100 characters.
+ #
+ # For example, an individual Google Cloud SQL database is
+ # identified by values for the labels `database_id` and `location`.
+ { # A description of a label.
+ "valueType": "A String", # The type of data that can be assigned to the label.
+ "description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
+ },
+ ],
+ "description": "A String", # Optional. A detailed description of the monitored resource type that might
+ # be used in documentation.
+ "type": "A String", # Required. The monitored resource type. For example, the type
+ # `cloudsql_database` represents databases in Google Cloud SQL.
+ #
+ # All service defined monitored resource types must be prefixed with the
+ # service name, in the format of `{service name}/{relative resource name}`.
+ # The relative resource name must follow:
+ #
+ # * Only upper and lower-case letters and digits are allowed.
+ # * It must start with upper case character and is recommended to use Upper
+ # Camel Case style.
+ # * The maximum number of characters allowed for the relative_resource_name
+ # is 100.
+ #
+ # Note there are legacy service monitored resources not following this rule.
+ },
+ ],
"context": { # `Context` defines which contexts an API requests. # Context configuration.
#
# Example:
@@ -3754,14 +3983,6 @@
# **NOTE:** All service configuration rules follow "last one wins" order.
{ # A context rule provides information about the context for an individual API
# element.
- "allowedRequestExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
- # side channel from client to backend.
- "A String",
- ],
- "allowedResponseExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
- # side channel from backend to client.
- "A String",
- ],
"selector": "A String", # Selects the methods to which this rule applies.
#
# Refer to selector for syntax details.
@@ -3771,73 +3992,14 @@
"provided": [ # A list of full type names of provided contexts.
"A String",
],
- },
- ],
- },
- "producerProjectId": "A String", # The Google project that owns this service.
- "backend": { # `Backend` defines the backend configuration for a service. # API backend configuration.
- "rules": [ # A list of API backend rules that apply to individual API methods.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A backend rule provides configuration for an individual API element.
- "operationDeadline": 3.14, # The number of seconds to wait for the completion of a long running
- # operation. The default is no deadline.
- "minDeadline": 3.14, # Minimum deadline in seconds needed for this method. Calls having deadline
- # value lower than this will be rejected.
- "address": "A String", # The address of the API backend.
- #
- # The scheme is used to determine the backend protocol and security.
- # The following schemes are accepted:
- #
- # SCHEME PROTOCOL SECURITY
- # http:// HTTP None
- # https:// HTTP TLS
- # grpc:// gRPC None
- # grpcs:// gRPC TLS
- #
- # It is recommended to explicitly include a scheme. Leaving out the scheme
- # may cause constrasting behaviors across platforms.
- #
- # If the port is unspecified, the default is:
- # - 80 for schemes without TLS
- # - 443 for schemes with TLS
- #
- # For HTTP backends, use protocol
- # to specify the protocol version.
- "pathTranslation": "A String",
- "selector": "A String", # Selects the methods to which this rule applies.
- #
- # Refer to selector for syntax details.
- "jwtAudience": "A String", # The JWT audience is used when generating a JWT ID token for the backend.
- # This ID token will be added in the HTTP "authorization" header, and sent
- # to the backend.
- "disableAuth": True or False, # When disable_auth is true, a JWT ID token won't be generated and the
- # original "Authorization" HTTP header will be preserved. If the header is
- # used to carry the original token and is expected by the backend, this
- # field must be set to true to preserve the header.
- "deadline": 3.14, # The number of seconds to wait for a response from a request. The default
- # varies based on the request protocol and deployment environment.
- "protocol": "A String", # The protocol used for sending a request to the backend.
- # The supported values are "http/1.1" and "h2".
- #
- # The default value is inferred from the scheme in the
- # address field:
- #
- # SCHEME PROTOCOL
- # http:// http/1.1
- # https:// http/1.1
- # grpc:// h2
- # grpcs:// h2
- #
- # For secure HTTP backends (https://) that support HTTP/2, set this field
- # to "h2" for improved performance.
- #
- # Configuring this field to non-default values is only supported for secure
- # HTTP backends. This field will be ignored for all other backends.
- #
- # See
- # https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
- # for more details on the supported values.
+ "allowedRequestExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
+ # side channel from client to backend.
+ "A String",
+ ],
+ "allowedResponseExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
+ # side channel from backend to client.
+ "A String",
+ ],
},
],
},
@@ -3888,273 +4050,6 @@
# - selector: "*"
# requirements:
# provider_id: google_calendar_auth
- "control": { # Selects and configures the service controller used by the service. The # Configuration for the service control plane.
- # service controller handles features like abuse, quota, billing, logging,
- # monitoring, etc.
- "environment": "A String", # The service control environment to use. If empty, no control plane
- # feature (like quota and billing) will be enabled.
- },
- "types": [ # A list of all proto message types included in this API service.
- # Types referenced directly or indirectly by the `apis` are
- # automatically included. Messages which are not referenced but
- # shall be included, such as types used by the `google.protobuf.Any` type,
- # should be listed here by name. Example:
- #
- # types:
- # - name: google.protobuf.Int32
- { # A protocol buffer message type.
- "fields": [ # The list of fields.
- { # A single field of a message type.
- "number": 42, # The field number.
- "name": "A String", # The field name.
- "kind": "A String", # The field type.
- "jsonName": "A String", # The field JSON name.
- "cardinality": "A String", # The field cardinality.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
- "packed": True or False, # Whether to use alternative packed wire representation.
- "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
- # types. The first type has index 1; zero means the type is not in the list.
- "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
- # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
- },
- ],
- "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
- "A String",
- ],
- "name": "A String", # The fully qualified message name.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax.
- "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- },
- ],
- "sourceInfo": { # Source information used to create a Service Config # Output only. The source information for this configuration if available.
- "sourceFiles": [ # All files used during config generation.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
- },
- "name": "A String", # The service name, which is a DNS-like logical identifier for the
- # service, such as `calendar.googleapis.com`. The service name
- # typically goes through DNS verification to make sure the owner
- # of the service also owns the DNS name.
- "title": "A String", # The product title for this service.
- "logs": [ # Defines the logs used by this service.
- { # A description of a log type. Example in YAML format:
- #
- # - name: library.googleapis.com/activity_history
- # description: The history of borrowing and returning library items.
- # display_name: Activity
- # labels:
- # - key: /customer_id
- # description: Identifier of a library customer
- "labels": [ # The set of labels that are available to describe a specific log entry.
- # Runtime requests that contain labels not specified here are
- # considered invalid.
- { # A description of a label.
- "valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
- "description": "A String", # A human-readable description for the label.
- },
- ],
- "description": "A String", # A human-readable description of this log. This information appears in
- # the documentation and can contain details.
- "displayName": "A String", # The human-readable name for this log. This information appears on
- # the user interface and should be concise.
- "name": "A String", # The name of the log. It must be less than 512 characters long and can
- # include the following characters: upper- and lower-case alphanumeric
- # characters [A-Za-z0-9], and punctuation characters including
- # slash, underscore, hyphen, period [/_-.].
- },
- ],
- "metrics": [ # Defines the metrics used by this service.
- { # 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.
- "type": "A String", # 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` or `external.googleapis.com`. Metric types should
- # use a natural hierarchical grouping. For example:
- #
- # "custom.googleapis.com/invoice/paid/amount"
- # "external.googleapis.com/prometheus/up"
- # "appengine.googleapis.com/http/server/response_latencies"
- "labels": [ # 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.
- { # A description of a label.
- "valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
- "description": "A String", # A human-readable description for the label.
- },
- ],
- "description": "A String", # A detailed description of the metric, which can be used in documentation.
- "monitoredResourceTypes": [ # Read-only. If present, then a time
- # series, which is identified partially by
- # a metric type and a MonitoredResourceDescriptor, that is associated
- # with this metric type can only be associated with one of the monitored
- # resource types listed here.
- "A String",
- ],
- "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
- # Use sentence case without an ending period, for example "Request count".
- # This field is optional but it is recommended to be set for any metrics
- # associated with user-visible concepts, such as Quota.
- "metadata": { # Additional annotations that can be used to guide the usage of a metric. # Optional. Metadata which can be used to guide usage of the metric.
- "launchStage": "A String", # Deprecated. Must use the MetricDescriptor.launch_stage instead.
- "ingestDelay": "A String", # The delay of data points caused by ingestion. Data points older than this
- # age are guaranteed to be ingested and available to be read, excluding
- # data loss due to errors.
- "samplePeriod": "A String", # The sampling period of metric data points. For metrics which are written
- # periodically, consecutive data points are stored at this time interval,
- # excluding data loss due to errors. Metrics with a higher granularity have
- # a smaller sampling period.
- },
- "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc.
- # Some combinations of `metric_kind` and `value_type` might not be supported.
- "unit": "A String", # The units in which the metric value is reported. It is only applicable
- # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit`
- # defines the representation of the stored metric values.
- #
- # Different systems may scale the values to be more easily displayed (so a
- # value of `0.02KBy` _might_ be displayed as `20By`, and a value of
- # `3523KBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is
- # `KBy`, then the value of the metric is always in thousands of bytes, no
- # matter how it may be displayed..
- #
- # If you want a custom metric to record the exact number of CPU-seconds used
- # by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is
- # `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005
- # CPU-seconds, then the value is written as `12005`.
- #
- # Alternatively, if you want a custom metric to record data in a more
- # granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
- # `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`),
- # or use `Kis{CPU}` and write `11.723` (which is `12005/1024`).
- #
- # The supported units are a subset of [The Unified Code for Units of
- # Measure](http://unitsofmeasure.org/ucum.html) standard:
- #
- # **Basic units (UNIT)**
- #
- # * `bit` bit
- # * `By` byte
- # * `s` second
- # * `min` minute
- # * `h` hour
- # * `d` day
- #
- # **Prefixes (PREFIX)**
- #
- # * `k` kilo (10^3)
- # * `M` mega (10^6)
- # * `G` giga (10^9)
- # * `T` tera (10^12)
- # * `P` peta (10^15)
- # * `E` exa (10^18)
- # * `Z` zetta (10^21)
- # * `Y` yotta (10^24)
- #
- # * `m` milli (10^-3)
- # * `u` micro (10^-6)
- # * `n` nano (10^-9)
- # * `p` pico (10^-12)
- # * `f` femto (10^-15)
- # * `a` atto (10^-18)
- # * `z` zepto (10^-21)
- # * `y` yocto (10^-24)
- #
- # * `Ki` kibi (2^10)
- # * `Mi` mebi (2^20)
- # * `Gi` gibi (2^30)
- # * `Ti` tebi (2^40)
- # * `Pi` pebi (2^50)
- #
- # **Grammar**
- #
- # The grammar also includes these connectors:
- #
- # * `/` division or ratio (as an infix operator). For examples,
- # `kBy/{email}` or `MiBy/10ms` (although you should almost never
- # have `/s` in a metric `unit`; rates should always be computed at
- # query time from the underlying cumulative or delta value).
- # * `.` multiplication or composition (as an infix operator). For
- # examples, `GBy.d` or `k{watt}.h`.
- #
- # The grammar for a unit is as follows:
- #
- # Expression = Component { "." Component } { "/" Component } ;
- #
- # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
- # | Annotation
- # | "1"
- # ;
- #
- # Annotation = "{" NAME "}" ;
- #
- # Notes:
- #
- # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
- # is used alone, then the unit is equivalent to `1`. For examples,
- # `{request}/s == 1/s`, `By{transmitted}/s == By/s`.
- # * `NAME` is a sequence of non-blank printable ASCII characters not
- # containing `{` or `}`.
- # * `1` represents a unitary [dimensionless
- # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
- # as in `1/s`. It is typically used when none of the basic units are
- # appropriate. For example, "new users per day" can be represented as
- # `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new
- # users). Alternatively, "thousands of page views per day" would be
- # represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric
- # value of `5.3` would mean "5300 page views per day").
- # * `%` represents dimensionless value of 1/100, and annotates values giving
- # a percentage (so the metric values are typically in the range of 0..100,
- # and a metric value `3` means "3 percent").
- # * `10^2.%` indicates a metric contains a ratio, typically in the range
- # 0..1, that will be multiplied by 100 and displayed as a percentage
- # (so a metric value `0.03` means "3 percent").
- "launchStage": "A String", # Optional. The launch stage of the metric definition.
- "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
- # Some combinations of `metric_kind` and `value_type` might not be supported.
- "name": "A String", # The resource name of the metric descriptor.
- },
- ],
"enums": [ # A list of all enum types included in this API service. Enums
# referenced directly or indirectly by the `apis` are automatically
# included. Enums which are not referenced but shall be included
@@ -4166,530 +4061,414 @@
"options": [ # Protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
- "name": "A String", # Enum type name.
- "syntax": "A String", # The source syntax.
+ "enumvalue": [ # Enum value definitions.
+ { # Enum value definition.
+ "name": "A String", # Enum value name.
+ "options": [ # Protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "number": 42, # Enum value number.
+ },
+ ],
"sourceContext": { # `SourceContext` represents information about the source of a # The source context.
# protobuf element, like the file in which it is defined.
"fileName": "A String", # The path-qualified name of the .proto file that contained the associated
# protobuf element. For example: `"google/protobuf/source_context.proto"`.
},
- "enumvalue": [ # Enum value definitions.
- { # Enum value definition.
- "name": "A String", # Enum value name.
- "number": 42, # Enum value number.
- "options": [ # Protocol buffer options.
+ "name": "A String", # Enum type name.
+ "syntax": "A String", # The source syntax.
+ },
+ ],
+ "backend": { # `Backend` defines the backend configuration for a service. # API backend configuration.
+ "rules": [ # A list of API backend rules that apply to individual API methods.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # A backend rule provides configuration for an individual API element.
+ "disableAuth": True or False, # When disable_auth is true, a JWT ID token won't be generated and the
+ # original "Authorization" HTTP header will be preserved. If the header is
+ # used to carry the original token and is expected by the backend, this
+ # field must be set to true to preserve the header.
+ "address": "A String", # The address of the API backend.
+ #
+ # The scheme is used to determine the backend protocol and security.
+ # The following schemes are accepted:
+ #
+ # SCHEME PROTOCOL SECURITY
+ # http:// HTTP None
+ # https:// HTTP TLS
+ # grpc:// gRPC None
+ # grpcs:// gRPC TLS
+ #
+ # It is recommended to explicitly include a scheme. Leaving out the scheme
+ # may cause constrasting behaviors across platforms.
+ #
+ # If the port is unspecified, the default is:
+ # - 80 for schemes without TLS
+ # - 443 for schemes with TLS
+ #
+ # For HTTP backends, use protocol
+ # to specify the protocol version.
+ "minDeadline": 3.14, # Minimum deadline in seconds needed for this method. Calls having deadline
+ # value lower than this will be rejected.
+ "selector": "A String", # Selects the methods to which this rule applies.
+ #
+ # Refer to selector for syntax details.
+ "protocol": "A String", # The protocol used for sending a request to the backend.
+ # The supported values are "http/1.1" and "h2".
+ #
+ # The default value is inferred from the scheme in the
+ # address field:
+ #
+ # SCHEME PROTOCOL
+ # http:// http/1.1
+ # https:// http/1.1
+ # grpc:// h2
+ # grpcs:// h2
+ #
+ # For secure HTTP backends (https://) that support HTTP/2, set this field
+ # to "h2" for improved performance.
+ #
+ # Configuring this field to non-default values is only supported for secure
+ # HTTP backends. This field will be ignored for all other backends.
+ #
+ # See
+ # https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
+ # for more details on the supported values.
+ "operationDeadline": 3.14, # The number of seconds to wait for the completion of a long running
+ # operation. The default is no deadline.
+ "pathTranslation": "A String",
+ "jwtAudience": "A String", # The JWT audience is used when generating a JWT ID token for the backend.
+ # This ID token will be added in the HTTP "authorization" header, and sent
+ # to the backend.
+ "deadline": 3.14, # The number of seconds to wait for a response from a request. The default
+ # varies based on the request protocol and deployment environment.
+ },
+ ],
+ },
+ "systemTypes": [ # 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.
+ { # A protocol buffer message type.
+ "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
+ "A String",
+ ],
+ "fields": [ # The list of fields.
+ { # A single field of a message type.
+ "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
+ # types. The first type has index 1; zero means the type is not in the list.
+ "name": "A String", # The field name.
+ "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
+ "packed": True or False, # Whether to use alternative packed wire representation.
+ "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
+ # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
+ "cardinality": "A String", # The field cardinality.
+ "jsonName": "A String", # The field JSON name.
+ "kind": "A String", # The field type.
+ "options": [ # The protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
+ "number": 42, # The field number.
},
],
- },
- ],
- "authentication": { # `Authentication` defines the authentication configuration for an API. # Auth configuration.
- #
- # Example for an API targeted for external use:
- #
- # name: calendar.googleapis.com
- # authentication:
- # providers:
- # - id: google_calendar_auth
- # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
- # issuer: https://securetoken.google.com
- # rules:
- # - selector: "*"
- # requirements:
- # provider_id: google_calendar_auth
- "rules": [ # A list of authentication rules that apply to individual API methods.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # Authentication rules for the service.
- #
- # By default, if a method has any authentication requirements, every request
- # must include a valid credential matching one of the requirements.
- # It's an error to include more than one kind of credential in a single
- # request.
- #
- # If a method doesn't have any auth requirements, request credentials will be
- # ignored.
- "oauth": { # OAuth scopes are a way to define data and permissions on data. For example, # The requirements for OAuth credentials.
- # there are scopes defined for "Read-only access to Google Calendar" and
- # "Access to Cloud Platform". Users can consent to a scope for an application,
- # giving it permission to access that data on their behalf.
- #
- # OAuth scope specifications should be fairly coarse grained; a user will need
- # to see and understand the text description of what your scope means.
- #
- # In most cases: use one or at most two OAuth scopes for an entire family of
- # products. If your product has multiple APIs, you should probably be sharing
- # the OAuth scope across all of those APIs.
- #
- # When you need finer grained OAuth consent screens: talk with your product
- # management about how developers will use them in practice.
- #
- # Please note that even though each of the canonical scopes is enough for a
- # request to be accepted and passed to the backend, a request can still fail
- # due to the backend requiring additional scopes or permissions.
- "canonicalScopes": "A String", # The list of publicly documented OAuth scopes that are allowed access. An
- # OAuth token containing any of these scopes will be accepted.
- #
- # Example:
- #
- # canonical_scopes: https://www.googleapis.com/auth/calendar,
- # https://www.googleapis.com/auth/calendar.read
- },
- "requirements": [ # Requirements for additional authentication providers.
- { # User-defined authentication requirements, including support for
- # [JSON Web Token
- # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
- "audiences": "A String", # 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:
- #
- # audiences: bookstore_android.apps.googleusercontent.com,
- # bookstore_web.apps.googleusercontent.com
- "providerId": "A String", # id from authentication provider.
- #
- # Example:
- #
- # provider_id: bookstore_auth
- },
- ],
- "allowWithoutCredential": True or False, # If true, the service accepts API keys without any other credential.
- "selector": "A String", # Selects the methods to which this rule applies.
- #
- # Refer to selector for syntax details.
- },
- ],
- "providers": [ # Defines a set of authentication providers that a service supports.
- { # Configuration for an authentication provider, including support for
- # [JSON Web Token
- # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
- "audiences": "A String", # 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, JWTs with audiences:
- # - "https://[service.name]/[google.protobuf.Api.name]"
- # - "https://[service.name]/"
- # will be accepted.
- # For example, if no audiences are in the setting, LibraryService API will
- # accept JWTs with the following audiences:
- # -
- # https://library-example.googleapis.com/google.example.library.v1.LibraryService
- # - https://library-example.googleapis.com/
- #
- # Example:
- #
- # audiences: bookstore_android.apps.googleusercontent.com,
- # bookstore_web.apps.googleusercontent.com
- "jwtLocations": [ # Defines the locations to extract the JWT.
- #
- # JWT locations can be either from HTTP headers or URL query parameters.
- # The rule is that the first match wins. The checking order is: checking
- # all headers first, then URL query parameters.
- #
- # If not specified, default to use following 3 locations:
- # 1) Authorization: Bearer
- # 2) x-goog-iap-jwt-assertion
- # 3) access_token query parameter
- #
- # Default locations can be specified as followings:
- # jwt_locations:
- # - header: Authorization
- # value_prefix: "Bearer "
- # - header: x-goog-iap-jwt-assertion
- # - query: access_token
- { # Specifies a location to extract JWT from an API request.
- "query": "A String", # Specifies URL query parameter name to extract JWT token.
- "header": "A String", # Specifies HTTP header name to extract JWT token.
- "valuePrefix": "A String", # The value prefix. The value format is "value_prefix{token}"
- # Only applies to "in" header type. Must be empty for "in" query type.
- # If not empty, the header value has to match (case sensitive) this prefix.
- # If not matched, JWT will not be extracted. If matched, JWT will be
- # extracted after the prefix is removed.
- #
- # For example, for "Authorization: Bearer {JWT}",
- # value_prefix="Bearer " with a space at the end.
- },
- ],
- "issuer": "A String", # 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.
- #
- # Example: https://securetoken.google.com
- # Example: 1234567-compute@developer.gserviceaccount.com
- "id": "A String", # The unique identifier of the auth provider. It will be referred to by
- # `AuthRequirement.provider_id`.
- #
- # Example: "bookstore_auth".
- "jwksUri": "A String", # URL of the provider's public key set to validate signature of the JWT. See
- # [OpenID
- # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).
- # Optional if the key set document:
- # - can be retrieved from
- # [OpenID
- # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
- # the issuer.
- # - can be inferred from the email domain of the issuer (e.g. a Google
- # service account).
- #
- # Example: https://www.googleapis.com/oauth2/v1/certs
- "authorizationUrl": "A String", # Redirect URL if JWT token is required but not present or is expired.
- # Implement authorizationUrl of securityDefinitions in OpenAPI spec.
- },
- ],
- },
- "documentation": { # `Documentation` provides the information for describing a service. # Additional API documentation.
- #
- # Example:
- # <pre><code>documentation:
- # summary: >
- # The Google Calendar API gives access
- # to most calendar features.
- # pages:
- # - name: Overview
- # content: &#40;== include google/foo/overview.md ==&#41;
- # - name: Tutorial
- # content: &#40;== include google/foo/tutorial.md ==&#41;
- # subpages;
- # - name: Java
- # content: &#40;== include google/foo/tutorial_java.md ==&#41;
- # rules:
- # - selector: google.calendar.Calendar.Get
- # description: >
- # ...
- # - selector: google.calendar.Calendar.Put
- # description: >
- # ...
- # </code></pre>
- # Documentation is provided in markdown syntax. In addition to
- # standard markdown features, definition lists, tables and fenced
- # code blocks are supported. Section headers can be provided and are
- # interpreted relative to the section nesting of the context where
- # a documentation fragment is embedded.
- #
- # Documentation from the IDL is merged with documentation defined
- # via the config at normalization time, where documentation provided
- # by config rules overrides IDL provided.
- #
- # A number of constructs specific to the API platform are supported
- # in documentation text.
- #
- # In order to reference a proto element, the following
- # notation can be used:
- # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
- # To override the display text used for the link, this can be used:
- # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
- # Text can be excluded from doc using the following notation:
- # <pre><code>&#40;-- internal comment --&#41;</code></pre>
- #
- # A few directives are available in documentation. Note that
- # directives must appear on a single line to be properly
- # identified. The `include` directive includes a markdown file from
- # an external source:
- # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
- # The `resource_for` directive marks a message to be the resource of
- # a collection in REST view. If it is not specified, tools attempt
- # to infer the resource from the operations in a collection:
- # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
- # The directive `suppress_warning` does not directly affect documentation
- # and is documented together with service config validation.
- "documentationRootUrl": "A String", # The URL to the root of documentation.
- "serviceRootUrl": "A String", # Specifies the service root url if the default one (the service name
- # from the yaml file) is not suitable. This can be seen in any fully
- # specified service urls as well as sections that show a base that other
- # urls are relative to.
- "rules": [ # A list of documentation rules that apply to individual API elements.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A documentation rule provides information about individual API elements.
- "description": "A String", # Description of the selected API(s).
- "deprecationDescription": "A String", # Deprecation description of the selected element(s). It can be provided if
- # an element is marked as `deprecated`.
- "selector": "A String", # The selector is a comma-separated list of patterns. Each pattern is a
- # qualified name of the element which may end in "*", indicating a wildcard.
- # Wildcards are only allowed at the end and for a whole component of the
- # qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A
- # wildcard will match one or more components. To specify a default for all
- # applicable elements, the whole pattern "*" is used.
- },
- ],
- "pages": [ # The top level pages for the documentation set.
- { # Represents a documentation page. A page can contain subpages to represent
- # nested documentation set structure.
- "name": "A String", # The name of the page. It will be used as an identity of the page to
- # generate URI of the page, text of the link to this page in navigation,
- # etc. The full page name (start from the root page name to this page
- # concatenated with `.`) can be used as reference to the page in your
- # documentation. For example:
- # <pre><code>pages:
- # - name: Tutorial
- # content: &#40;== include tutorial.md ==&#41;
- # subpages:
- # - name: Java
- # content: &#40;== include tutorial_java.md ==&#41;
- # </code></pre>
- # You can reference `Java` page using Markdown reference link syntax:
- # `Java`.
- "subpages": [ # Subpages of this page. The order of subpages specified here will be
- # honored in the generated docset.
- # Object with schema name: Page
- ],
- "content": "A String", # The Markdown content of the page. You can use <code>&#40;== include {path}
- # ==&#41;</code> to include content from a Markdown file.
- },
- ],
- "summary": "A String", # A short summary of what the service does. Can only be provided by
- # plain text.
- "overview": "A String", # Declares a single overview page. For example:
- # <pre><code>documentation:
- # summary: ...
- # overview: &#40;== include overview.md ==&#41;
- # </code></pre>
- # This is a shortcut for the following declaration (using pages style):
- # <pre><code>documentation:
- # summary: ...
- # pages:
- # - name: Overview
- # content: &#40;== include overview.md ==&#41;
- # </code></pre>
- # Note: you cannot specify both `overview` field and `pages` field.
- },
- "apis": [ # 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.
- { # Api is a light-weight descriptor for an API Interface.
- #
- # Interfaces are also described as "protocol buffer services" in some contexts,
- # such as by the "service" keyword in a .proto file, but they are different
- # from API Services, which represent a concrete implementation of an interface
- # as opposed to simply a description of methods and bindings. They are also
- # sometimes simply referred to as "APIs" in other contexts, such as the name of
- # this message itself. See https://cloud.google.com/apis/design/glossary for
- # detailed terminology.
- "options": [ # Any metadata attached to the interface.
+ "options": [ # The protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
- "syntax": "A String", # The source syntax of the service.
- "sourceContext": { # `SourceContext` represents information about the source of a # Source context for the protocol buffer service represented by this
- # message.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- "mixins": [ # Included interfaces. See Mixin.
- { # Declares an API Interface to be included in this interface. The including
- # interface must redeclare all the methods from the included interface, but
- # documentation and options are inherited as follows:
- #
- # - If after comment and whitespace stripping, the documentation
- # string of the redeclared method is empty, it will be inherited
- # from the original method.
- #
- # - Each annotation belonging to the service config (http,
- # visibility) which is not set in the redeclared method will be
- # inherited.
- #
- # - If an http annotation is inherited, the path pattern will be
- # modified as follows. Any version prefix will be replaced by the
- # version of the including interface plus the root path if
- # specified.
- #
- # Example of a simple mixin:
- #
- # package google.acl.v1;
- # service AccessControl {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v1/{resource=**}:getAcl";
- # }
- # }
- #
- # package google.storage.v2;
- # service Storage {
- # // rpc GetAcl(GetAclRequest) returns (Acl);
- #
- # // Get a data record.
- # rpc GetData(GetDataRequest) returns (Data) {
- # option (google.api.http).get = "/v2/{resource=**}";
- # }
- # }
- #
- # Example of a mixin configuration:
- #
- # apis:
- # - name: google.storage.v2.Storage
- # mixins:
- # - name: google.acl.v1.AccessControl
- #
- # The mixin construct implies that all methods in `AccessControl` are
- # also declared with same name and request/response types in
- # `Storage`. A documentation generator or annotation processor will
- # see the effective `Storage.GetAcl` method after inherting
- # documentation and annotations as follows:
- #
- # service Storage {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v2/{resource=**}:getAcl";
- # }
- # ...
- # }
- #
- # Note how the version in the path pattern changed from `v1` to `v2`.
- #
- # If the `root` field in the mixin is specified, it should be a
- # relative path under which inherited HTTP paths are placed. Example:
- #
- # apis:
- # - name: google.storage.v2.Storage
- # mixins:
- # - name: google.acl.v1.AccessControl
- # root: acls
- #
- # This implies the following inherited HTTP annotation:
- #
- # service Storage {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v2/acls/{resource=**}:getAcl";
- # }
- # ...
- # }
- "name": "A String", # The fully qualified name of the interface which is included.
- "root": "A String", # If non-empty specifies a path under which inherited HTTP paths
- # are rooted.
- },
- ],
- "version": "A String", # A version string for this interface. If specified, must have the form
- # `major-version.minor-version`, as in `1.10`. If the minor version is
- # omitted, it defaults to zero. If the entire version field is empty, the
- # major version is derived from the package name, as outlined below. If the
- # field is not empty, the version in the package name will be verified to be
- # consistent with what is provided here.
- #
- # The versioning schema uses [semantic
- # versioning](http://semver.org) where the major version number
- # indicates a breaking change and the minor version an additive,
- # non-breaking change. Both version numbers are signals to users
- # what to expect from different versions, and should be carefully
- # chosen based on the product plan.
- #
- # The major version is also reflected in the package name of the
- # interface, which must end in `v<major-version>`, as in
- # `google.feature.v1`. For major versions 0 and 1, the suffix can
- # be omitted. Zero major versions must only be used for
- # experimental, non-GA interfaces.
- "methods": [ # The methods of this interface, in unspecified order.
- { # Method represents a method of an API interface.
- "requestTypeUrl": "A String", # A URL of the input message type.
- "name": "A String", # The simple name of this method.
- "responseStreaming": True or False, # If true, the response is streamed.
- "requestStreaming": True or False, # If true, the request is streamed.
- "options": [ # Any metadata attached to the method.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax of this method.
- "responseTypeUrl": "A String", # The URL of the output message type.
- },
- ],
- "name": "A String", # The fully qualified name of this interface, including package name
- # followed by the interface's simple name.
+ "syntax": "A String", # The source syntax.
+ "name": "A String", # The fully qualified message name.
},
],
- "customError": { # Customize service error responses. For example, list any service # Custom error configuration.
- # specific protobuf types that can appear in error detail lists of
- # error responses.
- #
- # Example:
- #
- # custom_error:
- # types:
- # - google.foo.v1.CustomError
- # - google.foo.v1.AnotherError
- "types": [ # The list of custom error detail types, e.g. 'google.foo.v1.CustomError'.
- "A String",
- ],
- "rules": [ # The list of custom error rules that apply to individual API messages.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A custom error rule.
- "isErrorType": True or False, # Mark this message as possible payload in error response. Otherwise,
- # objects of this type will be filtered when they appear in error payload.
- "selector": "A String", # Selects messages to which this rule applies.
- #
- # Refer to selector for syntax details.
+ "name": "A String", # The service name, which is a DNS-like logical identifier for the
+ # service, such as `calendar.googleapis.com`. The service name
+ # typically goes through DNS verification to make sure the owner
+ # of the service also owns the DNS name.
+ "sourceInfo": { # Source information used to create a Service Config # Output only. The source information for this configuration if available.
+ "sourceFiles": [ # All files used during config generation.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
},
- "id": "A String", # A unique ID for a specific instance of this message, typically assigned
- # by the client for tracking purpose. Must be no longer than 63 characters
- # and only lower case letters, digits, '.', '_' and '-' are allowed. If
- # empty, the server may choose to generate one instead.
+ "billing": { # Billing related configuration of the service. # Billing configuration.
+ #
+ # The following example shows how to configure monitored resources and metrics
+ # for billing, `consumer_destinations` is the only supported destination and
+ # the monitored resources need at least one label key
+ # `cloud.googleapis.com/location` to indicate the location of the billing
+ # usage, using different monitored resources between monitoring and billing is
+ # recommended so they can be evolved independently:
+ #
+ #
+ # monitored_resources:
+ # - type: library.googleapis.com/billing_branch
+ # labels:
+ # - key: cloud.googleapis.com/location
+ # description: |
+ # Predefined label to support billing location restriction.
+ # - key: city
+ # description: |
+ # Custom label to define the city where the library branch is located
+ # in.
+ # - key: name
+ # description: Custom label to define the name of the library branch.
+ # metrics:
+ # - name: library.googleapis.com/book/borrowed_count
+ # metric_kind: DELTA
+ # value_type: INT64
+ # unit: "1"
+ # billing:
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/billing_branch
+ # metrics:
+ # - library.googleapis.com/book/borrowed_count
+ "consumerDestinations": [ # Billing configurations for sending metrics to the consumer project.
+ # There can be multiple consumer destinations per service, each one must have
+ # a different monitored resource type. A metric can be used in at most
+ # one consumer destination.
+ { # Configuration of a specific billing destination (Currently only support
+ # bill against consumer project).
+ "metrics": [ # Names of the metrics to report to this billing destination.
+ # Each name must be defined in Service.metrics section.
+ "A String",
+ ],
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ },
+ ],
+ },
+ "monitoring": { # Monitoring configuration of the service. # Monitoring configuration.
+ #
+ # The example below shows how to configure monitored resources and metrics
+ # for monitoring. In the example, a monitored resource and two metrics are
+ # defined. The `library.googleapis.com/book/returned_count` metric is sent
+ # to both producer and consumer projects, whereas the
+ # `library.googleapis.com/book/num_overdue` metric is only sent to the
+ # consumer project.
+ #
+ # monitored_resources:
+ # - type: library.googleapis.com/Branch
+ # display_name: "Library Branch"
+ # description: "A branch of a library."
+ # launch_stage: GA
+ # labels:
+ # - key: resource_container
+ # description: "The Cloud container (ie. project id) for the Branch."
+ # - key: location
+ # description: "The location of the library branch."
+ # - key: branch_id
+ # description: "The id of the branch."
+ # metrics:
+ # - name: library.googleapis.com/book/returned_count
+ # display_name: "Books Returned"
+ # description: "The count of books that have been returned."
+ # launch_stage: GA
+ # metric_kind: DELTA
+ # value_type: INT64
+ # unit: "1"
+ # labels:
+ # - key: customer_id
+ # description: "The id of the customer."
+ # - name: library.googleapis.com/book/num_overdue
+ # display_name: "Books Overdue"
+ # description: "The current number of overdue books."
+ # launch_stage: GA
+ # metric_kind: GAUGE
+ # value_type: INT64
+ # unit: "1"
+ # labels:
+ # - key: customer_id
+ # description: "The id of the customer."
+ # monitoring:
+ # producer_destinations:
+ # - monitored_resource: library.googleapis.com/Branch
+ # metrics:
+ # - library.googleapis.com/book/returned_count
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/Branch
+ # metrics:
+ # - library.googleapis.com/book/returned_count
+ # - library.googleapis.com/book/num_overdue
+ "producerDestinations": [ # Monitoring configurations for sending metrics to the producer project.
+ # There can be multiple producer destinations. A monitored resource type may
+ # appear in multiple monitoring destinations if different aggregations are
+ # needed for different sets of metrics associated with that monitored
+ # resource type. A monitored resource and metric pair may only be used once
+ # in the Monitoring configuration.
+ { # Configuration of a specific monitoring destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ "metrics": [ # Types of the metrics to report to this monitoring destination.
+ # Each type must be defined in Service.metrics section.
+ "A String",
+ ],
+ },
+ ],
+ "consumerDestinations": [ # Monitoring configurations for sending metrics to the consumer project.
+ # There can be multiple consumer destinations. A monitored resource type may
+ # appear in multiple monitoring destinations if different aggregations are
+ # needed for different sets of metrics associated with that monitored
+ # resource type. A monitored resource and metric pair may only be used once
+ # in the Monitoring configuration.
+ { # Configuration of a specific monitoring destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ "metrics": [ # Types of the metrics to report to this monitoring destination.
+ # Each type must be defined in Service.metrics section.
+ "A String",
+ ],
+ },
+ ],
+ },
+ "logging": { # Logging configuration of the service. # Logging configuration.
+ #
+ # The following example shows how to configure logs to be sent to the
+ # 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: activity_history
+ # labels:
+ # - key: /customer_id
+ # - name: purchase_history
+ # logging:
+ # producer_destinations:
+ # - monitored_resource: library.googleapis.com/branch
+ # logs:
+ # - activity_history
+ # - purchase_history
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/branch
+ # logs:
+ # - activity_history
+ "producerDestinations": [ # Logging configurations for sending logs to the producer project.
+ # There can be multiple producer destinations, each one must have a
+ # different monitored resource type. A log can be used in at most
+ # one producer destination.
+ { # Configuration of a specific logging destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
+ # Service.monitored_resources section.
+ "logs": [ # Names of the logs to be sent to this destination. Each name must
+ # 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 "/".
+ "A String",
+ ],
+ },
+ ],
+ "consumerDestinations": [ # 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.
+ { # Configuration of a specific logging destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
+ # Service.monitored_resources section.
+ "logs": [ # Names of the logs to be sent to this destination. Each name must
+ # 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 "/".
+ "A String",
+ ],
+ },
+ ],
+ },
+ "control": { # Selects and configures the service controller used by the service. The # Configuration for the service control plane.
+ # service controller handles features like abuse, quota, billing, logging,
+ # monitoring, etc.
+ "environment": "A String", # The service control environment to use. If empty, no control plane
+ # feature (like quota and billing) will be enabled.
+ },
"usage": { # Configuration controlling usage of a service. # Configuration controlling usage of this service.
"requirements": [ # Requirements that must be satisfied before a consumer project can use the
# service. Each requirement is of the form <service.name>/<requirement-id>;
# for example 'serviceusage.googleapis.com/billing-enabled'.
"A String",
],
+ "serviceIdentity": { # The per-product per-project service identity for a service. # The configuration of a per-product per-project service identity.
+ #
+ #
+ # Use this field to configure per-product per-project service identity.
+ # Example of a service identity configuration.
+ #
+ # usage:
+ # service_identity:
+ # - service_account_parent: "projects/123456789"
+ # display_name: "Cloud XXX Service Agent"
+ # description: "Used as the identity of Cloud XXX to access resources"
+ "serviceAccountParent": "A String", # A service account project that hosts the service accounts.
+ #
+ # An example name would be:
+ # `projects/123456789`
+ "description": "A String", # Optional. A user-specified opaque description of the service account.
+ # Must be less than or equal to 256 UTF-8 bytes.
+ "displayName": "A String", # Optional. A user-specified name for the service account.
+ # Must be less than or equal to 100 UTF-8 bytes.
+ },
"rules": [ # A list of usage rules that apply to individual API methods.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
@@ -4718,16 +4497,16 @@
# rules:
# - selector: "google.example.library.v1.LibraryService.CreateBook"
# allow_unregistered_calls: true
+ "skipServiceControl": True or False, # If true, the selected method should skip service control and the control
+ # plane features, such as quota and billing, will not be available.
+ # This flag is used by Google Cloud Endpoints to bypass checks for internal
+ # methods, such as service health check methods.
"selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
# methods in all APIs.
#
# Refer to selector for syntax details.
"allowUnregisteredCalls": True or False, # If true, the selected method allows unregistered calls, e.g. calls
# that don't identify any user or application.
- "skipServiceControl": True or False, # If true, the selected method should skip service control and the control
- # plane features, such as quota and billing, will not be available.
- # This flag is used by Google Cloud Endpoints to bypass checks for internal
- # methods, such as service health check methods.
},
],
"producerNotificationChannel": "A String", # The full resource name of a channel used for sending notifications to the
@@ -4738,78 +4517,82 @@
# channel. To use Google Cloud Pub/Sub as the channel, this must be the name
# of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format
# documented in https://cloud.google.com/pubsub/docs/overview.
- "serviceIdentity": { # The per-product per-project service identity for a service. # The configuration of a per-product per-project service identity.
- #
- #
- # Use this field to configure per-product per-project service identity.
- # Example of a service identity configuration.
- #
- # usage:
- # service_identity:
- # - service_account_parent: "projects/123456789"
- # display_name: "Cloud XXX Service Agent"
- # description: "Used as the identity of Cloud XXX to access resources"
- "displayName": "A String", # Optional. A user-specified name for the service account.
- # Must be less than or equal to 100 UTF-8 bytes.
- "description": "A String", # Optional. A user-specified opaque description of the service account.
- # Must be less than or equal to 256 UTF-8 bytes.
- "serviceAccountParent": "A String", # A service account project that hosts the service accounts.
- #
- # An example name would be:
- # `projects/123456789`
- },
},
- "endpoints": [ # Configuration for network endpoints. If this is empty, then an endpoint
- # with the same name as the service is automatically generated to service all
- # defined APIs.
- { # `Endpoint` describes a network endpoint that serves a set of APIs.
- # A service may expose any number of endpoints, and all endpoints share the
- # same service configuration, such as quota configuration and monitoring
- # configuration.
- #
- # Example service configuration:
- #
- # name: library-example.googleapis.com
- # endpoints:
- # # Below entry makes 'google.example.library.v1.Library'
- # # API be served from endpoint address library-example.googleapis.com.
- # # It also allows HTTP OPTIONS calls to be passed to the backend, for
- # # it to decide whether the subsequent cross-origin request is
- # # allowed to proceed.
- # - name: library-example.googleapis.com
- # allow_cors: true
- "name": "A String", # The canonical name of this endpoint.
- "target": "A String", # The specification of an Internet routable address of API frontend that will
- # handle requests to this [API
- # Endpoint](https://cloud.google.com/apis/design/glossary). It should be
- # either a valid IPv4 address or a fully-qualified domain name. For example,
- # "8.8.8.8" or "myservice.appspot.com".
- "allowCors": True or False, # Allowing
- # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
- # cross-domain traffic, would allow the backends served from this endpoint to
- # receive and respond to HTTP OPTIONS requests. The response will be used by
- # the browser to determine whether the subsequent cross-origin request is
- # allowed to proceed.
- "features": [ # The list of features enabled on this endpoint.
+ "types": [ # A list of all proto message types included in this API service.
+ # Types referenced directly or indirectly by the `apis` are
+ # automatically included. Messages which are not referenced but
+ # shall be included, such as types used by the `google.protobuf.Any` type,
+ # should be listed here by name. Example:
+ #
+ # types:
+ # - name: google.protobuf.Int32
+ { # A protocol buffer message type.
+ "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
"A String",
],
- "aliases": [ # DEPRECATED: This field is no longer supported. Instead of using aliases,
- # please specify multiple google.api.Endpoint for each of the intended
- # aliases.
- #
- # Additional names that this endpoint will be hosted on.
- "A String",
+ "fields": [ # The list of fields.
+ { # A single field of a message type.
+ "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
+ # types. The first type has index 1; zero means the type is not in the list.
+ "name": "A String", # The field name.
+ "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
+ "packed": True or False, # Whether to use alternative packed wire representation.
+ "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
+ # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
+ "cardinality": "A String", # The field cardinality.
+ "jsonName": "A String", # The field JSON name.
+ "kind": "A String", # The field type.
+ "options": [ # The protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "number": 42, # The field number.
+ },
],
+ "options": [ # The protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "syntax": "A String", # The source syntax.
+ "name": "A String", # The fully qualified message name.
},
],
- "configVersion": 42, # The semantic version of the service configuration. The config version
- # affects the interpretation of the service configuration. For example,
- # certain features are enabled by default for certain config versions.
- #
- # The latest config version is `3`.
"http": { # Defines the HTTP configuration for an API service. It contains a list of # HTTP configuration.
# HttpRule, each specifying the mapping of an RPC method
# to one or more HTTP REST API methods.
+ "fullyDecodeReservedExpansion": True or False, # When set to true, URL path parameters will be fully URI-decoded except in
+ # cases of single segment matches in reserved expansion, where "%2F" will be
+ # left encoded.
+ #
+ # The default behavior is to not decode RFC 6570 reserved characters in multi
+ # segment matches.
"rules": [ # A list of HTTP configuration rules that apply to individual API methods.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
@@ -5082,10 +4865,29 @@
# If an API needs to use a JSON array for request or response body, it can map
# the request or response body to a repeated field. However, some gRPC
# Transcoding implementations may not support this feature.
+ "put": "A String", # Maps to HTTP PUT. Used for replacing a resource.
"selector": "A String", # Selects a method to which this rule applies.
#
# Refer to selector for syntax details.
- "put": "A String", # Maps to HTTP PUT. Used for replacing a resource.
+ "post": "A String", # Maps to HTTP POST. Used for creating a resource or performing an action.
+ "responseBody": "A String", # Optional. The name of the response field whose value is mapped to the HTTP
+ # response body. When omitted, the entire response message will be used
+ # as the HTTP response body.
+ #
+ # NOTE: The referred field must be present at the top-level of the response
+ # message type.
+ "body": "A String", # The name of the request field whose value is mapped to the HTTP request
+ # body, or `*` for mapping all request fields not captured by the path
+ # pattern to the HTTP body, or omitted for not having any HTTP request body.
+ #
+ # NOTE: the referred field must be present at the top-level of the request
+ # message type.
+ "patch": "A String", # Maps to HTTP PATCH. Used for updating a resource.
+ "additionalBindings": [ # Additional HTTP bindings for the selector. Nested bindings must
+ # not contain an `additional_bindings` field themselves (that is,
+ # the nesting may only be one level deep).
+ # Object with schema name: HttpRule
+ ],
"custom": { # A custom pattern is used for defining custom HTTP verb. # The custom pattern is used for specifying an HTTP method that is not
# included in the `pattern` field, such as HEAD, or "*" to leave the
# HTTP method unspecified for this rule. The wild-card rule is useful
@@ -5093,378 +4895,354 @@
"path": "A String", # The path matched by this custom verb.
"kind": "A String", # The name of this custom HTTP verb.
},
- "responseBody": "A String", # Optional. The name of the response field whose value is mapped to the HTTP
- # response body. When omitted, the entire response message will be used
- # as the HTTP response body.
- #
- # NOTE: The referred field must be present at the top-level of the response
- # message type.
"allowHalfDuplex": True or False, # When this flag is set to true, HTTP requests will be allowed to invoke a
# half-duplex streaming method.
- "additionalBindings": [ # Additional HTTP bindings for the selector. Nested bindings must
- # not contain an `additional_bindings` field themselves (that is,
- # the nesting may only be one level deep).
- # Object with schema name: HttpRule
- ],
- "patch": "A String", # Maps to HTTP PATCH. Used for updating a resource.
+ "delete": "A String", # Maps to HTTP DELETE. Used for deleting a resource.
"get": "A String", # Maps to HTTP GET. Used for listing and getting information about
# resources.
- "post": "A String", # Maps to HTTP POST. Used for creating a resource or performing an action.
- "body": "A String", # The name of the request field whose value is mapped to the HTTP request
- # body, or `*` for mapping all request fields not captured by the path
- # pattern to the HTTP body, or omitted for not having any HTTP request body.
- #
- # NOTE: the referred field must be present at the top-level of the request
- # message type.
- "delete": "A String", # Maps to HTTP DELETE. Used for deleting a resource.
},
],
- "fullyDecodeReservedExpansion": True or False, # When set to true, URL path parameters will be fully URI-decoded except in
- # cases of single segment matches in reserved expansion, where "%2F" will be
- # left encoded.
+ },
+ "logs": [ # Defines the logs used by this service.
+ { # A description of a log type. Example in YAML format:
#
- # The default behavior is to not decode RFC 6570 reserved characters in multi
- # segment matches.
- },
- "billing": { # Billing related configuration of the service. # Billing configuration.
- #
- # The following example shows how to configure monitored resources and metrics
- # for billing, `consumer_destinations` is the only supported destination and
- # the monitored resources need at least one label key
- # `cloud.googleapis.com/location` to indicate the location of the billing
- # usage, using different monitored resources between monitoring and billing is
- # recommended so they can be evolved independently:
- #
- #
- # monitored_resources:
- # - type: library.googleapis.com/billing_branch
- # labels:
- # - key: cloud.googleapis.com/location
- # description: |
- # Predefined label to support billing location restriction.
- # - key: city
- # description: |
- # Custom label to define the city where the library branch is located
- # in.
- # - key: name
- # description: Custom label to define the name of the library branch.
- # metrics:
- # - name: library.googleapis.com/book/borrowed_count
- # metric_kind: DELTA
- # value_type: INT64
- # unit: "1"
- # billing:
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/billing_branch
- # metrics:
- # - library.googleapis.com/book/borrowed_count
- "consumerDestinations": [ # Billing configurations for sending metrics to the consumer project.
- # There can be multiple consumer destinations per service, each one must have
- # a different monitored resource type. A metric can be used in at most
- # one consumer destination.
- { # Configuration of a specific billing destination (Currently only support
- # bill against consumer project).
- "metrics": [ # Names of the metrics to report to this billing destination.
- # Each name must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
- },
- ],
- },
- "systemTypes": [ # 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.
- { # A protocol buffer message type.
- "fields": [ # The list of fields.
- { # A single field of a message type.
- "number": 42, # The field number.
- "name": "A String", # The field name.
- "kind": "A String", # The field type.
- "jsonName": "A String", # The field JSON name.
- "cardinality": "A String", # The field cardinality.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
- "packed": True or False, # Whether to use alternative packed wire representation.
- "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
- # types. The first type has index 1; zero means the type is not in the list.
- "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
- # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
- },
- ],
- "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
- "A String",
- ],
- "name": "A String", # The fully qualified message name.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax.
- "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- },
- ],
- "logging": { # Logging configuration of the service. # Logging configuration.
- #
- # The following example shows how to configure logs to be sent to the
- # 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: activity_history
- # labels:
- # - key: /customer_id
- # - name: purchase_history
- # logging:
- # producer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # logs:
- # - activity_history
- # - purchase_history
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # logs:
- # - activity_history
- "consumerDestinations": [ # 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.
- { # Configuration of a specific logging destination (the producer project
- # or the consumer project).
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
- # Service.monitored_resources section.
- "logs": [ # Names of the logs to be sent to this destination. Each name must
- # 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 "/".
- "A String",
- ],
- },
- ],
- "producerDestinations": [ # Logging configurations for sending logs to the producer project.
- # There can be multiple producer destinations, each one must have a
- # different monitored resource type. A log can be used in at most
- # one producer destination.
- { # Configuration of a specific logging destination (the producer project
- # or the consumer project).
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
- # Service.monitored_resources section.
- "logs": [ # Names of the logs to be sent to this destination. Each name must
- # 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 "/".
- "A String",
- ],
- },
- ],
- },
- "monitoredResources": [ # Defines the monitored resources used by this service. This is required
- # by the Service.monitoring and Service.logging configurations.
- { # An object that describes the schema of a MonitoredResource object using a
- # type name and a set of labels. For example, the monitored resource
- # descriptor for Google Compute Engine VM instances has a type of
- # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
- # `"zone"` to identify particular VM instances.
- #
- # Different APIs can support different monitored resource types. APIs generally
- # provide a `list` method that returns the monitored resource descriptors used
- # by the API.
- "launchStage": "A String", # Optional. The launch stage of the monitored resource definition.
- "name": "A String", # Optional. The resource name of the monitored resource descriptor:
- # `"projects/{project_id}/monitoredResourceDescriptors/{type}"` where
- # {type} is the value of the `type` field in this object and
- # {project_id} is a project ID that provides API-specific context for
- # accessing the type. APIs that do not use project information can use the
- # resource name format `"monitoredResourceDescriptors/{type}"`.
- "labels": [ # Required. A set of labels used to describe instances of this monitored
- # resource type. For example, an individual Google Cloud SQL database is
- # identified by values for the labels `"database_id"` and `"zone"`.
+ # - name: library.googleapis.com/activity_history
+ # description: The history of borrowing and returning library items.
+ # display_name: Activity
+ # labels:
+ # - key: /customer_id
+ # description: Identifier of a library customer
+ "description": "A String", # A human-readable description of this log. This information appears in
+ # the documentation and can contain details.
+ "labels": [ # The set of labels that are available to describe a specific log entry.
+ # Runtime requests that contain labels not specified here are
+ # considered invalid.
{ # A description of a label.
"valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
"description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
},
],
- "type": "A String", # Required. The monitored resource type. For example, the type
- # `"cloudsql_database"` represents databases in Google Cloud SQL.
- # The maximum length of this value is 256 characters.
- "description": "A String", # Optional. A detailed description of the monitored resource type that might
- # be used in documentation.
- "displayName": "A String", # Optional. A concise name for the monitored resource type that might be
- # displayed in user interfaces. It should be a Title Cased Noun Phrase,
- # without any article or other determiners. For example,
- # `"Google Cloud SQL Database"`.
+ "displayName": "A String", # The human-readable name for this log. This information appears on
+ # the user interface and should be concise.
+ "name": "A String", # The name of the log. It must be less than 512 characters long and can
+ # include the following characters: upper- and lower-case alphanumeric
+ # characters [A-Za-z0-9], and punctuation characters including
+ # slash, underscore, hyphen, period [/_-.].
},
],
- "monitoring": { # Monitoring configuration of the service. # Monitoring configuration.
- #
- # The example below shows how to configure monitored resources and metrics
- # for monitoring. In the example, a monitored resource and two metrics are
- # defined. The `library.googleapis.com/book/returned_count` metric is sent
- # to both producer and consumer projects, whereas the
- # `library.googleapis.com/book/overdue_count` metric is only sent to the
- # consumer 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.
- # metrics:
- # - name: library.googleapis.com/book/returned_count
- # metric_kind: DELTA
- # value_type: INT64
- # labels:
- # - key: /customer_id
- # - name: library.googleapis.com/book/overdue_count
- # metric_kind: GAUGE
- # value_type: INT64
- # labels:
- # - key: /customer_id
- # monitoring:
- # producer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # metrics:
- # - library.googleapis.com/book/returned_count
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # metrics:
- # - library.googleapis.com/book/returned_count
- # - library.googleapis.com/book/overdue_count
- "producerDestinations": [ # Monitoring configurations for sending metrics to the producer project.
- # There can be multiple producer destinations. A monitored resouce type may
- # appear in multiple monitoring destinations if different aggregations are
- # needed for different sets of metrics associated with that monitored
- # resource type. A monitored resource and metric pair may only be used once
- # in the Monitoring configuration.
- { # Configuration of a specific monitoring destination (the producer project
- # or the consumer project).
- "metrics": [ # Types of the metrics to report to this monitoring destination.
- # Each type must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
+ "metrics": [ # Defines the metrics used by this service.
+ { # 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.
+ #
+ # The following are specific rules for service defined Monitoring metric
+ # descriptors:
+ #
+ # * `type`, `metric_kind`, `value_type`, `description`, and `display_name`
+ # fields are all required. The `unit` field must be specified
+ # if the `value_type` is any of DOUBLE, INT64, DISTRIBUTION.
+ # * Maximum of default 500 metric descriptors per service is allowed.
+ # * Maximum of default 10 labels per metric descriptor is allowed.
+ #
+ # The default maximum limit can be overridden. Please follow
+ # https://cloud.google.com/monitoring/quotas
+ "unit": "A String", # The units in which the metric value is reported. It is only applicable
+ # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit`
+ # defines the representation of the stored metric values.
+ #
+ # Different systems may scale the values to be more easily displayed (so a
+ # value of `0.02KBy` _might_ be displayed as `20By`, and a value of
+ # `3523KBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is
+ # `KBy`, then the value of the metric is always in thousands of bytes, no
+ # matter how it may be displayed..
+ #
+ # If you want a custom metric to record the exact number of CPU-seconds used
+ # by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is
+ # `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005
+ # CPU-seconds, then the value is written as `12005`.
+ #
+ # Alternatively, if you want a custom metric to record data in a more
+ # granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
+ # `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`),
+ # or use `Kis{CPU}` and write `11.723` (which is `12005/1024`).
+ #
+ # The supported units are a subset of [The Unified Code for Units of
+ # Measure](http://unitsofmeasure.org/ucum.html) standard:
+ #
+ # **Basic units (UNIT)**
+ #
+ # * `bit` bit
+ # * `By` byte
+ # * `s` second
+ # * `min` minute
+ # * `h` hour
+ # * `d` day
+ # * `1` dimensionless
+ #
+ # **Prefixes (PREFIX)**
+ #
+ # * `k` kilo (10^3)
+ # * `M` mega (10^6)
+ # * `G` giga (10^9)
+ # * `T` tera (10^12)
+ # * `P` peta (10^15)
+ # * `E` exa (10^18)
+ # * `Z` zetta (10^21)
+ # * `Y` yotta (10^24)
+ #
+ # * `m` milli (10^-3)
+ # * `u` micro (10^-6)
+ # * `n` nano (10^-9)
+ # * `p` pico (10^-12)
+ # * `f` femto (10^-15)
+ # * `a` atto (10^-18)
+ # * `z` zepto (10^-21)
+ # * `y` yocto (10^-24)
+ #
+ # * `Ki` kibi (2^10)
+ # * `Mi` mebi (2^20)
+ # * `Gi` gibi (2^30)
+ # * `Ti` tebi (2^40)
+ # * `Pi` pebi (2^50)
+ #
+ # **Grammar**
+ #
+ # The grammar also includes these connectors:
+ #
+ # * `/` division or ratio (as an infix operator). For examples,
+ # `kBy/{email}` or `MiBy/10ms` (although you should almost never
+ # have `/s` in a metric `unit`; rates should always be computed at
+ # query time from the underlying cumulative or delta value).
+ # * `.` multiplication or composition (as an infix operator). For
+ # examples, `GBy.d` or `k{watt}.h`.
+ #
+ # The grammar for a unit is as follows:
+ #
+ # Expression = Component { "." Component } { "/" Component } ;
+ #
+ # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
+ # | Annotation
+ # | "1"
+ # ;
+ #
+ # Annotation = "{" NAME "}" ;
+ #
+ # Notes:
+ #
+ # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
+ # is used alone, then the unit is equivalent to `1`. For examples,
+ # `{request}/s == 1/s`, `By{transmitted}/s == By/s`.
+ # * `NAME` is a sequence of non-blank printable ASCII characters not
+ # containing `{` or `}`.
+ # * `1` represents a unitary [dimensionless
+ # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
+ # as in `1/s`. It is typically used when none of the basic units are
+ # appropriate. For example, "new users per day" can be represented as
+ # `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new
+ # users). Alternatively, "thousands of page views per day" would be
+ # represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric
+ # value of `5.3` would mean "5300 page views per day").
+ # * `%` represents dimensionless value of 1/100, and annotates values giving
+ # a percentage (so the metric values are typically in the range of 0..100,
+ # and a metric value `3` means "3 percent").
+ # * `10^2.%` indicates a metric contains a ratio, typically in the range
+ # 0..1, that will be multiplied by 100 and displayed as a percentage
+ # (so a metric value `0.03` means "3 percent").
+ "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
+ # Use sentence case without an ending period, for example "Request count".
+ # This field is optional but it is recommended to be set for any metrics
+ # associated with user-visible concepts, such as Quota.
+ "monitoredResourceTypes": [ # Read-only. If present, then a time
+ # series, which is identified partially by
+ # a metric type and a MonitoredResourceDescriptor, that is associated
+ # with this metric type can only be associated with one of the monitored
+ # resource types listed here.
+ "A String",
+ ],
+ "metadata": { # Additional annotations that can be used to guide the usage of a metric. # Optional. Metadata which can be used to guide usage of the metric.
+ "samplePeriod": "A String", # The sampling period of metric data points. For metrics which are written
+ # periodically, consecutive data points are stored at this time interval,
+ # excluding data loss due to errors. Metrics with a higher granularity have
+ # a smaller sampling period.
+ "ingestDelay": "A String", # The delay of data points caused by ingestion. Data points older than this
+ # age are guaranteed to be ingested and available to be read, excluding
+ # data loss due to errors.
+ "launchStage": "A String", # Deprecated. Must use the MetricDescriptor.launch_stage instead.
},
- ],
- "consumerDestinations": [ # Monitoring configurations for sending metrics to the consumer project.
- # There can be multiple consumer destinations. A monitored resouce type may
- # appear in multiple monitoring destinations if different aggregations are
- # needed for different sets of metrics associated with that monitored
- # resource type. A monitored resource and metric pair may only be used once
- # in the Monitoring configuration.
- { # Configuration of a specific monitoring destination (the producer project
- # or the consumer project).
- "metrics": [ # Types of the metrics to report to this monitoring destination.
- # Each type must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
- },
- ],
- },
- "systemParameters": { # ### System parameter configuration # System parameter configuration.
+ "name": "A String", # The resource name of the metric descriptor.
+ "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
+ # Some combinations of `metric_kind` and `value_type` might not be supported.
+ "launchStage": "A String", # Optional. The launch stage of the metric definition.
+ "type": "A String", # The metric type, including its DNS name prefix. The type is not
+ # URL-encoded.
+ #
+ # All service defined metrics must be prefixed with the service name, in the
+ # format of `{service name}/{relative metric name}`, such as
+ # `cloudsql.googleapis.com/database/cpu/utilization`. The relative metric
+ # name must follow:
+ #
+ # * Only upper and lower-case letters, digits, '/' and underscores '_' are
+ # allowed.
+ # * The maximum number of characters allowed for the relative_metric_name is
+ # 100.
+ #
+ # All user-defined metric types have the DNS name
+ # `custom.googleapis.com`, `external.googleapis.com`, or
+ # `logging.googleapis.com/user/`.
+ #
+ # Metric types should use a natural hierarchical grouping. For example:
+ #
+ # "custom.googleapis.com/invoice/paid/amount"
+ # "external.googleapis.com/prometheus/up"
+ # "appengine.googleapis.com/http/server/response_latencies"
+ "description": "A String", # A detailed description of the metric, which can be used in documentation.
+ "labels": [ # The set of labels that can be used to describe a specific
+ # instance of this metric type.
+ #
+ # The label key name must follow:
+ #
+ # * Only upper and lower-case letters, digits and underscores (_) are
+ # allowed.
+ # * Label name must start with a letter or digit.
+ # * The maximum length of a label name is 100 characters.
+ #
+ # 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.
+ { # A description of a label.
+ "valueType": "A String", # The type of data that can be assigned to the label.
+ "description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
+ },
+ ],
+ "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc.
+ # Some combinations of `metric_kind` and `value_type` might not be supported.
+ },
+ ],
+ "documentation": { # `Documentation` provides the information for describing a service. # Additional API documentation.
#
- # A system parameter is a special kind of parameter defined by the API
- # system, not by an individual API. It is typically mapped to an HTTP header
- # and/or a URL query parameter. This configuration specifies which methods
- # change the names of the system parameters.
- "rules": [ # Define system parameters.
- #
- # The parameters defined here will override the default parameters
- # implemented by the system. If this field is missing from the service
- # config, default system parameters will be used. Default system parameters
- # and names is implementation-dependent.
- #
- # Example: define api key for all methods
- #
- # system_parameters
- # rules:
- # - selector: "*"
- # parameters:
- # - name: api_key
- # url_query_parameter: api_key
- #
- #
- # Example: define 2 api key names for a specific method.
- #
- # system_parameters
- # rules:
- # - selector: "/ListShelves"
- # parameters:
- # - name: api_key
- # http_header: Api-Key1
- # - name: api_key
- # http_header: Api-Key2
+ # Example:
+ # <pre><code>documentation:
+ # summary: >
+ # The Google Calendar API gives access
+ # to most calendar features.
+ # pages:
+ # - name: Overview
+ # content: &#40;== include google/foo/overview.md ==&#41;
+ # - name: Tutorial
+ # content: &#40;== include google/foo/tutorial.md ==&#41;
+ # subpages;
+ # - name: Java
+ # content: &#40;== include google/foo/tutorial_java.md ==&#41;
+ # rules:
+ # - selector: google.calendar.Calendar.Get
+ # description: >
+ # ...
+ # - selector: google.calendar.Calendar.Put
+ # description: >
+ # ...
+ # </code></pre>
+ # Documentation is provided in markdown syntax. In addition to
+ # standard markdown features, definition lists, tables and fenced
+ # code blocks are supported. Section headers can be provided and are
+ # interpreted relative to the section nesting of the context where
+ # a documentation fragment is embedded.
+ #
+ # Documentation from the IDL is merged with documentation defined
+ # via the config at normalization time, where documentation provided
+ # by config rules overrides IDL provided.
+ #
+ # A number of constructs specific to the API platform are supported
+ # in documentation text.
+ #
+ # In order to reference a proto element, the following
+ # notation can be used:
+ # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
+ # To override the display text used for the link, this can be used:
+ # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
+ # Text can be excluded from doc using the following notation:
+ # <pre><code>&#40;-- internal comment --&#41;</code></pre>
+ #
+ # A few directives are available in documentation. Note that
+ # directives must appear on a single line to be properly
+ # identified. The `include` directive includes a markdown file from
+ # an external source:
+ # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
+ # The `resource_for` directive marks a message to be the resource of
+ # a collection in REST view. If it is not specified, tools attempt
+ # to infer the resource from the operations in a collection:
+ # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
+ # The directive `suppress_warning` does not directly affect documentation
+ # and is documented together with service config validation.
+ "serviceRootUrl": "A String", # Specifies the service root url if the default one (the service name
+ # from the yaml file) is not suitable. This can be seen in any fully
+ # specified service urls as well as sections that show a base that other
+ # urls are relative to.
+ "overview": "A String", # Declares a single overview page. For example:
+ # <pre><code>documentation:
+ # summary: ...
+ # overview: &#40;== include overview.md ==&#41;
+ # </code></pre>
+ # This is a shortcut for the following declaration (using pages style):
+ # <pre><code>documentation:
+ # summary: ...
+ # pages:
+ # - name: Overview
+ # content: &#40;== include overview.md ==&#41;
+ # </code></pre>
+ # Note: you cannot specify both `overview` field and `pages` field.
+ "documentationRootUrl": "A String", # The URL to the root of documentation.
+ "rules": [ # A list of documentation rules that apply to individual API elements.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
- { # Define a system parameter rule mapping system parameter definitions to
- # methods.
- "parameters": [ # Define parameters. Multiple names may be defined for a parameter.
- # For a given method call, only one of them should be used. If multiple
- # names are used the behavior is implementation-dependent.
- # If none of the specified names are present the behavior is
- # parameter-dependent.
- { # Define a parameter's name and location. The parameter may be passed as either
- # an HTTP header or a URL query parameter, and if both are passed the behavior
- # is implementation-dependent.
- "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
- "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
- # sensitive.
- "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
- # insensitive.
- },
- ],
- "selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
- # methods in all APIs.
- #
- # Refer to selector for syntax details.
+ { # A documentation rule provides information about individual API elements.
+ "deprecationDescription": "A String", # Deprecation description of the selected element(s). It can be provided if
+ # an element is marked as `deprecated`.
+ "description": "A String", # Description of the selected API(s).
+ "selector": "A String", # The selector is a comma-separated list of patterns. Each pattern is a
+ # qualified name of the element which may end in "*", indicating a wildcard.
+ # Wildcards are only allowed at the end and for a whole component of the
+ # qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A
+ # wildcard will match one or more components. To specify a default for all
+ # applicable elements, the whole pattern "*" is used.
},
],
+ "pages": [ # The top level pages for the documentation set.
+ { # Represents a documentation page. A page can contain subpages to represent
+ # nested documentation set structure.
+ "content": "A String", # The Markdown content of the page. You can use <code>&#40;== include {path}
+ # ==&#41;</code> to include content from a Markdown file.
+ "name": "A String", # The name of the page. It will be used as an identity of the page to
+ # generate URI of the page, text of the link to this page in navigation,
+ # etc. The full page name (start from the root page name to this page
+ # concatenated with `.`) can be used as reference to the page in your
+ # documentation. For example:
+ # <pre><code>pages:
+ # - name: Tutorial
+ # content: &#40;== include tutorial.md ==&#41;
+ # subpages:
+ # - name: Java
+ # content: &#40;== include tutorial_java.md ==&#41;
+ # </code></pre>
+ # You can reference `Java` page using Markdown reference link syntax:
+ # `Java`.
+ "subpages": [ # Subpages of this page. The order of subpages specified here will be
+ # honored in the generated docset.
+ # Object with schema name: Page
+ ],
+ },
+ ],
+ "summary": "A String", # A short summary of what the service does. Can only be provided by
+ # plain text.
},
+ "configVersion": 42, # The semantic version of the service configuration. The config version
+ # affects the interpretation of the service configuration. For example,
+ # certain features are enabled by default for certain config versions.
+ #
+ # The latest config version is `3`.
"quota": { # Quota configuration helps to achieve fairness and budgeting in service # Quota configuration.
# usage.
#
@@ -5515,23 +5293,32 @@
# metric_kind: DELTA
# value_type: INT64
#
+ "metricRules": [ # List of `MetricRule` definitions, each one mapping a selected method to one
+ # or more metrics.
+ { # Bind API methods to metrics. Binding a method to a metric causes that
+ # metric's configured quota behaviors to apply to the method call.
+ "selector": "A String", # Selects the methods to which this rule applies.
+ #
+ # Refer to selector for syntax details.
+ "metricCosts": { # Metrics to update when the selected methods are called, and the associated
+ # cost applied to each metric.
+ #
+ # The key of the map is the metric name, and the values are the amount
+ # increased for the metric against which the quota limits are defined.
+ # The value must not be negative.
+ "a_key": "A String",
+ },
+ },
+ ],
"limits": [ # List of `QuotaLimit` definitions for the service.
{ # `QuotaLimit` defines a specific limit that applies over a specified duration
# for a limit type. There can be at most one limit for a duration and limit
# type combination defined within a `QuotaGroup`.
- "displayName": "A String", # User-visible display name for this limit.
- # Optional. If not set, the UI will provide a default display name based on
- # the quota configuration. This field can be used to override the default
- # display name generated from the configuration.
- "maxLimit": "A String", # Maximum number of tokens that can be consumed during the specified
- # duration. Client application developers can override the default limit up
- # to this maximum. If specified, this value cannot be set to a value less
- # than the default limit. If not specified, it is set to the default limit.
- #
- # To allow clients to apply overrides with no upper bound, set this to -1,
- # indicating unlimited maximum quota.
- #
- # Used by group-based quotas only.
+ "values": { # Tiered limit values. You must specify this as a key:value pair, with an
+ # integer value that is the maximum number of requests allowed for the
+ # specified unit. Currently only STANDARD is supported.
+ "a_key": "A String",
+ },
"duration": "A String", # Duration of this limit in textual notation. Must be "100s" or "1d".
#
# Used by group-based quotas only.
@@ -5543,15 +5330,13 @@
# defaults to 0, indicating that there is no free tier for this service.
#
# Used by group-based quotas only.
- "unit": "A String", # Specify the unit of the quota limit. It uses the same syntax as
- # Metric.unit. The supported unit kinds are determined by the quota
- # backend system.
- #
- # Here are some examples:
- # * "1/min/{project}" for quota per minute per project.
- #
- # Note: the order of unit components is insignificant.
- # The "1" at the beginning is required to follow the metric unit syntax.
+ "displayName": "A String", # User-visible display name for this limit.
+ # Optional. If not set, the UI will provide a default display name based on
+ # the quota configuration. This field can be used to override the default
+ # display name generated from the configuration.
+ "description": "A String", # Optional. User-visible, extended description for this quota limit.
+ # Should be used only when more context is needed to understand this limit
+ # than provided by the limit's display name (see: `display_name`).
"defaultLimit": "A String", # Default number of tokens that can be consumed during the specified
# duration. This is the number of tokens assigned when a client
# application developer activates the service for his/her project.
@@ -5562,43 +5347,568 @@
# negative values are allowed.
#
# Used by group-based quotas only.
- "values": { # Tiered limit values. You must specify this as a key:value pair, with an
- # integer value that is the maximum number of requests allowed for the
- # specified unit. Currently only STANDARD is supported.
- "a_key": "A String",
- },
"name": "A String", # Name of the quota limit.
#
# The name must be provided, and it must be unique within the service. The
# name can only include alphanumeric characters as well as '-'.
#
# The maximum length of the limit name is 64 characters.
+ "maxLimit": "A String", # Maximum number of tokens that can be consumed during the specified
+ # duration. Client application developers can override the default limit up
+ # to this maximum. If specified, this value cannot be set to a value less
+ # than the default limit. If not specified, it is set to the default limit.
+ #
+ # To allow clients to apply overrides with no upper bound, set this to -1,
+ # indicating unlimited maximum quota.
+ #
+ # Used by group-based quotas only.
"metric": "A String", # The name of the metric this quota limit applies to. The quota limits with
# the same metric will be checked together during runtime. The metric must be
# defined within the service config.
- "description": "A String", # Optional. User-visible, extended description for this quota limit.
- # Should be used only when more context is needed to understand this limit
- # than provided by the limit's display name (see: `display_name`).
+ "unit": "A String", # Specify the unit of the quota limit. It uses the same syntax as
+ # Metric.unit. The supported unit kinds are determined by the quota
+ # backend system.
+ #
+ # Here are some examples:
+ # * "1/min/{project}" for quota per minute per project.
+ #
+ # Note: the order of unit components is insignificant.
+ # The "1" at the beginning is required to follow the metric unit syntax.
},
],
- "metricRules": [ # List of `MetricRule` definitions, each one mapping a selected method to one
- # or more metrics.
- { # Bind API methods to metrics. Binding a method to a metric causes that
- # metric's configured quota behaviors to apply to the method call.
- "metricCosts": { # Metrics to update when the selected methods are called, and the associated
- # cost applied to each metric.
+ },
+ "customError": { # Customize service error responses. For example, list any service # Custom error configuration.
+ # specific protobuf types that can appear in error detail lists of
+ # error responses.
+ #
+ # Example:
+ #
+ # custom_error:
+ # types:
+ # - google.foo.v1.CustomError
+ # - google.foo.v1.AnotherError
+ "types": [ # The list of custom error detail types, e.g. 'google.foo.v1.CustomError'.
+ "A String",
+ ],
+ "rules": [ # The list of custom error rules that apply to individual API messages.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # A custom error rule.
+ "selector": "A String", # Selects messages to which this rule applies.
#
- # The key of the map is the metric name, and the values are the amount
- # increased for the metric against which the quota limits are defined.
- # The value must not be negative.
- "a_key": "A String",
+ # Refer to selector for syntax details.
+ "isErrorType": True or False, # Mark this message as possible payload in error response. Otherwise,
+ # objects of this type will be filtered when they appear in error payload.
+ },
+ ],
+ },
+ "authentication": { # `Authentication` defines the authentication configuration for an API. # Auth configuration.
+ #
+ # Example for an API targeted for external use:
+ #
+ # name: calendar.googleapis.com
+ # authentication:
+ # providers:
+ # - id: google_calendar_auth
+ # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+ # issuer: https://securetoken.google.com
+ # rules:
+ # - selector: "*"
+ # requirements:
+ # provider_id: google_calendar_auth
+ "rules": [ # A list of authentication rules that apply to individual API methods.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # Authentication rules for the service.
+ #
+ # By default, if a method has any authentication requirements, every request
+ # must include a valid credential matching one of the requirements.
+ # It's an error to include more than one kind of credential in a single
+ # request.
+ #
+ # If a method doesn't have any auth requirements, request credentials will be
+ # ignored.
+ "oauth": { # OAuth scopes are a way to define data and permissions on data. For example, # The requirements for OAuth credentials.
+ # there are scopes defined for "Read-only access to Google Calendar" and
+ # "Access to Cloud Platform". Users can consent to a scope for an application,
+ # giving it permission to access that data on their behalf.
+ #
+ # OAuth scope specifications should be fairly coarse grained; a user will need
+ # to see and understand the text description of what your scope means.
+ #
+ # In most cases: use one or at most two OAuth scopes for an entire family of
+ # products. If your product has multiple APIs, you should probably be sharing
+ # the OAuth scope across all of those APIs.
+ #
+ # When you need finer grained OAuth consent screens: talk with your product
+ # management about how developers will use them in practice.
+ #
+ # Please note that even though each of the canonical scopes is enough for a
+ # request to be accepted and passed to the backend, a request can still fail
+ # due to the backend requiring additional scopes or permissions.
+ "canonicalScopes": "A String", # The list of publicly documented OAuth scopes that are allowed access. An
+ # OAuth token containing any of these scopes will be accepted.
+ #
+ # Example:
+ #
+ # canonical_scopes: https://www.googleapis.com/auth/calendar,
+ # https://www.googleapis.com/auth/calendar.read
},
+ "requirements": [ # Requirements for additional authentication providers.
+ { # User-defined authentication requirements, including support for
+ # [JSON Web Token
+ # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
+ "providerId": "A String", # id from authentication provider.
+ #
+ # Example:
+ #
+ # provider_id: bookstore_auth
+ "audiences": "A String", # 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:
+ #
+ # audiences: bookstore_android.apps.googleusercontent.com,
+ # bookstore_web.apps.googleusercontent.com
+ },
+ ],
+ "allowWithoutCredential": True or False, # If true, the service accepts API keys without any other credential.
"selector": "A String", # Selects the methods to which this rule applies.
#
# Refer to selector for syntax details.
},
],
+ "providers": [ # Defines a set of authentication providers that a service supports.
+ { # Configuration for an authentication provider, including support for
+ # [JSON Web Token
+ # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
+ "id": "A String", # The unique identifier of the auth provider. It will be referred to by
+ # `AuthRequirement.provider_id`.
+ #
+ # Example: "bookstore_auth".
+ "issuer": "A String", # 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.
+ #
+ # Example: https://securetoken.google.com
+ # Example: 1234567-compute@developer.gserviceaccount.com
+ "jwksUri": "A String", # URL of the provider's public key set to validate signature of the JWT. See
+ # [OpenID
+ # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).
+ # Optional if the key set document:
+ # - can be retrieved from
+ # [OpenID
+ # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
+ # the issuer.
+ # - can be inferred from the email domain of the issuer (e.g. a Google
+ # service account).
+ #
+ # Example: https://www.googleapis.com/oauth2/v1/certs
+ "audiences": "A String", # 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, JWTs with audiences:
+ # - "https://[service.name]/[google.protobuf.Api.name]"
+ # - "https://[service.name]/"
+ # will be accepted.
+ # For example, if no audiences are in the setting, LibraryService API will
+ # accept JWTs with the following audiences:
+ # -
+ # https://library-example.googleapis.com/google.example.library.v1.LibraryService
+ # - https://library-example.googleapis.com/
+ #
+ # Example:
+ #
+ # audiences: bookstore_android.apps.googleusercontent.com,
+ # bookstore_web.apps.googleusercontent.com
+ "authorizationUrl": "A String", # Redirect URL if JWT token is required but not present or is expired.
+ # Implement authorizationUrl of securityDefinitions in OpenAPI spec.
+ "jwtLocations": [ # Defines the locations to extract the JWT.
+ #
+ # JWT locations can be either from HTTP headers or URL query parameters.
+ # The rule is that the first match wins. The checking order is: checking
+ # all headers first, then URL query parameters.
+ #
+ # If not specified, default to use following 3 locations:
+ # 1) Authorization: Bearer
+ # 2) x-goog-iap-jwt-assertion
+ # 3) access_token query parameter
+ #
+ # Default locations can be specified as followings:
+ # jwt_locations:
+ # - header: Authorization
+ # value_prefix: "Bearer "
+ # - header: x-goog-iap-jwt-assertion
+ # - query: access_token
+ { # Specifies a location to extract JWT from an API request.
+ "query": "A String", # Specifies URL query parameter name to extract JWT token.
+ "valuePrefix": "A String", # The value prefix. The value format is "value_prefix{token}"
+ # Only applies to "in" header type. Must be empty for "in" query type.
+ # If not empty, the header value has to match (case sensitive) this prefix.
+ # If not matched, JWT will not be extracted. If matched, JWT will be
+ # extracted after the prefix is removed.
+ #
+ # For example, for "Authorization: Bearer {JWT}",
+ # value_prefix="Bearer " with a space at the end.
+ "header": "A String", # Specifies HTTP header name to extract JWT token.
+ },
+ ],
+ },
+ ],
},
+ "title": "A String", # The product title for this service.
+ "producerProjectId": "A String", # The Google project that owns this service.
+ "apis": [ # 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.
+ { # Api is a light-weight descriptor for an API Interface.
+ #
+ # Interfaces are also described as "protocol buffer services" in some contexts,
+ # such as by the "service" keyword in a .proto file, but they are different
+ # from API Services, which represent a concrete implementation of an interface
+ # as opposed to simply a description of methods and bindings. They are also
+ # sometimes simply referred to as "APIs" in other contexts, such as the name of
+ # this message itself. See https://cloud.google.com/apis/design/glossary for
+ # detailed terminology.
+ "sourceContext": { # `SourceContext` represents information about the source of a # Source context for the protocol buffer service represented by this
+ # message.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "syntax": "A String", # The source syntax of the service.
+ "methods": [ # The methods of this interface, in unspecified order.
+ { # Method represents a method of an API interface.
+ "options": [ # Any metadata attached to the method.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "responseStreaming": True or False, # If true, the response is streamed.
+ "syntax": "A String", # The source syntax of this method.
+ "requestTypeUrl": "A String", # A URL of the input message type.
+ "name": "A String", # The simple name of this method.
+ "responseTypeUrl": "A String", # The URL of the output message type.
+ "requestStreaming": True or False, # If true, the request is streamed.
+ },
+ ],
+ "name": "A String", # The fully qualified name of this interface, including package name
+ # followed by the interface's simple name.
+ "version": "A String", # A version string for this interface. If specified, must have the form
+ # `major-version.minor-version`, as in `1.10`. If the minor version is
+ # omitted, it defaults to zero. If the entire version field is empty, the
+ # major version is derived from the package name, as outlined below. If the
+ # field is not empty, the version in the package name will be verified to be
+ # consistent with what is provided here.
+ #
+ # The versioning schema uses [semantic
+ # versioning](http://semver.org) where the major version number
+ # indicates a breaking change and the minor version an additive,
+ # non-breaking change. Both version numbers are signals to users
+ # what to expect from different versions, and should be carefully
+ # chosen based on the product plan.
+ #
+ # The major version is also reflected in the package name of the
+ # interface, which must end in `v<major-version>`, as in
+ # `google.feature.v1`. For major versions 0 and 1, the suffix can
+ # be omitted. Zero major versions must only be used for
+ # experimental, non-GA interfaces.
+ "options": [ # Any metadata attached to the interface.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "mixins": [ # Included interfaces. See Mixin.
+ { # Declares an API Interface to be included in this interface. The including
+ # interface must redeclare all the methods from the included interface, but
+ # documentation and options are inherited as follows:
+ #
+ # - If after comment and whitespace stripping, the documentation
+ # string of the redeclared method is empty, it will be inherited
+ # from the original method.
+ #
+ # - Each annotation belonging to the service config (http,
+ # visibility) which is not set in the redeclared method will be
+ # inherited.
+ #
+ # - If an http annotation is inherited, the path pattern will be
+ # modified as follows. Any version prefix will be replaced by the
+ # version of the including interface plus the root path if
+ # specified.
+ #
+ # Example of a simple mixin:
+ #
+ # package google.acl.v1;
+ # service AccessControl {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v1/{resource=**}:getAcl";
+ # }
+ # }
+ #
+ # package google.storage.v2;
+ # service Storage {
+ # // rpc GetAcl(GetAclRequest) returns (Acl);
+ #
+ # // Get a data record.
+ # rpc GetData(GetDataRequest) returns (Data) {
+ # option (google.api.http).get = "/v2/{resource=**}";
+ # }
+ # }
+ #
+ # Example of a mixin configuration:
+ #
+ # apis:
+ # - name: google.storage.v2.Storage
+ # mixins:
+ # - name: google.acl.v1.AccessControl
+ #
+ # The mixin construct implies that all methods in `AccessControl` are
+ # also declared with same name and request/response types in
+ # `Storage`. A documentation generator or annotation processor will
+ # see the effective `Storage.GetAcl` method after inherting
+ # documentation and annotations as follows:
+ #
+ # service Storage {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v2/{resource=**}:getAcl";
+ # }
+ # ...
+ # }
+ #
+ # Note how the version in the path pattern changed from `v1` to `v2`.
+ #
+ # If the `root` field in the mixin is specified, it should be a
+ # relative path under which inherited HTTP paths are placed. Example:
+ #
+ # apis:
+ # - name: google.storage.v2.Storage
+ # mixins:
+ # - name: google.acl.v1.AccessControl
+ # root: acls
+ #
+ # This implies the following inherited HTTP annotation:
+ #
+ # service Storage {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v2/acls/{resource=**}:getAcl";
+ # }
+ # ...
+ # }
+ "root": "A String", # If non-empty specifies a path under which inherited HTTP paths
+ # are rooted.
+ "name": "A String", # The fully qualified name of the interface which is included.
+ },
+ ],
+ },
+ ],
+ "id": "A String", # A unique ID for a specific instance of this message, typically assigned
+ # by the client for tracking purpose. Must be no longer than 63 characters
+ # and only lower case letters, digits, '.', '_' and '-' are allowed. If
+ # empty, the server may choose to generate one instead.
+ "endpoints": [ # Configuration for network endpoints. If this is empty, then an endpoint
+ # with the same name as the service is automatically generated to service all
+ # defined APIs.
+ { # `Endpoint` describes a network endpoint that serves a set of APIs.
+ # A service may expose any number of endpoints, and all endpoints share the
+ # same service configuration, such as quota configuration and monitoring
+ # configuration.
+ #
+ # Example service configuration:
+ #
+ # name: library-example.googleapis.com
+ # endpoints:
+ # # Below entry makes 'google.example.library.v1.Library'
+ # # API be served from endpoint address library-example.googleapis.com.
+ # # It also allows HTTP OPTIONS calls to be passed to the backend, for
+ # # it to decide whether the subsequent cross-origin request is
+ # # allowed to proceed.
+ # - name: library-example.googleapis.com
+ # allow_cors: true
+ "name": "A String", # The canonical name of this endpoint.
+ "allowCors": True or False, # Allowing
+ # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
+ # cross-domain traffic, would allow the backends served from this endpoint to
+ # receive and respond to HTTP OPTIONS requests. The response will be used by
+ # the browser to determine whether the subsequent cross-origin request is
+ # allowed to proceed.
+ "target": "A String", # The specification of an Internet routable address of API frontend that will
+ # handle requests to this [API
+ # Endpoint](https://cloud.google.com/apis/design/glossary). It should be
+ # either a valid IPv4 address or a fully-qualified domain name. For example,
+ # "8.8.8.8" or "myservice.appspot.com".
+ "aliases": [ # DEPRECATED: This field is no longer supported. Instead of using aliases,
+ # please specify multiple google.api.Endpoint for each of the intended
+ # aliases.
+ #
+ # Additional names that this endpoint will be hosted on.
+ "A String",
+ ],
+ },
+ ],
+ "systemParameters": { # ### System parameter configuration # System parameter configuration.
+ #
+ # A system parameter is a special kind of parameter defined by the API
+ # system, not by an individual API. It is typically mapped to an HTTP header
+ # and/or a URL query parameter. This configuration specifies which methods
+ # change the names of the system parameters.
+ "rules": [ # Define system parameters.
+ #
+ # The parameters defined here will override the default parameters
+ # implemented by the system. If this field is missing from the service
+ # config, default system parameters will be used. Default system parameters
+ # and names is implementation-dependent.
+ #
+ # Example: define api key for all methods
+ #
+ # system_parameters
+ # rules:
+ # - selector: "*"
+ # parameters:
+ # - name: api_key
+ # url_query_parameter: api_key
+ #
+ #
+ # Example: define 2 api key names for a specific method.
+ #
+ # system_parameters
+ # rules:
+ # - selector: "/ListShelves"
+ # parameters:
+ # - name: api_key
+ # http_header: Api-Key1
+ # - name: api_key
+ # http_header: Api-Key2
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # Define a system parameter rule mapping system parameter definitions to
+ # methods.
+ "parameters": [ # Define parameters. Multiple names may be defined for a parameter.
+ # For a given method call, only one of them should be used. If multiple
+ # names are used the behavior is implementation-dependent.
+ # If none of the specified names are present the behavior is
+ # parameter-dependent.
+ { # Define a parameter's name and location. The parameter may be passed as either
+ # an HTTP header or a URL query parameter, and if both are passed the behavior
+ # is implementation-dependent.
+ "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
+ "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
+ # insensitive.
+ "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
+ # sensitive.
+ },
+ ],
+ "selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
+ # methods in all APIs.
+ #
+ # Refer to selector for syntax details.
+ },
+ ],
+ },
+ "monitoredResources": [ # Defines the monitored resources used by this service. This is required
+ # by the Service.monitoring and Service.logging configurations.
+ { # An object that describes the schema of a MonitoredResource object using a
+ # type name and a set of labels. For example, the monitored resource
+ # descriptor for Google Compute Engine VM instances has a type of
+ # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
+ # `"zone"` to identify particular VM instances.
+ #
+ # Different services can support different monitored resource types.
+ #
+ # The following are specific rules to service defined monitored resources for
+ # Monitoring and Logging:
+ #
+ # * The `type`, `display_name`, `description`, `labels` and `launch_stage`
+ # fields are all required.
+ # * The first label of the monitored resource descriptor must be
+ # `resource_container`. There are legacy monitored resource descritptors
+ # start with `project_id`.
+ # * It must include a `location` label.
+ # * Maximum of default 5 service defined monitored resource descriptors
+ # is allowed per service.
+ # * Maximum of default 10 labels per monitored resource is allowed.
+ #
+ # The default maximum limit can be overridden. Please follow
+ # https://cloud.google.com/monitoring/quotas
+ "name": "A String", # Optional. The resource name of the monitored resource descriptor:
+ # `"projects/{project_id}/monitoredResourceDescriptors/{type}"` where
+ # {type} is the value of the `type` field in this object and
+ # {project_id} is a project ID that provides API-specific context for
+ # accessing the type. APIs that do not use project information can use the
+ # resource name format `"monitoredResourceDescriptors/{type}"`.
+ "launchStage": "A String", # Optional. The launch stage of the monitored resource definition.
+ "displayName": "A String", # Optional. A concise name for the monitored resource type that might be
+ # displayed in user interfaces. It should be a Title Cased Noun Phrase,
+ # without any article or other determiners. For example,
+ # `"Google Cloud SQL Database"`.
+ "labels": [ # Required. A set of labels used to describe instances of this monitored
+ # resource type.
+ # The label key name must follow:
+ #
+ # * Only upper and lower-case letters, digits and underscores (_) are
+ # allowed.
+ # * Label name must start with a letter or digit.
+ # * The maximum length of a label name is 100 characters.
+ #
+ # For example, an individual Google Cloud SQL database is
+ # identified by values for the labels `database_id` and `location`.
+ { # A description of a label.
+ "valueType": "A String", # The type of data that can be assigned to the label.
+ "description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
+ },
+ ],
+ "description": "A String", # Optional. A detailed description of the monitored resource type that might
+ # be used in documentation.
+ "type": "A String", # Required. The monitored resource type. For example, the type
+ # `cloudsql_database` represents databases in Google Cloud SQL.
+ #
+ # All service defined monitored resource types must be prefixed with the
+ # service name, in the format of `{service name}/{relative resource name}`.
+ # The relative resource name must follow:
+ #
+ # * Only upper and lower-case letters and digits are allowed.
+ # * It must start with upper case character and is recommended to use Upper
+ # Camel Case style.
+ # * The maximum number of characters allowed for the relative_resource_name
+ # is 100.
+ #
+ # Note there are legacy service monitored resources not following this rule.
+ },
+ ],
"context": { # `Context` defines which contexts an API requests. # Context configuration.
#
# Example:
@@ -5640,14 +5950,6 @@
# **NOTE:** All service configuration rules follow "last one wins" order.
{ # A context rule provides information about the context for an individual API
# element.
- "allowedRequestExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
- # side channel from client to backend.
- "A String",
- ],
- "allowedResponseExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
- # side channel from backend to client.
- "A String",
- ],
"selector": "A String", # Selects the methods to which this rule applies.
#
# Refer to selector for syntax details.
@@ -5657,73 +5959,14 @@
"provided": [ # A list of full type names of provided contexts.
"A String",
],
- },
- ],
- },
- "producerProjectId": "A String", # The Google project that owns this service.
- "backend": { # `Backend` defines the backend configuration for a service. # API backend configuration.
- "rules": [ # A list of API backend rules that apply to individual API methods.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A backend rule provides configuration for an individual API element.
- "operationDeadline": 3.14, # The number of seconds to wait for the completion of a long running
- # operation. The default is no deadline.
- "minDeadline": 3.14, # Minimum deadline in seconds needed for this method. Calls having deadline
- # value lower than this will be rejected.
- "address": "A String", # The address of the API backend.
- #
- # The scheme is used to determine the backend protocol and security.
- # The following schemes are accepted:
- #
- # SCHEME PROTOCOL SECURITY
- # http:// HTTP None
- # https:// HTTP TLS
- # grpc:// gRPC None
- # grpcs:// gRPC TLS
- #
- # It is recommended to explicitly include a scheme. Leaving out the scheme
- # may cause constrasting behaviors across platforms.
- #
- # If the port is unspecified, the default is:
- # - 80 for schemes without TLS
- # - 443 for schemes with TLS
- #
- # For HTTP backends, use protocol
- # to specify the protocol version.
- "pathTranslation": "A String",
- "selector": "A String", # Selects the methods to which this rule applies.
- #
- # Refer to selector for syntax details.
- "jwtAudience": "A String", # The JWT audience is used when generating a JWT ID token for the backend.
- # This ID token will be added in the HTTP "authorization" header, and sent
- # to the backend.
- "disableAuth": True or False, # When disable_auth is true, a JWT ID token won't be generated and the
- # original "Authorization" HTTP header will be preserved. If the header is
- # used to carry the original token and is expected by the backend, this
- # field must be set to true to preserve the header.
- "deadline": 3.14, # The number of seconds to wait for a response from a request. The default
- # varies based on the request protocol and deployment environment.
- "protocol": "A String", # The protocol used for sending a request to the backend.
- # The supported values are "http/1.1" and "h2".
- #
- # The default value is inferred from the scheme in the
- # address field:
- #
- # SCHEME PROTOCOL
- # http:// http/1.1
- # https:// http/1.1
- # grpc:// h2
- # grpcs:// h2
- #
- # For secure HTTP backends (https://) that support HTTP/2, set this field
- # to "h2" for improved performance.
- #
- # Configuring this field to non-default values is only supported for secure
- # HTTP backends. This field will be ignored for all other backends.
- #
- # See
- # https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
- # for more details on the supported values.
+ "allowedRequestExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
+ # side channel from client to backend.
+ "A String",
+ ],
+ "allowedResponseExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
+ # side channel from backend to client.
+ "A String",
+ ],
},
],
},
@@ -5731,16 +5974,16 @@
</div>
<div class="method">
- <code class="details" id="list">list(serviceName, pageToken=None, pageSize=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(serviceName, pageSize=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists the history of the service configuration for a managed service,
from the newest to the oldest.
Args:
serviceName: string, Required. The name of the service. See the [overview](/service-management/overview)
for naming requirements. For example: `example.googleapis.com`. (required)
- pageToken: string, The token of the page to retrieve.
pageSize: integer, The max number of items to include in the response list. Page size is 50
if not specified. Maximum value is 100.
+ pageToken: string, The token of the page to retrieve.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -5774,273 +6017,6 @@
# - selector: "*"
# requirements:
# provider_id: google_calendar_auth
- "control": { # Selects and configures the service controller used by the service. The # Configuration for the service control plane.
- # service controller handles features like abuse, quota, billing, logging,
- # monitoring, etc.
- "environment": "A String", # The service control environment to use. If empty, no control plane
- # feature (like quota and billing) will be enabled.
- },
- "types": [ # A list of all proto message types included in this API service.
- # Types referenced directly or indirectly by the `apis` are
- # automatically included. Messages which are not referenced but
- # shall be included, such as types used by the `google.protobuf.Any` type,
- # should be listed here by name. Example:
- #
- # types:
- # - name: google.protobuf.Int32
- { # A protocol buffer message type.
- "fields": [ # The list of fields.
- { # A single field of a message type.
- "number": 42, # The field number.
- "name": "A String", # The field name.
- "kind": "A String", # The field type.
- "jsonName": "A String", # The field JSON name.
- "cardinality": "A String", # The field cardinality.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
- "packed": True or False, # Whether to use alternative packed wire representation.
- "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
- # types. The first type has index 1; zero means the type is not in the list.
- "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
- # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
- },
- ],
- "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
- "A String",
- ],
- "name": "A String", # The fully qualified message name.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax.
- "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- },
- ],
- "sourceInfo": { # Source information used to create a Service Config # Output only. The source information for this configuration if available.
- "sourceFiles": [ # All files used during config generation.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
- },
- "name": "A String", # The service name, which is a DNS-like logical identifier for the
- # service, such as `calendar.googleapis.com`. The service name
- # typically goes through DNS verification to make sure the owner
- # of the service also owns the DNS name.
- "title": "A String", # The product title for this service.
- "logs": [ # Defines the logs used by this service.
- { # A description of a log type. Example in YAML format:
- #
- # - name: library.googleapis.com/activity_history
- # description: The history of borrowing and returning library items.
- # display_name: Activity
- # labels:
- # - key: /customer_id
- # description: Identifier of a library customer
- "labels": [ # The set of labels that are available to describe a specific log entry.
- # Runtime requests that contain labels not specified here are
- # considered invalid.
- { # A description of a label.
- "valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
- "description": "A String", # A human-readable description for the label.
- },
- ],
- "description": "A String", # A human-readable description of this log. This information appears in
- # the documentation and can contain details.
- "displayName": "A String", # The human-readable name for this log. This information appears on
- # the user interface and should be concise.
- "name": "A String", # The name of the log. It must be less than 512 characters long and can
- # include the following characters: upper- and lower-case alphanumeric
- # characters [A-Za-z0-9], and punctuation characters including
- # slash, underscore, hyphen, period [/_-.].
- },
- ],
- "metrics": [ # Defines the metrics used by this service.
- { # 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.
- "type": "A String", # 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` or `external.googleapis.com`. Metric types should
- # use a natural hierarchical grouping. For example:
- #
- # "custom.googleapis.com/invoice/paid/amount"
- # "external.googleapis.com/prometheus/up"
- # "appengine.googleapis.com/http/server/response_latencies"
- "labels": [ # 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.
- { # A description of a label.
- "valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
- "description": "A String", # A human-readable description for the label.
- },
- ],
- "description": "A String", # A detailed description of the metric, which can be used in documentation.
- "monitoredResourceTypes": [ # Read-only. If present, then a time
- # series, which is identified partially by
- # a metric type and a MonitoredResourceDescriptor, that is associated
- # with this metric type can only be associated with one of the monitored
- # resource types listed here.
- "A String",
- ],
- "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
- # Use sentence case without an ending period, for example "Request count".
- # This field is optional but it is recommended to be set for any metrics
- # associated with user-visible concepts, such as Quota.
- "metadata": { # Additional annotations that can be used to guide the usage of a metric. # Optional. Metadata which can be used to guide usage of the metric.
- "launchStage": "A String", # Deprecated. Must use the MetricDescriptor.launch_stage instead.
- "ingestDelay": "A String", # The delay of data points caused by ingestion. Data points older than this
- # age are guaranteed to be ingested and available to be read, excluding
- # data loss due to errors.
- "samplePeriod": "A String", # The sampling period of metric data points. For metrics which are written
- # periodically, consecutive data points are stored at this time interval,
- # excluding data loss due to errors. Metrics with a higher granularity have
- # a smaller sampling period.
- },
- "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc.
- # Some combinations of `metric_kind` and `value_type` might not be supported.
- "unit": "A String", # The units in which the metric value is reported. It is only applicable
- # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit`
- # defines the representation of the stored metric values.
- #
- # Different systems may scale the values to be more easily displayed (so a
- # value of `0.02KBy` _might_ be displayed as `20By`, and a value of
- # `3523KBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is
- # `KBy`, then the value of the metric is always in thousands of bytes, no
- # matter how it may be displayed..
- #
- # If you want a custom metric to record the exact number of CPU-seconds used
- # by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is
- # `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005
- # CPU-seconds, then the value is written as `12005`.
- #
- # Alternatively, if you want a custom metric to record data in a more
- # granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
- # `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`),
- # or use `Kis{CPU}` and write `11.723` (which is `12005/1024`).
- #
- # The supported units are a subset of [The Unified Code for Units of
- # Measure](http://unitsofmeasure.org/ucum.html) standard:
- #
- # **Basic units (UNIT)**
- #
- # * `bit` bit
- # * `By` byte
- # * `s` second
- # * `min` minute
- # * `h` hour
- # * `d` day
- #
- # **Prefixes (PREFIX)**
- #
- # * `k` kilo (10^3)
- # * `M` mega (10^6)
- # * `G` giga (10^9)
- # * `T` tera (10^12)
- # * `P` peta (10^15)
- # * `E` exa (10^18)
- # * `Z` zetta (10^21)
- # * `Y` yotta (10^24)
- #
- # * `m` milli (10^-3)
- # * `u` micro (10^-6)
- # * `n` nano (10^-9)
- # * `p` pico (10^-12)
- # * `f` femto (10^-15)
- # * `a` atto (10^-18)
- # * `z` zepto (10^-21)
- # * `y` yocto (10^-24)
- #
- # * `Ki` kibi (2^10)
- # * `Mi` mebi (2^20)
- # * `Gi` gibi (2^30)
- # * `Ti` tebi (2^40)
- # * `Pi` pebi (2^50)
- #
- # **Grammar**
- #
- # The grammar also includes these connectors:
- #
- # * `/` division or ratio (as an infix operator). For examples,
- # `kBy/{email}` or `MiBy/10ms` (although you should almost never
- # have `/s` in a metric `unit`; rates should always be computed at
- # query time from the underlying cumulative or delta value).
- # * `.` multiplication or composition (as an infix operator). For
- # examples, `GBy.d` or `k{watt}.h`.
- #
- # The grammar for a unit is as follows:
- #
- # Expression = Component { "." Component } { "/" Component } ;
- #
- # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
- # | Annotation
- # | "1"
- # ;
- #
- # Annotation = "{" NAME "}" ;
- #
- # Notes:
- #
- # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
- # is used alone, then the unit is equivalent to `1`. For examples,
- # `{request}/s == 1/s`, `By{transmitted}/s == By/s`.
- # * `NAME` is a sequence of non-blank printable ASCII characters not
- # containing `{` or `}`.
- # * `1` represents a unitary [dimensionless
- # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
- # as in `1/s`. It is typically used when none of the basic units are
- # appropriate. For example, "new users per day" can be represented as
- # `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new
- # users). Alternatively, "thousands of page views per day" would be
- # represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric
- # value of `5.3` would mean "5300 page views per day").
- # * `%` represents dimensionless value of 1/100, and annotates values giving
- # a percentage (so the metric values are typically in the range of 0..100,
- # and a metric value `3` means "3 percent").
- # * `10^2.%` indicates a metric contains a ratio, typically in the range
- # 0..1, that will be multiplied by 100 and displayed as a percentage
- # (so a metric value `0.03` means "3 percent").
- "launchStage": "A String", # Optional. The launch stage of the metric definition.
- "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
- # Some combinations of `metric_kind` and `value_type` might not be supported.
- "name": "A String", # The resource name of the metric descriptor.
- },
- ],
"enums": [ # A list of all enum types included in this API service. Enums
# referenced directly or indirectly by the `apis` are automatically
# included. Enums which are not referenced but shall be included
@@ -6052,530 +6028,414 @@
"options": [ # Protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
- "name": "A String", # Enum type name.
- "syntax": "A String", # The source syntax.
+ "enumvalue": [ # Enum value definitions.
+ { # Enum value definition.
+ "name": "A String", # Enum value name.
+ "options": [ # Protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "number": 42, # Enum value number.
+ },
+ ],
"sourceContext": { # `SourceContext` represents information about the source of a # The source context.
# protobuf element, like the file in which it is defined.
"fileName": "A String", # The path-qualified name of the .proto file that contained the associated
# protobuf element. For example: `"google/protobuf/source_context.proto"`.
},
- "enumvalue": [ # Enum value definitions.
- { # Enum value definition.
- "name": "A String", # Enum value name.
- "number": 42, # Enum value number.
- "options": [ # Protocol buffer options.
+ "name": "A String", # Enum type name.
+ "syntax": "A String", # The source syntax.
+ },
+ ],
+ "backend": { # `Backend` defines the backend configuration for a service. # API backend configuration.
+ "rules": [ # A list of API backend rules that apply to individual API methods.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # A backend rule provides configuration for an individual API element.
+ "disableAuth": True or False, # When disable_auth is true, a JWT ID token won't be generated and the
+ # original "Authorization" HTTP header will be preserved. If the header is
+ # used to carry the original token and is expected by the backend, this
+ # field must be set to true to preserve the header.
+ "address": "A String", # The address of the API backend.
+ #
+ # The scheme is used to determine the backend protocol and security.
+ # The following schemes are accepted:
+ #
+ # SCHEME PROTOCOL SECURITY
+ # http:// HTTP None
+ # https:// HTTP TLS
+ # grpc:// gRPC None
+ # grpcs:// gRPC TLS
+ #
+ # It is recommended to explicitly include a scheme. Leaving out the scheme
+ # may cause constrasting behaviors across platforms.
+ #
+ # If the port is unspecified, the default is:
+ # - 80 for schemes without TLS
+ # - 443 for schemes with TLS
+ #
+ # For HTTP backends, use protocol
+ # to specify the protocol version.
+ "minDeadline": 3.14, # Minimum deadline in seconds needed for this method. Calls having deadline
+ # value lower than this will be rejected.
+ "selector": "A String", # Selects the methods to which this rule applies.
+ #
+ # Refer to selector for syntax details.
+ "protocol": "A String", # The protocol used for sending a request to the backend.
+ # The supported values are "http/1.1" and "h2".
+ #
+ # The default value is inferred from the scheme in the
+ # address field:
+ #
+ # SCHEME PROTOCOL
+ # http:// http/1.1
+ # https:// http/1.1
+ # grpc:// h2
+ # grpcs:// h2
+ #
+ # For secure HTTP backends (https://) that support HTTP/2, set this field
+ # to "h2" for improved performance.
+ #
+ # Configuring this field to non-default values is only supported for secure
+ # HTTP backends. This field will be ignored for all other backends.
+ #
+ # See
+ # https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
+ # for more details on the supported values.
+ "operationDeadline": 3.14, # The number of seconds to wait for the completion of a long running
+ # operation. The default is no deadline.
+ "pathTranslation": "A String",
+ "jwtAudience": "A String", # The JWT audience is used when generating a JWT ID token for the backend.
+ # This ID token will be added in the HTTP "authorization" header, and sent
+ # to the backend.
+ "deadline": 3.14, # The number of seconds to wait for a response from a request. The default
+ # varies based on the request protocol and deployment environment.
+ },
+ ],
+ },
+ "systemTypes": [ # 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.
+ { # A protocol buffer message type.
+ "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
+ "A String",
+ ],
+ "fields": [ # The list of fields.
+ { # A single field of a message type.
+ "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
+ # types. The first type has index 1; zero means the type is not in the list.
+ "name": "A String", # The field name.
+ "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
+ "packed": True or False, # Whether to use alternative packed wire representation.
+ "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
+ # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
+ "cardinality": "A String", # The field cardinality.
+ "jsonName": "A String", # The field JSON name.
+ "kind": "A String", # The field type.
+ "options": [ # The protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
+ "number": 42, # The field number.
},
],
- },
- ],
- "authentication": { # `Authentication` defines the authentication configuration for an API. # Auth configuration.
- #
- # Example for an API targeted for external use:
- #
- # name: calendar.googleapis.com
- # authentication:
- # providers:
- # - id: google_calendar_auth
- # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
- # issuer: https://securetoken.google.com
- # rules:
- # - selector: "*"
- # requirements:
- # provider_id: google_calendar_auth
- "rules": [ # A list of authentication rules that apply to individual API methods.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # Authentication rules for the service.
- #
- # By default, if a method has any authentication requirements, every request
- # must include a valid credential matching one of the requirements.
- # It's an error to include more than one kind of credential in a single
- # request.
- #
- # If a method doesn't have any auth requirements, request credentials will be
- # ignored.
- "oauth": { # OAuth scopes are a way to define data and permissions on data. For example, # The requirements for OAuth credentials.
- # there are scopes defined for "Read-only access to Google Calendar" and
- # "Access to Cloud Platform". Users can consent to a scope for an application,
- # giving it permission to access that data on their behalf.
- #
- # OAuth scope specifications should be fairly coarse grained; a user will need
- # to see and understand the text description of what your scope means.
- #
- # In most cases: use one or at most two OAuth scopes for an entire family of
- # products. If your product has multiple APIs, you should probably be sharing
- # the OAuth scope across all of those APIs.
- #
- # When you need finer grained OAuth consent screens: talk with your product
- # management about how developers will use them in practice.
- #
- # Please note that even though each of the canonical scopes is enough for a
- # request to be accepted and passed to the backend, a request can still fail
- # due to the backend requiring additional scopes or permissions.
- "canonicalScopes": "A String", # The list of publicly documented OAuth scopes that are allowed access. An
- # OAuth token containing any of these scopes will be accepted.
- #
- # Example:
- #
- # canonical_scopes: https://www.googleapis.com/auth/calendar,
- # https://www.googleapis.com/auth/calendar.read
- },
- "requirements": [ # Requirements for additional authentication providers.
- { # User-defined authentication requirements, including support for
- # [JSON Web Token
- # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
- "audiences": "A String", # 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:
- #
- # audiences: bookstore_android.apps.googleusercontent.com,
- # bookstore_web.apps.googleusercontent.com
- "providerId": "A String", # id from authentication provider.
- #
- # Example:
- #
- # provider_id: bookstore_auth
- },
- ],
- "allowWithoutCredential": True or False, # If true, the service accepts API keys without any other credential.
- "selector": "A String", # Selects the methods to which this rule applies.
- #
- # Refer to selector for syntax details.
- },
- ],
- "providers": [ # Defines a set of authentication providers that a service supports.
- { # Configuration for an authentication provider, including support for
- # [JSON Web Token
- # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
- "audiences": "A String", # 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, JWTs with audiences:
- # - "https://[service.name]/[google.protobuf.Api.name]"
- # - "https://[service.name]/"
- # will be accepted.
- # For example, if no audiences are in the setting, LibraryService API will
- # accept JWTs with the following audiences:
- # -
- # https://library-example.googleapis.com/google.example.library.v1.LibraryService
- # - https://library-example.googleapis.com/
- #
- # Example:
- #
- # audiences: bookstore_android.apps.googleusercontent.com,
- # bookstore_web.apps.googleusercontent.com
- "jwtLocations": [ # Defines the locations to extract the JWT.
- #
- # JWT locations can be either from HTTP headers or URL query parameters.
- # The rule is that the first match wins. The checking order is: checking
- # all headers first, then URL query parameters.
- #
- # If not specified, default to use following 3 locations:
- # 1) Authorization: Bearer
- # 2) x-goog-iap-jwt-assertion
- # 3) access_token query parameter
- #
- # Default locations can be specified as followings:
- # jwt_locations:
- # - header: Authorization
- # value_prefix: "Bearer "
- # - header: x-goog-iap-jwt-assertion
- # - query: access_token
- { # Specifies a location to extract JWT from an API request.
- "query": "A String", # Specifies URL query parameter name to extract JWT token.
- "header": "A String", # Specifies HTTP header name to extract JWT token.
- "valuePrefix": "A String", # The value prefix. The value format is "value_prefix{token}"
- # Only applies to "in" header type. Must be empty for "in" query type.
- # If not empty, the header value has to match (case sensitive) this prefix.
- # If not matched, JWT will not be extracted. If matched, JWT will be
- # extracted after the prefix is removed.
- #
- # For example, for "Authorization: Bearer {JWT}",
- # value_prefix="Bearer " with a space at the end.
- },
- ],
- "issuer": "A String", # 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.
- #
- # Example: https://securetoken.google.com
- # Example: 1234567-compute@developer.gserviceaccount.com
- "id": "A String", # The unique identifier of the auth provider. It will be referred to by
- # `AuthRequirement.provider_id`.
- #
- # Example: "bookstore_auth".
- "jwksUri": "A String", # URL of the provider's public key set to validate signature of the JWT. See
- # [OpenID
- # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).
- # Optional if the key set document:
- # - can be retrieved from
- # [OpenID
- # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
- # the issuer.
- # - can be inferred from the email domain of the issuer (e.g. a Google
- # service account).
- #
- # Example: https://www.googleapis.com/oauth2/v1/certs
- "authorizationUrl": "A String", # Redirect URL if JWT token is required but not present or is expired.
- # Implement authorizationUrl of securityDefinitions in OpenAPI spec.
- },
- ],
- },
- "documentation": { # `Documentation` provides the information for describing a service. # Additional API documentation.
- #
- # Example:
- # <pre><code>documentation:
- # summary: >
- # The Google Calendar API gives access
- # to most calendar features.
- # pages:
- # - name: Overview
- # content: &#40;== include google/foo/overview.md ==&#41;
- # - name: Tutorial
- # content: &#40;== include google/foo/tutorial.md ==&#41;
- # subpages;
- # - name: Java
- # content: &#40;== include google/foo/tutorial_java.md ==&#41;
- # rules:
- # - selector: google.calendar.Calendar.Get
- # description: >
- # ...
- # - selector: google.calendar.Calendar.Put
- # description: >
- # ...
- # </code></pre>
- # Documentation is provided in markdown syntax. In addition to
- # standard markdown features, definition lists, tables and fenced
- # code blocks are supported. Section headers can be provided and are
- # interpreted relative to the section nesting of the context where
- # a documentation fragment is embedded.
- #
- # Documentation from the IDL is merged with documentation defined
- # via the config at normalization time, where documentation provided
- # by config rules overrides IDL provided.
- #
- # A number of constructs specific to the API platform are supported
- # in documentation text.
- #
- # In order to reference a proto element, the following
- # notation can be used:
- # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
- # To override the display text used for the link, this can be used:
- # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
- # Text can be excluded from doc using the following notation:
- # <pre><code>&#40;-- internal comment --&#41;</code></pre>
- #
- # A few directives are available in documentation. Note that
- # directives must appear on a single line to be properly
- # identified. The `include` directive includes a markdown file from
- # an external source:
- # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
- # The `resource_for` directive marks a message to be the resource of
- # a collection in REST view. If it is not specified, tools attempt
- # to infer the resource from the operations in a collection:
- # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
- # The directive `suppress_warning` does not directly affect documentation
- # and is documented together with service config validation.
- "documentationRootUrl": "A String", # The URL to the root of documentation.
- "serviceRootUrl": "A String", # Specifies the service root url if the default one (the service name
- # from the yaml file) is not suitable. This can be seen in any fully
- # specified service urls as well as sections that show a base that other
- # urls are relative to.
- "rules": [ # A list of documentation rules that apply to individual API elements.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A documentation rule provides information about individual API elements.
- "description": "A String", # Description of the selected API(s).
- "deprecationDescription": "A String", # Deprecation description of the selected element(s). It can be provided if
- # an element is marked as `deprecated`.
- "selector": "A String", # The selector is a comma-separated list of patterns. Each pattern is a
- # qualified name of the element which may end in "*", indicating a wildcard.
- # Wildcards are only allowed at the end and for a whole component of the
- # qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A
- # wildcard will match one or more components. To specify a default for all
- # applicable elements, the whole pattern "*" is used.
- },
- ],
- "pages": [ # The top level pages for the documentation set.
- { # Represents a documentation page. A page can contain subpages to represent
- # nested documentation set structure.
- "name": "A String", # The name of the page. It will be used as an identity of the page to
- # generate URI of the page, text of the link to this page in navigation,
- # etc. The full page name (start from the root page name to this page
- # concatenated with `.`) can be used as reference to the page in your
- # documentation. For example:
- # <pre><code>pages:
- # - name: Tutorial
- # content: &#40;== include tutorial.md ==&#41;
- # subpages:
- # - name: Java
- # content: &#40;== include tutorial_java.md ==&#41;
- # </code></pre>
- # You can reference `Java` page using Markdown reference link syntax:
- # `Java`.
- "subpages": [ # Subpages of this page. The order of subpages specified here will be
- # honored in the generated docset.
- # Object with schema name: Page
- ],
- "content": "A String", # The Markdown content of the page. You can use <code>&#40;== include {path}
- # ==&#41;</code> to include content from a Markdown file.
- },
- ],
- "summary": "A String", # A short summary of what the service does. Can only be provided by
- # plain text.
- "overview": "A String", # Declares a single overview page. For example:
- # <pre><code>documentation:
- # summary: ...
- # overview: &#40;== include overview.md ==&#41;
- # </code></pre>
- # This is a shortcut for the following declaration (using pages style):
- # <pre><code>documentation:
- # summary: ...
- # pages:
- # - name: Overview
- # content: &#40;== include overview.md ==&#41;
- # </code></pre>
- # Note: you cannot specify both `overview` field and `pages` field.
- },
- "apis": [ # 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.
- { # Api is a light-weight descriptor for an API Interface.
- #
- # Interfaces are also described as "protocol buffer services" in some contexts,
- # such as by the "service" keyword in a .proto file, but they are different
- # from API Services, which represent a concrete implementation of an interface
- # as opposed to simply a description of methods and bindings. They are also
- # sometimes simply referred to as "APIs" in other contexts, such as the name of
- # this message itself. See https://cloud.google.com/apis/design/glossary for
- # detailed terminology.
- "options": [ # Any metadata attached to the interface.
+ "options": [ # The protocol buffer options.
{ # A protocol buffer option, which can be attached to a message, field,
# enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
"value": { # The option's value packed in an Any message. If the value is a primitive,
# the corresponding wrapper type defined in google/protobuf/wrappers.proto
# should be used. If the value is an enum, it should be stored as an int32
# value using the google.protobuf.Int32Value type.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
},
],
- "syntax": "A String", # The source syntax of the service.
- "sourceContext": { # `SourceContext` represents information about the source of a # Source context for the protocol buffer service represented by this
- # message.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- "mixins": [ # Included interfaces. See Mixin.
- { # Declares an API Interface to be included in this interface. The including
- # interface must redeclare all the methods from the included interface, but
- # documentation and options are inherited as follows:
- #
- # - If after comment and whitespace stripping, the documentation
- # string of the redeclared method is empty, it will be inherited
- # from the original method.
- #
- # - Each annotation belonging to the service config (http,
- # visibility) which is not set in the redeclared method will be
- # inherited.
- #
- # - If an http annotation is inherited, the path pattern will be
- # modified as follows. Any version prefix will be replaced by the
- # version of the including interface plus the root path if
- # specified.
- #
- # Example of a simple mixin:
- #
- # package google.acl.v1;
- # service AccessControl {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v1/{resource=**}:getAcl";
- # }
- # }
- #
- # package google.storage.v2;
- # service Storage {
- # // rpc GetAcl(GetAclRequest) returns (Acl);
- #
- # // Get a data record.
- # rpc GetData(GetDataRequest) returns (Data) {
- # option (google.api.http).get = "/v2/{resource=**}";
- # }
- # }
- #
- # Example of a mixin configuration:
- #
- # apis:
- # - name: google.storage.v2.Storage
- # mixins:
- # - name: google.acl.v1.AccessControl
- #
- # The mixin construct implies that all methods in `AccessControl` are
- # also declared with same name and request/response types in
- # `Storage`. A documentation generator or annotation processor will
- # see the effective `Storage.GetAcl` method after inherting
- # documentation and annotations as follows:
- #
- # service Storage {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v2/{resource=**}:getAcl";
- # }
- # ...
- # }
- #
- # Note how the version in the path pattern changed from `v1` to `v2`.
- #
- # If the `root` field in the mixin is specified, it should be a
- # relative path under which inherited HTTP paths are placed. Example:
- #
- # apis:
- # - name: google.storage.v2.Storage
- # mixins:
- # - name: google.acl.v1.AccessControl
- # root: acls
- #
- # This implies the following inherited HTTP annotation:
- #
- # service Storage {
- # // Get the underlying ACL object.
- # rpc GetAcl(GetAclRequest) returns (Acl) {
- # option (google.api.http).get = "/v2/acls/{resource=**}:getAcl";
- # }
- # ...
- # }
- "name": "A String", # The fully qualified name of the interface which is included.
- "root": "A String", # If non-empty specifies a path under which inherited HTTP paths
- # are rooted.
- },
- ],
- "version": "A String", # A version string for this interface. If specified, must have the form
- # `major-version.minor-version`, as in `1.10`. If the minor version is
- # omitted, it defaults to zero. If the entire version field is empty, the
- # major version is derived from the package name, as outlined below. If the
- # field is not empty, the version in the package name will be verified to be
- # consistent with what is provided here.
- #
- # The versioning schema uses [semantic
- # versioning](http://semver.org) where the major version number
- # indicates a breaking change and the minor version an additive,
- # non-breaking change. Both version numbers are signals to users
- # what to expect from different versions, and should be carefully
- # chosen based on the product plan.
- #
- # The major version is also reflected in the package name of the
- # interface, which must end in `v<major-version>`, as in
- # `google.feature.v1`. For major versions 0 and 1, the suffix can
- # be omitted. Zero major versions must only be used for
- # experimental, non-GA interfaces.
- "methods": [ # The methods of this interface, in unspecified order.
- { # Method represents a method of an API interface.
- "requestTypeUrl": "A String", # A URL of the input message type.
- "name": "A String", # The simple name of this method.
- "responseStreaming": True or False, # If true, the response is streamed.
- "requestStreaming": True or False, # If true, the request is streamed.
- "options": [ # Any metadata attached to the method.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax of this method.
- "responseTypeUrl": "A String", # The URL of the output message type.
- },
- ],
- "name": "A String", # The fully qualified name of this interface, including package name
- # followed by the interface's simple name.
+ "syntax": "A String", # The source syntax.
+ "name": "A String", # The fully qualified message name.
},
],
- "customError": { # Customize service error responses. For example, list any service # Custom error configuration.
- # specific protobuf types that can appear in error detail lists of
- # error responses.
- #
- # Example:
- #
- # custom_error:
- # types:
- # - google.foo.v1.CustomError
- # - google.foo.v1.AnotherError
- "types": [ # The list of custom error detail types, e.g. 'google.foo.v1.CustomError'.
- "A String",
- ],
- "rules": [ # The list of custom error rules that apply to individual API messages.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A custom error rule.
- "isErrorType": True or False, # Mark this message as possible payload in error response. Otherwise,
- # objects of this type will be filtered when they appear in error payload.
- "selector": "A String", # Selects messages to which this rule applies.
- #
- # Refer to selector for syntax details.
+ "name": "A String", # The service name, which is a DNS-like logical identifier for the
+ # service, such as `calendar.googleapis.com`. The service name
+ # typically goes through DNS verification to make sure the owner
+ # of the service also owns the DNS name.
+ "sourceInfo": { # Source information used to create a Service Config # Output only. The source information for this configuration if available.
+ "sourceFiles": [ # All files used during config generation.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
},
- "id": "A String", # A unique ID for a specific instance of this message, typically assigned
- # by the client for tracking purpose. Must be no longer than 63 characters
- # and only lower case letters, digits, '.', '_' and '-' are allowed. If
- # empty, the server may choose to generate one instead.
+ "billing": { # Billing related configuration of the service. # Billing configuration.
+ #
+ # The following example shows how to configure monitored resources and metrics
+ # for billing, `consumer_destinations` is the only supported destination and
+ # the monitored resources need at least one label key
+ # `cloud.googleapis.com/location` to indicate the location of the billing
+ # usage, using different monitored resources between monitoring and billing is
+ # recommended so they can be evolved independently:
+ #
+ #
+ # monitored_resources:
+ # - type: library.googleapis.com/billing_branch
+ # labels:
+ # - key: cloud.googleapis.com/location
+ # description: |
+ # Predefined label to support billing location restriction.
+ # - key: city
+ # description: |
+ # Custom label to define the city where the library branch is located
+ # in.
+ # - key: name
+ # description: Custom label to define the name of the library branch.
+ # metrics:
+ # - name: library.googleapis.com/book/borrowed_count
+ # metric_kind: DELTA
+ # value_type: INT64
+ # unit: "1"
+ # billing:
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/billing_branch
+ # metrics:
+ # - library.googleapis.com/book/borrowed_count
+ "consumerDestinations": [ # Billing configurations for sending metrics to the consumer project.
+ # There can be multiple consumer destinations per service, each one must have
+ # a different monitored resource type. A metric can be used in at most
+ # one consumer destination.
+ { # Configuration of a specific billing destination (Currently only support
+ # bill against consumer project).
+ "metrics": [ # Names of the metrics to report to this billing destination.
+ # Each name must be defined in Service.metrics section.
+ "A String",
+ ],
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ },
+ ],
+ },
+ "monitoring": { # Monitoring configuration of the service. # Monitoring configuration.
+ #
+ # The example below shows how to configure monitored resources and metrics
+ # for monitoring. In the example, a monitored resource and two metrics are
+ # defined. The `library.googleapis.com/book/returned_count` metric is sent
+ # to both producer and consumer projects, whereas the
+ # `library.googleapis.com/book/num_overdue` metric is only sent to the
+ # consumer project.
+ #
+ # monitored_resources:
+ # - type: library.googleapis.com/Branch
+ # display_name: "Library Branch"
+ # description: "A branch of a library."
+ # launch_stage: GA
+ # labels:
+ # - key: resource_container
+ # description: "The Cloud container (ie. project id) for the Branch."
+ # - key: location
+ # description: "The location of the library branch."
+ # - key: branch_id
+ # description: "The id of the branch."
+ # metrics:
+ # - name: library.googleapis.com/book/returned_count
+ # display_name: "Books Returned"
+ # description: "The count of books that have been returned."
+ # launch_stage: GA
+ # metric_kind: DELTA
+ # value_type: INT64
+ # unit: "1"
+ # labels:
+ # - key: customer_id
+ # description: "The id of the customer."
+ # - name: library.googleapis.com/book/num_overdue
+ # display_name: "Books Overdue"
+ # description: "The current number of overdue books."
+ # launch_stage: GA
+ # metric_kind: GAUGE
+ # value_type: INT64
+ # unit: "1"
+ # labels:
+ # - key: customer_id
+ # description: "The id of the customer."
+ # monitoring:
+ # producer_destinations:
+ # - monitored_resource: library.googleapis.com/Branch
+ # metrics:
+ # - library.googleapis.com/book/returned_count
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/Branch
+ # metrics:
+ # - library.googleapis.com/book/returned_count
+ # - library.googleapis.com/book/num_overdue
+ "producerDestinations": [ # Monitoring configurations for sending metrics to the producer project.
+ # There can be multiple producer destinations. A monitored resource type may
+ # appear in multiple monitoring destinations if different aggregations are
+ # needed for different sets of metrics associated with that monitored
+ # resource type. A monitored resource and metric pair may only be used once
+ # in the Monitoring configuration.
+ { # Configuration of a specific monitoring destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ "metrics": [ # Types of the metrics to report to this monitoring destination.
+ # Each type must be defined in Service.metrics section.
+ "A String",
+ ],
+ },
+ ],
+ "consumerDestinations": [ # Monitoring configurations for sending metrics to the consumer project.
+ # There can be multiple consumer destinations. A monitored resource type may
+ # appear in multiple monitoring destinations if different aggregations are
+ # needed for different sets of metrics associated with that monitored
+ # resource type. A monitored resource and metric pair may only be used once
+ # in the Monitoring configuration.
+ { # Configuration of a specific monitoring destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in
+ # Service.monitored_resources section.
+ "metrics": [ # Types of the metrics to report to this monitoring destination.
+ # Each type must be defined in Service.metrics section.
+ "A String",
+ ],
+ },
+ ],
+ },
+ "logging": { # Logging configuration of the service. # Logging configuration.
+ #
+ # The following example shows how to configure logs to be sent to the
+ # 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: activity_history
+ # labels:
+ # - key: /customer_id
+ # - name: purchase_history
+ # logging:
+ # producer_destinations:
+ # - monitored_resource: library.googleapis.com/branch
+ # logs:
+ # - activity_history
+ # - purchase_history
+ # consumer_destinations:
+ # - monitored_resource: library.googleapis.com/branch
+ # logs:
+ # - activity_history
+ "producerDestinations": [ # Logging configurations for sending logs to the producer project.
+ # There can be multiple producer destinations, each one must have a
+ # different monitored resource type. A log can be used in at most
+ # one producer destination.
+ { # Configuration of a specific logging destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
+ # Service.monitored_resources section.
+ "logs": [ # Names of the logs to be sent to this destination. Each name must
+ # 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 "/".
+ "A String",
+ ],
+ },
+ ],
+ "consumerDestinations": [ # 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.
+ { # Configuration of a specific logging destination (the producer project
+ # or the consumer project).
+ "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
+ # Service.monitored_resources section.
+ "logs": [ # Names of the logs to be sent to this destination. Each name must
+ # 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 "/".
+ "A String",
+ ],
+ },
+ ],
+ },
+ "control": { # Selects and configures the service controller used by the service. The # Configuration for the service control plane.
+ # service controller handles features like abuse, quota, billing, logging,
+ # monitoring, etc.
+ "environment": "A String", # The service control environment to use. If empty, no control plane
+ # feature (like quota and billing) will be enabled.
+ },
"usage": { # Configuration controlling usage of a service. # Configuration controlling usage of this service.
"requirements": [ # Requirements that must be satisfied before a consumer project can use the
# service. Each requirement is of the form <service.name>/<requirement-id>;
# for example 'serviceusage.googleapis.com/billing-enabled'.
"A String",
],
+ "serviceIdentity": { # The per-product per-project service identity for a service. # The configuration of a per-product per-project service identity.
+ #
+ #
+ # Use this field to configure per-product per-project service identity.
+ # Example of a service identity configuration.
+ #
+ # usage:
+ # service_identity:
+ # - service_account_parent: "projects/123456789"
+ # display_name: "Cloud XXX Service Agent"
+ # description: "Used as the identity of Cloud XXX to access resources"
+ "serviceAccountParent": "A String", # A service account project that hosts the service accounts.
+ #
+ # An example name would be:
+ # `projects/123456789`
+ "description": "A String", # Optional. A user-specified opaque description of the service account.
+ # Must be less than or equal to 256 UTF-8 bytes.
+ "displayName": "A String", # Optional. A user-specified name for the service account.
+ # Must be less than or equal to 100 UTF-8 bytes.
+ },
"rules": [ # A list of usage rules that apply to individual API methods.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
@@ -6604,16 +6464,16 @@
# rules:
# - selector: "google.example.library.v1.LibraryService.CreateBook"
# allow_unregistered_calls: true
+ "skipServiceControl": True or False, # If true, the selected method should skip service control and the control
+ # plane features, such as quota and billing, will not be available.
+ # This flag is used by Google Cloud Endpoints to bypass checks for internal
+ # methods, such as service health check methods.
"selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
# methods in all APIs.
#
# Refer to selector for syntax details.
"allowUnregisteredCalls": True or False, # If true, the selected method allows unregistered calls, e.g. calls
# that don't identify any user or application.
- "skipServiceControl": True or False, # If true, the selected method should skip service control and the control
- # plane features, such as quota and billing, will not be available.
- # This flag is used by Google Cloud Endpoints to bypass checks for internal
- # methods, such as service health check methods.
},
],
"producerNotificationChannel": "A String", # The full resource name of a channel used for sending notifications to the
@@ -6624,78 +6484,82 @@
# channel. To use Google Cloud Pub/Sub as the channel, this must be the name
# of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format
# documented in https://cloud.google.com/pubsub/docs/overview.
- "serviceIdentity": { # The per-product per-project service identity for a service. # The configuration of a per-product per-project service identity.
- #
- #
- # Use this field to configure per-product per-project service identity.
- # Example of a service identity configuration.
- #
- # usage:
- # service_identity:
- # - service_account_parent: "projects/123456789"
- # display_name: "Cloud XXX Service Agent"
- # description: "Used as the identity of Cloud XXX to access resources"
- "displayName": "A String", # Optional. A user-specified name for the service account.
- # Must be less than or equal to 100 UTF-8 bytes.
- "description": "A String", # Optional. A user-specified opaque description of the service account.
- # Must be less than or equal to 256 UTF-8 bytes.
- "serviceAccountParent": "A String", # A service account project that hosts the service accounts.
- #
- # An example name would be:
- # `projects/123456789`
- },
},
- "endpoints": [ # Configuration for network endpoints. If this is empty, then an endpoint
- # with the same name as the service is automatically generated to service all
- # defined APIs.
- { # `Endpoint` describes a network endpoint that serves a set of APIs.
- # A service may expose any number of endpoints, and all endpoints share the
- # same service configuration, such as quota configuration and monitoring
- # configuration.
- #
- # Example service configuration:
- #
- # name: library-example.googleapis.com
- # endpoints:
- # # Below entry makes 'google.example.library.v1.Library'
- # # API be served from endpoint address library-example.googleapis.com.
- # # It also allows HTTP OPTIONS calls to be passed to the backend, for
- # # it to decide whether the subsequent cross-origin request is
- # # allowed to proceed.
- # - name: library-example.googleapis.com
- # allow_cors: true
- "name": "A String", # The canonical name of this endpoint.
- "target": "A String", # The specification of an Internet routable address of API frontend that will
- # handle requests to this [API
- # Endpoint](https://cloud.google.com/apis/design/glossary). It should be
- # either a valid IPv4 address or a fully-qualified domain name. For example,
- # "8.8.8.8" or "myservice.appspot.com".
- "allowCors": True or False, # Allowing
- # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
- # cross-domain traffic, would allow the backends served from this endpoint to
- # receive and respond to HTTP OPTIONS requests. The response will be used by
- # the browser to determine whether the subsequent cross-origin request is
- # allowed to proceed.
- "features": [ # The list of features enabled on this endpoint.
+ "types": [ # A list of all proto message types included in this API service.
+ # Types referenced directly or indirectly by the `apis` are
+ # automatically included. Messages which are not referenced but
+ # shall be included, such as types used by the `google.protobuf.Any` type,
+ # should be listed here by name. Example:
+ #
+ # types:
+ # - name: google.protobuf.Int32
+ { # A protocol buffer message type.
+ "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
"A String",
],
- "aliases": [ # DEPRECATED: This field is no longer supported. Instead of using aliases,
- # please specify multiple google.api.Endpoint for each of the intended
- # aliases.
- #
- # Additional names that this endpoint will be hosted on.
- "A String",
+ "fields": [ # The list of fields.
+ { # A single field of a message type.
+ "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
+ # types. The first type has index 1; zero means the type is not in the list.
+ "name": "A String", # The field name.
+ "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
+ "packed": True or False, # Whether to use alternative packed wire representation.
+ "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
+ # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
+ "cardinality": "A String", # The field cardinality.
+ "jsonName": "A String", # The field JSON name.
+ "kind": "A String", # The field type.
+ "options": [ # The protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "number": 42, # The field number.
+ },
],
+ "options": [ # The protocol buffer options.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "syntax": "A String", # The source syntax.
+ "name": "A String", # The fully qualified message name.
},
],
- "configVersion": 42, # The semantic version of the service configuration. The config version
- # affects the interpretation of the service configuration. For example,
- # certain features are enabled by default for certain config versions.
- #
- # The latest config version is `3`.
"http": { # Defines the HTTP configuration for an API service. It contains a list of # HTTP configuration.
# HttpRule, each specifying the mapping of an RPC method
# to one or more HTTP REST API methods.
+ "fullyDecodeReservedExpansion": True or False, # When set to true, URL path parameters will be fully URI-decoded except in
+ # cases of single segment matches in reserved expansion, where "%2F" will be
+ # left encoded.
+ #
+ # The default behavior is to not decode RFC 6570 reserved characters in multi
+ # segment matches.
"rules": [ # A list of HTTP configuration rules that apply to individual API methods.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
@@ -6968,10 +6832,29 @@
# If an API needs to use a JSON array for request or response body, it can map
# the request or response body to a repeated field. However, some gRPC
# Transcoding implementations may not support this feature.
+ "put": "A String", # Maps to HTTP PUT. Used for replacing a resource.
"selector": "A String", # Selects a method to which this rule applies.
#
# Refer to selector for syntax details.
- "put": "A String", # Maps to HTTP PUT. Used for replacing a resource.
+ "post": "A String", # Maps to HTTP POST. Used for creating a resource or performing an action.
+ "responseBody": "A String", # Optional. The name of the response field whose value is mapped to the HTTP
+ # response body. When omitted, the entire response message will be used
+ # as the HTTP response body.
+ #
+ # NOTE: The referred field must be present at the top-level of the response
+ # message type.
+ "body": "A String", # The name of the request field whose value is mapped to the HTTP request
+ # body, or `*` for mapping all request fields not captured by the path
+ # pattern to the HTTP body, or omitted for not having any HTTP request body.
+ #
+ # NOTE: the referred field must be present at the top-level of the request
+ # message type.
+ "patch": "A String", # Maps to HTTP PATCH. Used for updating a resource.
+ "additionalBindings": [ # Additional HTTP bindings for the selector. Nested bindings must
+ # not contain an `additional_bindings` field themselves (that is,
+ # the nesting may only be one level deep).
+ # Object with schema name: HttpRule
+ ],
"custom": { # A custom pattern is used for defining custom HTTP verb. # The custom pattern is used for specifying an HTTP method that is not
# included in the `pattern` field, such as HEAD, or "*" to leave the
# HTTP method unspecified for this rule. The wild-card rule is useful
@@ -6979,378 +6862,354 @@
"path": "A String", # The path matched by this custom verb.
"kind": "A String", # The name of this custom HTTP verb.
},
- "responseBody": "A String", # Optional. The name of the response field whose value is mapped to the HTTP
- # response body. When omitted, the entire response message will be used
- # as the HTTP response body.
- #
- # NOTE: The referred field must be present at the top-level of the response
- # message type.
"allowHalfDuplex": True or False, # When this flag is set to true, HTTP requests will be allowed to invoke a
# half-duplex streaming method.
- "additionalBindings": [ # Additional HTTP bindings for the selector. Nested bindings must
- # not contain an `additional_bindings` field themselves (that is,
- # the nesting may only be one level deep).
- # Object with schema name: HttpRule
- ],
- "patch": "A String", # Maps to HTTP PATCH. Used for updating a resource.
+ "delete": "A String", # Maps to HTTP DELETE. Used for deleting a resource.
"get": "A String", # Maps to HTTP GET. Used for listing and getting information about
# resources.
- "post": "A String", # Maps to HTTP POST. Used for creating a resource or performing an action.
- "body": "A String", # The name of the request field whose value is mapped to the HTTP request
- # body, or `*` for mapping all request fields not captured by the path
- # pattern to the HTTP body, or omitted for not having any HTTP request body.
- #
- # NOTE: the referred field must be present at the top-level of the request
- # message type.
- "delete": "A String", # Maps to HTTP DELETE. Used for deleting a resource.
},
],
- "fullyDecodeReservedExpansion": True or False, # When set to true, URL path parameters will be fully URI-decoded except in
- # cases of single segment matches in reserved expansion, where "%2F" will be
- # left encoded.
+ },
+ "logs": [ # Defines the logs used by this service.
+ { # A description of a log type. Example in YAML format:
#
- # The default behavior is to not decode RFC 6570 reserved characters in multi
- # segment matches.
- },
- "billing": { # Billing related configuration of the service. # Billing configuration.
- #
- # The following example shows how to configure monitored resources and metrics
- # for billing, `consumer_destinations` is the only supported destination and
- # the monitored resources need at least one label key
- # `cloud.googleapis.com/location` to indicate the location of the billing
- # usage, using different monitored resources between monitoring and billing is
- # recommended so they can be evolved independently:
- #
- #
- # monitored_resources:
- # - type: library.googleapis.com/billing_branch
- # labels:
- # - key: cloud.googleapis.com/location
- # description: |
- # Predefined label to support billing location restriction.
- # - key: city
- # description: |
- # Custom label to define the city where the library branch is located
- # in.
- # - key: name
- # description: Custom label to define the name of the library branch.
- # metrics:
- # - name: library.googleapis.com/book/borrowed_count
- # metric_kind: DELTA
- # value_type: INT64
- # unit: "1"
- # billing:
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/billing_branch
- # metrics:
- # - library.googleapis.com/book/borrowed_count
- "consumerDestinations": [ # Billing configurations for sending metrics to the consumer project.
- # There can be multiple consumer destinations per service, each one must have
- # a different monitored resource type. A metric can be used in at most
- # one consumer destination.
- { # Configuration of a specific billing destination (Currently only support
- # bill against consumer project).
- "metrics": [ # Names of the metrics to report to this billing destination.
- # Each name must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
- },
- ],
- },
- "systemTypes": [ # 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.
- { # A protocol buffer message type.
- "fields": [ # The list of fields.
- { # A single field of a message type.
- "number": 42, # The field number.
- "name": "A String", # The field name.
- "kind": "A String", # The field type.
- "jsonName": "A String", # The field JSON name.
- "cardinality": "A String", # The field cardinality.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "defaultValue": "A String", # The string value of the default value of this field. Proto2 syntax only.
- "packed": True or False, # Whether to use alternative packed wire representation.
- "oneofIndex": 42, # The index of the field type in `Type.oneofs`, for message or enumeration
- # types. The first type has index 1; zero means the type is not in the list.
- "typeUrl": "A String", # The field type URL, without the scheme, for message or enumeration
- # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
- },
- ],
- "oneofs": [ # The list of types appearing in `oneof` definitions in this type.
- "A String",
- ],
- "name": "A String", # The fully qualified message name.
- "options": [ # The protocol buffer options.
- { # A protocol buffer option, which can be attached to a message, field,
- # enumeration, etc.
- "name": "A String", # The option's name. For protobuf built-in options (options defined in
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
- # For custom options, it should be the fully-qualified name. For example,
- # `"google.api.http"`.
- "value": { # The option's value packed in an Any message. If the value is a primitive,
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
- # should be used. If the value is an enum, it should be stored as an int32
- # value using the google.protobuf.Int32Value type.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- },
- ],
- "syntax": "A String", # The source syntax.
- "sourceContext": { # `SourceContext` represents information about the source of a # The source context.
- # protobuf element, like the file in which it is defined.
- "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
- },
- },
- ],
- "logging": { # Logging configuration of the service. # Logging configuration.
- #
- # The following example shows how to configure logs to be sent to the
- # 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: activity_history
- # labels:
- # - key: /customer_id
- # - name: purchase_history
- # logging:
- # producer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # logs:
- # - activity_history
- # - purchase_history
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # logs:
- # - activity_history
- "consumerDestinations": [ # 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.
- { # Configuration of a specific logging destination (the producer project
- # or the consumer project).
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
- # Service.monitored_resources section.
- "logs": [ # Names of the logs to be sent to this destination. Each name must
- # 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 "/".
- "A String",
- ],
- },
- ],
- "producerDestinations": [ # Logging configurations for sending logs to the producer project.
- # There can be multiple producer destinations, each one must have a
- # different monitored resource type. A log can be used in at most
- # one producer destination.
- { # Configuration of a specific logging destination (the producer project
- # or the consumer project).
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in the
- # Service.monitored_resources section.
- "logs": [ # Names of the logs to be sent to this destination. Each name must
- # 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 "/".
- "A String",
- ],
- },
- ],
- },
- "monitoredResources": [ # Defines the monitored resources used by this service. This is required
- # by the Service.monitoring and Service.logging configurations.
- { # An object that describes the schema of a MonitoredResource object using a
- # type name and a set of labels. For example, the monitored resource
- # descriptor for Google Compute Engine VM instances has a type of
- # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
- # `"zone"` to identify particular VM instances.
- #
- # Different APIs can support different monitored resource types. APIs generally
- # provide a `list` method that returns the monitored resource descriptors used
- # by the API.
- "launchStage": "A String", # Optional. The launch stage of the monitored resource definition.
- "name": "A String", # Optional. The resource name of the monitored resource descriptor:
- # `"projects/{project_id}/monitoredResourceDescriptors/{type}"` where
- # {type} is the value of the `type` field in this object and
- # {project_id} is a project ID that provides API-specific context for
- # accessing the type. APIs that do not use project information can use the
- # resource name format `"monitoredResourceDescriptors/{type}"`.
- "labels": [ # Required. A set of labels used to describe instances of this monitored
- # resource type. For example, an individual Google Cloud SQL database is
- # identified by values for the labels `"database_id"` and `"zone"`.
+ # - name: library.googleapis.com/activity_history
+ # description: The history of borrowing and returning library items.
+ # display_name: Activity
+ # labels:
+ # - key: /customer_id
+ # description: Identifier of a library customer
+ "description": "A String", # A human-readable description of this log. This information appears in
+ # the documentation and can contain details.
+ "labels": [ # The set of labels that are available to describe a specific log entry.
+ # Runtime requests that contain labels not specified here are
+ # considered invalid.
{ # A description of a label.
"valueType": "A String", # The type of data that can be assigned to the label.
- "key": "A String", # The label key.
"description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
},
],
- "type": "A String", # Required. The monitored resource type. For example, the type
- # `"cloudsql_database"` represents databases in Google Cloud SQL.
- # The maximum length of this value is 256 characters.
- "description": "A String", # Optional. A detailed description of the monitored resource type that might
- # be used in documentation.
- "displayName": "A String", # Optional. A concise name for the monitored resource type that might be
- # displayed in user interfaces. It should be a Title Cased Noun Phrase,
- # without any article or other determiners. For example,
- # `"Google Cloud SQL Database"`.
+ "displayName": "A String", # The human-readable name for this log. This information appears on
+ # the user interface and should be concise.
+ "name": "A String", # The name of the log. It must be less than 512 characters long and can
+ # include the following characters: upper- and lower-case alphanumeric
+ # characters [A-Za-z0-9], and punctuation characters including
+ # slash, underscore, hyphen, period [/_-.].
},
],
- "monitoring": { # Monitoring configuration of the service. # Monitoring configuration.
- #
- # The example below shows how to configure monitored resources and metrics
- # for monitoring. In the example, a monitored resource and two metrics are
- # defined. The `library.googleapis.com/book/returned_count` metric is sent
- # to both producer and consumer projects, whereas the
- # `library.googleapis.com/book/overdue_count` metric is only sent to the
- # consumer 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.
- # metrics:
- # - name: library.googleapis.com/book/returned_count
- # metric_kind: DELTA
- # value_type: INT64
- # labels:
- # - key: /customer_id
- # - name: library.googleapis.com/book/overdue_count
- # metric_kind: GAUGE
- # value_type: INT64
- # labels:
- # - key: /customer_id
- # monitoring:
- # producer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # metrics:
- # - library.googleapis.com/book/returned_count
- # consumer_destinations:
- # - monitored_resource: library.googleapis.com/branch
- # metrics:
- # - library.googleapis.com/book/returned_count
- # - library.googleapis.com/book/overdue_count
- "producerDestinations": [ # Monitoring configurations for sending metrics to the producer project.
- # There can be multiple producer destinations. A monitored resouce type may
- # appear in multiple monitoring destinations if different aggregations are
- # needed for different sets of metrics associated with that monitored
- # resource type. A monitored resource and metric pair may only be used once
- # in the Monitoring configuration.
- { # Configuration of a specific monitoring destination (the producer project
- # or the consumer project).
- "metrics": [ # Types of the metrics to report to this monitoring destination.
- # Each type must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
+ "metrics": [ # Defines the metrics used by this service.
+ { # 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.
+ #
+ # The following are specific rules for service defined Monitoring metric
+ # descriptors:
+ #
+ # * `type`, `metric_kind`, `value_type`, `description`, and `display_name`
+ # fields are all required. The `unit` field must be specified
+ # if the `value_type` is any of DOUBLE, INT64, DISTRIBUTION.
+ # * Maximum of default 500 metric descriptors per service is allowed.
+ # * Maximum of default 10 labels per metric descriptor is allowed.
+ #
+ # The default maximum limit can be overridden. Please follow
+ # https://cloud.google.com/monitoring/quotas
+ "unit": "A String", # The units in which the metric value is reported. It is only applicable
+ # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit`
+ # defines the representation of the stored metric values.
+ #
+ # Different systems may scale the values to be more easily displayed (so a
+ # value of `0.02KBy` _might_ be displayed as `20By`, and a value of
+ # `3523KBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is
+ # `KBy`, then the value of the metric is always in thousands of bytes, no
+ # matter how it may be displayed..
+ #
+ # If you want a custom metric to record the exact number of CPU-seconds used
+ # by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is
+ # `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005
+ # CPU-seconds, then the value is written as `12005`.
+ #
+ # Alternatively, if you want a custom metric to record data in a more
+ # granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
+ # `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`),
+ # or use `Kis{CPU}` and write `11.723` (which is `12005/1024`).
+ #
+ # The supported units are a subset of [The Unified Code for Units of
+ # Measure](http://unitsofmeasure.org/ucum.html) standard:
+ #
+ # **Basic units (UNIT)**
+ #
+ # * `bit` bit
+ # * `By` byte
+ # * `s` second
+ # * `min` minute
+ # * `h` hour
+ # * `d` day
+ # * `1` dimensionless
+ #
+ # **Prefixes (PREFIX)**
+ #
+ # * `k` kilo (10^3)
+ # * `M` mega (10^6)
+ # * `G` giga (10^9)
+ # * `T` tera (10^12)
+ # * `P` peta (10^15)
+ # * `E` exa (10^18)
+ # * `Z` zetta (10^21)
+ # * `Y` yotta (10^24)
+ #
+ # * `m` milli (10^-3)
+ # * `u` micro (10^-6)
+ # * `n` nano (10^-9)
+ # * `p` pico (10^-12)
+ # * `f` femto (10^-15)
+ # * `a` atto (10^-18)
+ # * `z` zepto (10^-21)
+ # * `y` yocto (10^-24)
+ #
+ # * `Ki` kibi (2^10)
+ # * `Mi` mebi (2^20)
+ # * `Gi` gibi (2^30)
+ # * `Ti` tebi (2^40)
+ # * `Pi` pebi (2^50)
+ #
+ # **Grammar**
+ #
+ # The grammar also includes these connectors:
+ #
+ # * `/` division or ratio (as an infix operator). For examples,
+ # `kBy/{email}` or `MiBy/10ms` (although you should almost never
+ # have `/s` in a metric `unit`; rates should always be computed at
+ # query time from the underlying cumulative or delta value).
+ # * `.` multiplication or composition (as an infix operator). For
+ # examples, `GBy.d` or `k{watt}.h`.
+ #
+ # The grammar for a unit is as follows:
+ #
+ # Expression = Component { "." Component } { "/" Component } ;
+ #
+ # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
+ # | Annotation
+ # | "1"
+ # ;
+ #
+ # Annotation = "{" NAME "}" ;
+ #
+ # Notes:
+ #
+ # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
+ # is used alone, then the unit is equivalent to `1`. For examples,
+ # `{request}/s == 1/s`, `By{transmitted}/s == By/s`.
+ # * `NAME` is a sequence of non-blank printable ASCII characters not
+ # containing `{` or `}`.
+ # * `1` represents a unitary [dimensionless
+ # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
+ # as in `1/s`. It is typically used when none of the basic units are
+ # appropriate. For example, "new users per day" can be represented as
+ # `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new
+ # users). Alternatively, "thousands of page views per day" would be
+ # represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric
+ # value of `5.3` would mean "5300 page views per day").
+ # * `%` represents dimensionless value of 1/100, and annotates values giving
+ # a percentage (so the metric values are typically in the range of 0..100,
+ # and a metric value `3` means "3 percent").
+ # * `10^2.%` indicates a metric contains a ratio, typically in the range
+ # 0..1, that will be multiplied by 100 and displayed as a percentage
+ # (so a metric value `0.03` means "3 percent").
+ "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
+ # Use sentence case without an ending period, for example "Request count".
+ # This field is optional but it is recommended to be set for any metrics
+ # associated with user-visible concepts, such as Quota.
+ "monitoredResourceTypes": [ # Read-only. If present, then a time
+ # series, which is identified partially by
+ # a metric type and a MonitoredResourceDescriptor, that is associated
+ # with this metric type can only be associated with one of the monitored
+ # resource types listed here.
+ "A String",
+ ],
+ "metadata": { # Additional annotations that can be used to guide the usage of a metric. # Optional. Metadata which can be used to guide usage of the metric.
+ "samplePeriod": "A String", # The sampling period of metric data points. For metrics which are written
+ # periodically, consecutive data points are stored at this time interval,
+ # excluding data loss due to errors. Metrics with a higher granularity have
+ # a smaller sampling period.
+ "ingestDelay": "A String", # The delay of data points caused by ingestion. Data points older than this
+ # age are guaranteed to be ingested and available to be read, excluding
+ # data loss due to errors.
+ "launchStage": "A String", # Deprecated. Must use the MetricDescriptor.launch_stage instead.
},
- ],
- "consumerDestinations": [ # Monitoring configurations for sending metrics to the consumer project.
- # There can be multiple consumer destinations. A monitored resouce type may
- # appear in multiple monitoring destinations if different aggregations are
- # needed for different sets of metrics associated with that monitored
- # resource type. A monitored resource and metric pair may only be used once
- # in the Monitoring configuration.
- { # Configuration of a specific monitoring destination (the producer project
- # or the consumer project).
- "metrics": [ # Types of the metrics to report to this monitoring destination.
- # Each type must be defined in Service.metrics section.
- "A String",
- ],
- "monitoredResource": "A String", # The monitored resource type. The type must be defined in
- # Service.monitored_resources section.
- },
- ],
- },
- "systemParameters": { # ### System parameter configuration # System parameter configuration.
+ "name": "A String", # The resource name of the metric descriptor.
+ "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
+ # Some combinations of `metric_kind` and `value_type` might not be supported.
+ "launchStage": "A String", # Optional. The launch stage of the metric definition.
+ "type": "A String", # The metric type, including its DNS name prefix. The type is not
+ # URL-encoded.
+ #
+ # All service defined metrics must be prefixed with the service name, in the
+ # format of `{service name}/{relative metric name}`, such as
+ # `cloudsql.googleapis.com/database/cpu/utilization`. The relative metric
+ # name must follow:
+ #
+ # * Only upper and lower-case letters, digits, '/' and underscores '_' are
+ # allowed.
+ # * The maximum number of characters allowed for the relative_metric_name is
+ # 100.
+ #
+ # All user-defined metric types have the DNS name
+ # `custom.googleapis.com`, `external.googleapis.com`, or
+ # `logging.googleapis.com/user/`.
+ #
+ # Metric types should use a natural hierarchical grouping. For example:
+ #
+ # "custom.googleapis.com/invoice/paid/amount"
+ # "external.googleapis.com/prometheus/up"
+ # "appengine.googleapis.com/http/server/response_latencies"
+ "description": "A String", # A detailed description of the metric, which can be used in documentation.
+ "labels": [ # The set of labels that can be used to describe a specific
+ # instance of this metric type.
+ #
+ # The label key name must follow:
+ #
+ # * Only upper and lower-case letters, digits and underscores (_) are
+ # allowed.
+ # * Label name must start with a letter or digit.
+ # * The maximum length of a label name is 100 characters.
+ #
+ # 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.
+ { # A description of a label.
+ "valueType": "A String", # The type of data that can be assigned to the label.
+ "description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
+ },
+ ],
+ "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc.
+ # Some combinations of `metric_kind` and `value_type` might not be supported.
+ },
+ ],
+ "documentation": { # `Documentation` provides the information for describing a service. # Additional API documentation.
#
- # A system parameter is a special kind of parameter defined by the API
- # system, not by an individual API. It is typically mapped to an HTTP header
- # and/or a URL query parameter. This configuration specifies which methods
- # change the names of the system parameters.
- "rules": [ # Define system parameters.
- #
- # The parameters defined here will override the default parameters
- # implemented by the system. If this field is missing from the service
- # config, default system parameters will be used. Default system parameters
- # and names is implementation-dependent.
- #
- # Example: define api key for all methods
- #
- # system_parameters
- # rules:
- # - selector: "*"
- # parameters:
- # - name: api_key
- # url_query_parameter: api_key
- #
- #
- # Example: define 2 api key names for a specific method.
- #
- # system_parameters
- # rules:
- # - selector: "/ListShelves"
- # parameters:
- # - name: api_key
- # http_header: Api-Key1
- # - name: api_key
- # http_header: Api-Key2
+ # Example:
+ # <pre><code>documentation:
+ # summary: >
+ # The Google Calendar API gives access
+ # to most calendar features.
+ # pages:
+ # - name: Overview
+ # content: &#40;== include google/foo/overview.md ==&#41;
+ # - name: Tutorial
+ # content: &#40;== include google/foo/tutorial.md ==&#41;
+ # subpages;
+ # - name: Java
+ # content: &#40;== include google/foo/tutorial_java.md ==&#41;
+ # rules:
+ # - selector: google.calendar.Calendar.Get
+ # description: >
+ # ...
+ # - selector: google.calendar.Calendar.Put
+ # description: >
+ # ...
+ # </code></pre>
+ # Documentation is provided in markdown syntax. In addition to
+ # standard markdown features, definition lists, tables and fenced
+ # code blocks are supported. Section headers can be provided and are
+ # interpreted relative to the section nesting of the context where
+ # a documentation fragment is embedded.
+ #
+ # Documentation from the IDL is merged with documentation defined
+ # via the config at normalization time, where documentation provided
+ # by config rules overrides IDL provided.
+ #
+ # A number of constructs specific to the API platform are supported
+ # in documentation text.
+ #
+ # In order to reference a proto element, the following
+ # notation can be used:
+ # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
+ # To override the display text used for the link, this can be used:
+ # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
+ # Text can be excluded from doc using the following notation:
+ # <pre><code>&#40;-- internal comment --&#41;</code></pre>
+ #
+ # A few directives are available in documentation. Note that
+ # directives must appear on a single line to be properly
+ # identified. The `include` directive includes a markdown file from
+ # an external source:
+ # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
+ # The `resource_for` directive marks a message to be the resource of
+ # a collection in REST view. If it is not specified, tools attempt
+ # to infer the resource from the operations in a collection:
+ # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
+ # The directive `suppress_warning` does not directly affect documentation
+ # and is documented together with service config validation.
+ "serviceRootUrl": "A String", # Specifies the service root url if the default one (the service name
+ # from the yaml file) is not suitable. This can be seen in any fully
+ # specified service urls as well as sections that show a base that other
+ # urls are relative to.
+ "overview": "A String", # Declares a single overview page. For example:
+ # <pre><code>documentation:
+ # summary: ...
+ # overview: &#40;== include overview.md ==&#41;
+ # </code></pre>
+ # This is a shortcut for the following declaration (using pages style):
+ # <pre><code>documentation:
+ # summary: ...
+ # pages:
+ # - name: Overview
+ # content: &#40;== include overview.md ==&#41;
+ # </code></pre>
+ # Note: you cannot specify both `overview` field and `pages` field.
+ "documentationRootUrl": "A String", # The URL to the root of documentation.
+ "rules": [ # A list of documentation rules that apply to individual API elements.
#
# **NOTE:** All service configuration rules follow "last one wins" order.
- { # Define a system parameter rule mapping system parameter definitions to
- # methods.
- "parameters": [ # Define parameters. Multiple names may be defined for a parameter.
- # For a given method call, only one of them should be used. If multiple
- # names are used the behavior is implementation-dependent.
- # If none of the specified names are present the behavior is
- # parameter-dependent.
- { # Define a parameter's name and location. The parameter may be passed as either
- # an HTTP header or a URL query parameter, and if both are passed the behavior
- # is implementation-dependent.
- "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
- "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
- # sensitive.
- "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
- # insensitive.
- },
- ],
- "selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
- # methods in all APIs.
- #
- # Refer to selector for syntax details.
+ { # A documentation rule provides information about individual API elements.
+ "deprecationDescription": "A String", # Deprecation description of the selected element(s). It can be provided if
+ # an element is marked as `deprecated`.
+ "description": "A String", # Description of the selected API(s).
+ "selector": "A String", # The selector is a comma-separated list of patterns. Each pattern is a
+ # qualified name of the element which may end in "*", indicating a wildcard.
+ # Wildcards are only allowed at the end and for a whole component of the
+ # qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A
+ # wildcard will match one or more components. To specify a default for all
+ # applicable elements, the whole pattern "*" is used.
},
],
+ "pages": [ # The top level pages for the documentation set.
+ { # Represents a documentation page. A page can contain subpages to represent
+ # nested documentation set structure.
+ "content": "A String", # The Markdown content of the page. You can use <code>&#40;== include {path}
+ # ==&#41;</code> to include content from a Markdown file.
+ "name": "A String", # The name of the page. It will be used as an identity of the page to
+ # generate URI of the page, text of the link to this page in navigation,
+ # etc. The full page name (start from the root page name to this page
+ # concatenated with `.`) can be used as reference to the page in your
+ # documentation. For example:
+ # <pre><code>pages:
+ # - name: Tutorial
+ # content: &#40;== include tutorial.md ==&#41;
+ # subpages:
+ # - name: Java
+ # content: &#40;== include tutorial_java.md ==&#41;
+ # </code></pre>
+ # You can reference `Java` page using Markdown reference link syntax:
+ # `Java`.
+ "subpages": [ # Subpages of this page. The order of subpages specified here will be
+ # honored in the generated docset.
+ # Object with schema name: Page
+ ],
+ },
+ ],
+ "summary": "A String", # A short summary of what the service does. Can only be provided by
+ # plain text.
},
+ "configVersion": 42, # The semantic version of the service configuration. The config version
+ # affects the interpretation of the service configuration. For example,
+ # certain features are enabled by default for certain config versions.
+ #
+ # The latest config version is `3`.
"quota": { # Quota configuration helps to achieve fairness and budgeting in service # Quota configuration.
# usage.
#
@@ -7401,23 +7260,32 @@
# metric_kind: DELTA
# value_type: INT64
#
+ "metricRules": [ # List of `MetricRule` definitions, each one mapping a selected method to one
+ # or more metrics.
+ { # Bind API methods to metrics. Binding a method to a metric causes that
+ # metric's configured quota behaviors to apply to the method call.
+ "selector": "A String", # Selects the methods to which this rule applies.
+ #
+ # Refer to selector for syntax details.
+ "metricCosts": { # Metrics to update when the selected methods are called, and the associated
+ # cost applied to each metric.
+ #
+ # The key of the map is the metric name, and the values are the amount
+ # increased for the metric against which the quota limits are defined.
+ # The value must not be negative.
+ "a_key": "A String",
+ },
+ },
+ ],
"limits": [ # List of `QuotaLimit` definitions for the service.
{ # `QuotaLimit` defines a specific limit that applies over a specified duration
# for a limit type. There can be at most one limit for a duration and limit
# type combination defined within a `QuotaGroup`.
- "displayName": "A String", # User-visible display name for this limit.
- # Optional. If not set, the UI will provide a default display name based on
- # the quota configuration. This field can be used to override the default
- # display name generated from the configuration.
- "maxLimit": "A String", # Maximum number of tokens that can be consumed during the specified
- # duration. Client application developers can override the default limit up
- # to this maximum. If specified, this value cannot be set to a value less
- # than the default limit. If not specified, it is set to the default limit.
- #
- # To allow clients to apply overrides with no upper bound, set this to -1,
- # indicating unlimited maximum quota.
- #
- # Used by group-based quotas only.
+ "values": { # Tiered limit values. You must specify this as a key:value pair, with an
+ # integer value that is the maximum number of requests allowed for the
+ # specified unit. Currently only STANDARD is supported.
+ "a_key": "A String",
+ },
"duration": "A String", # Duration of this limit in textual notation. Must be "100s" or "1d".
#
# Used by group-based quotas only.
@@ -7429,15 +7297,13 @@
# defaults to 0, indicating that there is no free tier for this service.
#
# Used by group-based quotas only.
- "unit": "A String", # Specify the unit of the quota limit. It uses the same syntax as
- # Metric.unit. The supported unit kinds are determined by the quota
- # backend system.
- #
- # Here are some examples:
- # * "1/min/{project}" for quota per minute per project.
- #
- # Note: the order of unit components is insignificant.
- # The "1" at the beginning is required to follow the metric unit syntax.
+ "displayName": "A String", # User-visible display name for this limit.
+ # Optional. If not set, the UI will provide a default display name based on
+ # the quota configuration. This field can be used to override the default
+ # display name generated from the configuration.
+ "description": "A String", # Optional. User-visible, extended description for this quota limit.
+ # Should be used only when more context is needed to understand this limit
+ # than provided by the limit's display name (see: `display_name`).
"defaultLimit": "A String", # Default number of tokens that can be consumed during the specified
# duration. This is the number of tokens assigned when a client
# application developer activates the service for his/her project.
@@ -7448,43 +7314,568 @@
# negative values are allowed.
#
# Used by group-based quotas only.
- "values": { # Tiered limit values. You must specify this as a key:value pair, with an
- # integer value that is the maximum number of requests allowed for the
- # specified unit. Currently only STANDARD is supported.
- "a_key": "A String",
- },
"name": "A String", # Name of the quota limit.
#
# The name must be provided, and it must be unique within the service. The
# name can only include alphanumeric characters as well as '-'.
#
# The maximum length of the limit name is 64 characters.
+ "maxLimit": "A String", # Maximum number of tokens that can be consumed during the specified
+ # duration. Client application developers can override the default limit up
+ # to this maximum. If specified, this value cannot be set to a value less
+ # than the default limit. If not specified, it is set to the default limit.
+ #
+ # To allow clients to apply overrides with no upper bound, set this to -1,
+ # indicating unlimited maximum quota.
+ #
+ # Used by group-based quotas only.
"metric": "A String", # The name of the metric this quota limit applies to. The quota limits with
# the same metric will be checked together during runtime. The metric must be
# defined within the service config.
- "description": "A String", # Optional. User-visible, extended description for this quota limit.
- # Should be used only when more context is needed to understand this limit
- # than provided by the limit's display name (see: `display_name`).
+ "unit": "A String", # Specify the unit of the quota limit. It uses the same syntax as
+ # Metric.unit. The supported unit kinds are determined by the quota
+ # backend system.
+ #
+ # Here are some examples:
+ # * "1/min/{project}" for quota per minute per project.
+ #
+ # Note: the order of unit components is insignificant.
+ # The "1" at the beginning is required to follow the metric unit syntax.
},
],
- "metricRules": [ # List of `MetricRule` definitions, each one mapping a selected method to one
- # or more metrics.
- { # Bind API methods to metrics. Binding a method to a metric causes that
- # metric's configured quota behaviors to apply to the method call.
- "metricCosts": { # Metrics to update when the selected methods are called, and the associated
- # cost applied to each metric.
+ },
+ "customError": { # Customize service error responses. For example, list any service # Custom error configuration.
+ # specific protobuf types that can appear in error detail lists of
+ # error responses.
+ #
+ # Example:
+ #
+ # custom_error:
+ # types:
+ # - google.foo.v1.CustomError
+ # - google.foo.v1.AnotherError
+ "types": [ # The list of custom error detail types, e.g. 'google.foo.v1.CustomError'.
+ "A String",
+ ],
+ "rules": [ # The list of custom error rules that apply to individual API messages.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # A custom error rule.
+ "selector": "A String", # Selects messages to which this rule applies.
#
- # The key of the map is the metric name, and the values are the amount
- # increased for the metric against which the quota limits are defined.
- # The value must not be negative.
- "a_key": "A String",
+ # Refer to selector for syntax details.
+ "isErrorType": True or False, # Mark this message as possible payload in error response. Otherwise,
+ # objects of this type will be filtered when they appear in error payload.
+ },
+ ],
+ },
+ "authentication": { # `Authentication` defines the authentication configuration for an API. # Auth configuration.
+ #
+ # Example for an API targeted for external use:
+ #
+ # name: calendar.googleapis.com
+ # authentication:
+ # providers:
+ # - id: google_calendar_auth
+ # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+ # issuer: https://securetoken.google.com
+ # rules:
+ # - selector: "*"
+ # requirements:
+ # provider_id: google_calendar_auth
+ "rules": [ # A list of authentication rules that apply to individual API methods.
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # Authentication rules for the service.
+ #
+ # By default, if a method has any authentication requirements, every request
+ # must include a valid credential matching one of the requirements.
+ # It's an error to include more than one kind of credential in a single
+ # request.
+ #
+ # If a method doesn't have any auth requirements, request credentials will be
+ # ignored.
+ "oauth": { # OAuth scopes are a way to define data and permissions on data. For example, # The requirements for OAuth credentials.
+ # there are scopes defined for "Read-only access to Google Calendar" and
+ # "Access to Cloud Platform". Users can consent to a scope for an application,
+ # giving it permission to access that data on their behalf.
+ #
+ # OAuth scope specifications should be fairly coarse grained; a user will need
+ # to see and understand the text description of what your scope means.
+ #
+ # In most cases: use one or at most two OAuth scopes for an entire family of
+ # products. If your product has multiple APIs, you should probably be sharing
+ # the OAuth scope across all of those APIs.
+ #
+ # When you need finer grained OAuth consent screens: talk with your product
+ # management about how developers will use them in practice.
+ #
+ # Please note that even though each of the canonical scopes is enough for a
+ # request to be accepted and passed to the backend, a request can still fail
+ # due to the backend requiring additional scopes or permissions.
+ "canonicalScopes": "A String", # The list of publicly documented OAuth scopes that are allowed access. An
+ # OAuth token containing any of these scopes will be accepted.
+ #
+ # Example:
+ #
+ # canonical_scopes: https://www.googleapis.com/auth/calendar,
+ # https://www.googleapis.com/auth/calendar.read
},
+ "requirements": [ # Requirements for additional authentication providers.
+ { # User-defined authentication requirements, including support for
+ # [JSON Web Token
+ # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
+ "providerId": "A String", # id from authentication provider.
+ #
+ # Example:
+ #
+ # provider_id: bookstore_auth
+ "audiences": "A String", # 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:
+ #
+ # audiences: bookstore_android.apps.googleusercontent.com,
+ # bookstore_web.apps.googleusercontent.com
+ },
+ ],
+ "allowWithoutCredential": True or False, # If true, the service accepts API keys without any other credential.
"selector": "A String", # Selects the methods to which this rule applies.
#
# Refer to selector for syntax details.
},
],
+ "providers": [ # Defines a set of authentication providers that a service supports.
+ { # Configuration for an authentication provider, including support for
+ # [JSON Web Token
+ # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
+ "id": "A String", # The unique identifier of the auth provider. It will be referred to by
+ # `AuthRequirement.provider_id`.
+ #
+ # Example: "bookstore_auth".
+ "issuer": "A String", # 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.
+ #
+ # Example: https://securetoken.google.com
+ # Example: 1234567-compute@developer.gserviceaccount.com
+ "jwksUri": "A String", # URL of the provider's public key set to validate signature of the JWT. See
+ # [OpenID
+ # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).
+ # Optional if the key set document:
+ # - can be retrieved from
+ # [OpenID
+ # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
+ # the issuer.
+ # - can be inferred from the email domain of the issuer (e.g. a Google
+ # service account).
+ #
+ # Example: https://www.googleapis.com/oauth2/v1/certs
+ "audiences": "A String", # 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, JWTs with audiences:
+ # - "https://[service.name]/[google.protobuf.Api.name]"
+ # - "https://[service.name]/"
+ # will be accepted.
+ # For example, if no audiences are in the setting, LibraryService API will
+ # accept JWTs with the following audiences:
+ # -
+ # https://library-example.googleapis.com/google.example.library.v1.LibraryService
+ # - https://library-example.googleapis.com/
+ #
+ # Example:
+ #
+ # audiences: bookstore_android.apps.googleusercontent.com,
+ # bookstore_web.apps.googleusercontent.com
+ "authorizationUrl": "A String", # Redirect URL if JWT token is required but not present or is expired.
+ # Implement authorizationUrl of securityDefinitions in OpenAPI spec.
+ "jwtLocations": [ # Defines the locations to extract the JWT.
+ #
+ # JWT locations can be either from HTTP headers or URL query parameters.
+ # The rule is that the first match wins. The checking order is: checking
+ # all headers first, then URL query parameters.
+ #
+ # If not specified, default to use following 3 locations:
+ # 1) Authorization: Bearer
+ # 2) x-goog-iap-jwt-assertion
+ # 3) access_token query parameter
+ #
+ # Default locations can be specified as followings:
+ # jwt_locations:
+ # - header: Authorization
+ # value_prefix: "Bearer "
+ # - header: x-goog-iap-jwt-assertion
+ # - query: access_token
+ { # Specifies a location to extract JWT from an API request.
+ "query": "A String", # Specifies URL query parameter name to extract JWT token.
+ "valuePrefix": "A String", # The value prefix. The value format is "value_prefix{token}"
+ # Only applies to "in" header type. Must be empty for "in" query type.
+ # If not empty, the header value has to match (case sensitive) this prefix.
+ # If not matched, JWT will not be extracted. If matched, JWT will be
+ # extracted after the prefix is removed.
+ #
+ # For example, for "Authorization: Bearer {JWT}",
+ # value_prefix="Bearer " with a space at the end.
+ "header": "A String", # Specifies HTTP header name to extract JWT token.
+ },
+ ],
+ },
+ ],
},
+ "title": "A String", # The product title for this service.
+ "producerProjectId": "A String", # The Google project that owns this service.
+ "apis": [ # 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.
+ { # Api is a light-weight descriptor for an API Interface.
+ #
+ # Interfaces are also described as "protocol buffer services" in some contexts,
+ # such as by the "service" keyword in a .proto file, but they are different
+ # from API Services, which represent a concrete implementation of an interface
+ # as opposed to simply a description of methods and bindings. They are also
+ # sometimes simply referred to as "APIs" in other contexts, such as the name of
+ # this message itself. See https://cloud.google.com/apis/design/glossary for
+ # detailed terminology.
+ "sourceContext": { # `SourceContext` represents information about the source of a # Source context for the protocol buffer service represented by this
+ # message.
+ # protobuf element, like the file in which it is defined.
+ "fileName": "A String", # The path-qualified name of the .proto file that contained the associated
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
+ },
+ "syntax": "A String", # The source syntax of the service.
+ "methods": [ # The methods of this interface, in unspecified order.
+ { # Method represents a method of an API interface.
+ "options": [ # Any metadata attached to the method.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "responseStreaming": True or False, # If true, the response is streamed.
+ "syntax": "A String", # The source syntax of this method.
+ "requestTypeUrl": "A String", # A URL of the input message type.
+ "name": "A String", # The simple name of this method.
+ "responseTypeUrl": "A String", # The URL of the output message type.
+ "requestStreaming": True or False, # If true, the request is streamed.
+ },
+ ],
+ "name": "A String", # The fully qualified name of this interface, including package name
+ # followed by the interface's simple name.
+ "version": "A String", # A version string for this interface. If specified, must have the form
+ # `major-version.minor-version`, as in `1.10`. If the minor version is
+ # omitted, it defaults to zero. If the entire version field is empty, the
+ # major version is derived from the package name, as outlined below. If the
+ # field is not empty, the version in the package name will be verified to be
+ # consistent with what is provided here.
+ #
+ # The versioning schema uses [semantic
+ # versioning](http://semver.org) where the major version number
+ # indicates a breaking change and the minor version an additive,
+ # non-breaking change. Both version numbers are signals to users
+ # what to expect from different versions, and should be carefully
+ # chosen based on the product plan.
+ #
+ # The major version is also reflected in the package name of the
+ # interface, which must end in `v<major-version>`, as in
+ # `google.feature.v1`. For major versions 0 and 1, the suffix can
+ # be omitted. Zero major versions must only be used for
+ # experimental, non-GA interfaces.
+ "options": [ # Any metadata attached to the interface.
+ { # A protocol buffer option, which can be attached to a message, field,
+ # enumeration, etc.
+ "value": { # The option's value packed in an Any message. If the value is a primitive,
+ # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+ # should be used. If the value is an enum, it should be stored as an int32
+ # value using the google.protobuf.Int32Value type.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The option's name. For protobuf built-in options (options defined in
+ # descriptor.proto), this is the short name. For example, `"map_entry"`.
+ # For custom options, it should be the fully-qualified name. For example,
+ # `"google.api.http"`.
+ },
+ ],
+ "mixins": [ # Included interfaces. See Mixin.
+ { # Declares an API Interface to be included in this interface. The including
+ # interface must redeclare all the methods from the included interface, but
+ # documentation and options are inherited as follows:
+ #
+ # - If after comment and whitespace stripping, the documentation
+ # string of the redeclared method is empty, it will be inherited
+ # from the original method.
+ #
+ # - Each annotation belonging to the service config (http,
+ # visibility) which is not set in the redeclared method will be
+ # inherited.
+ #
+ # - If an http annotation is inherited, the path pattern will be
+ # modified as follows. Any version prefix will be replaced by the
+ # version of the including interface plus the root path if
+ # specified.
+ #
+ # Example of a simple mixin:
+ #
+ # package google.acl.v1;
+ # service AccessControl {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v1/{resource=**}:getAcl";
+ # }
+ # }
+ #
+ # package google.storage.v2;
+ # service Storage {
+ # // rpc GetAcl(GetAclRequest) returns (Acl);
+ #
+ # // Get a data record.
+ # rpc GetData(GetDataRequest) returns (Data) {
+ # option (google.api.http).get = "/v2/{resource=**}";
+ # }
+ # }
+ #
+ # Example of a mixin configuration:
+ #
+ # apis:
+ # - name: google.storage.v2.Storage
+ # mixins:
+ # - name: google.acl.v1.AccessControl
+ #
+ # The mixin construct implies that all methods in `AccessControl` are
+ # also declared with same name and request/response types in
+ # `Storage`. A documentation generator or annotation processor will
+ # see the effective `Storage.GetAcl` method after inherting
+ # documentation and annotations as follows:
+ #
+ # service Storage {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v2/{resource=**}:getAcl";
+ # }
+ # ...
+ # }
+ #
+ # Note how the version in the path pattern changed from `v1` to `v2`.
+ #
+ # If the `root` field in the mixin is specified, it should be a
+ # relative path under which inherited HTTP paths are placed. Example:
+ #
+ # apis:
+ # - name: google.storage.v2.Storage
+ # mixins:
+ # - name: google.acl.v1.AccessControl
+ # root: acls
+ #
+ # This implies the following inherited HTTP annotation:
+ #
+ # service Storage {
+ # // Get the underlying ACL object.
+ # rpc GetAcl(GetAclRequest) returns (Acl) {
+ # option (google.api.http).get = "/v2/acls/{resource=**}:getAcl";
+ # }
+ # ...
+ # }
+ "root": "A String", # If non-empty specifies a path under which inherited HTTP paths
+ # are rooted.
+ "name": "A String", # The fully qualified name of the interface which is included.
+ },
+ ],
+ },
+ ],
+ "id": "A String", # A unique ID for a specific instance of this message, typically assigned
+ # by the client for tracking purpose. Must be no longer than 63 characters
+ # and only lower case letters, digits, '.', '_' and '-' are allowed. If
+ # empty, the server may choose to generate one instead.
+ "endpoints": [ # Configuration for network endpoints. If this is empty, then an endpoint
+ # with the same name as the service is automatically generated to service all
+ # defined APIs.
+ { # `Endpoint` describes a network endpoint that serves a set of APIs.
+ # A service may expose any number of endpoints, and all endpoints share the
+ # same service configuration, such as quota configuration and monitoring
+ # configuration.
+ #
+ # Example service configuration:
+ #
+ # name: library-example.googleapis.com
+ # endpoints:
+ # # Below entry makes 'google.example.library.v1.Library'
+ # # API be served from endpoint address library-example.googleapis.com.
+ # # It also allows HTTP OPTIONS calls to be passed to the backend, for
+ # # it to decide whether the subsequent cross-origin request is
+ # # allowed to proceed.
+ # - name: library-example.googleapis.com
+ # allow_cors: true
+ "name": "A String", # The canonical name of this endpoint.
+ "allowCors": True or False, # Allowing
+ # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
+ # cross-domain traffic, would allow the backends served from this endpoint to
+ # receive and respond to HTTP OPTIONS requests. The response will be used by
+ # the browser to determine whether the subsequent cross-origin request is
+ # allowed to proceed.
+ "target": "A String", # The specification of an Internet routable address of API frontend that will
+ # handle requests to this [API
+ # Endpoint](https://cloud.google.com/apis/design/glossary). It should be
+ # either a valid IPv4 address or a fully-qualified domain name. For example,
+ # "8.8.8.8" or "myservice.appspot.com".
+ "aliases": [ # DEPRECATED: This field is no longer supported. Instead of using aliases,
+ # please specify multiple google.api.Endpoint for each of the intended
+ # aliases.
+ #
+ # Additional names that this endpoint will be hosted on.
+ "A String",
+ ],
+ },
+ ],
+ "systemParameters": { # ### System parameter configuration # System parameter configuration.
+ #
+ # A system parameter is a special kind of parameter defined by the API
+ # system, not by an individual API. It is typically mapped to an HTTP header
+ # and/or a URL query parameter. This configuration specifies which methods
+ # change the names of the system parameters.
+ "rules": [ # Define system parameters.
+ #
+ # The parameters defined here will override the default parameters
+ # implemented by the system. If this field is missing from the service
+ # config, default system parameters will be used. Default system parameters
+ # and names is implementation-dependent.
+ #
+ # Example: define api key for all methods
+ #
+ # system_parameters
+ # rules:
+ # - selector: "*"
+ # parameters:
+ # - name: api_key
+ # url_query_parameter: api_key
+ #
+ #
+ # Example: define 2 api key names for a specific method.
+ #
+ # system_parameters
+ # rules:
+ # - selector: "/ListShelves"
+ # parameters:
+ # - name: api_key
+ # http_header: Api-Key1
+ # - name: api_key
+ # http_header: Api-Key2
+ #
+ # **NOTE:** All service configuration rules follow "last one wins" order.
+ { # Define a system parameter rule mapping system parameter definitions to
+ # methods.
+ "parameters": [ # Define parameters. Multiple names may be defined for a parameter.
+ # For a given method call, only one of them should be used. If multiple
+ # names are used the behavior is implementation-dependent.
+ # If none of the specified names are present the behavior is
+ # parameter-dependent.
+ { # Define a parameter's name and location. The parameter may be passed as either
+ # an HTTP header or a URL query parameter, and if both are passed the behavior
+ # is implementation-dependent.
+ "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
+ "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
+ # insensitive.
+ "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
+ # sensitive.
+ },
+ ],
+ "selector": "A String", # Selects the methods to which this rule applies. Use '*' to indicate all
+ # methods in all APIs.
+ #
+ # Refer to selector for syntax details.
+ },
+ ],
+ },
+ "monitoredResources": [ # Defines the monitored resources used by this service. This is required
+ # by the Service.monitoring and Service.logging configurations.
+ { # An object that describes the schema of a MonitoredResource object using a
+ # type name and a set of labels. For example, the monitored resource
+ # descriptor for Google Compute Engine VM instances has a type of
+ # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
+ # `"zone"` to identify particular VM instances.
+ #
+ # Different services can support different monitored resource types.
+ #
+ # The following are specific rules to service defined monitored resources for
+ # Monitoring and Logging:
+ #
+ # * The `type`, `display_name`, `description`, `labels` and `launch_stage`
+ # fields are all required.
+ # * The first label of the monitored resource descriptor must be
+ # `resource_container`. There are legacy monitored resource descritptors
+ # start with `project_id`.
+ # * It must include a `location` label.
+ # * Maximum of default 5 service defined monitored resource descriptors
+ # is allowed per service.
+ # * Maximum of default 10 labels per monitored resource is allowed.
+ #
+ # The default maximum limit can be overridden. Please follow
+ # https://cloud.google.com/monitoring/quotas
+ "name": "A String", # Optional. The resource name of the monitored resource descriptor:
+ # `"projects/{project_id}/monitoredResourceDescriptors/{type}"` where
+ # {type} is the value of the `type` field in this object and
+ # {project_id} is a project ID that provides API-specific context for
+ # accessing the type. APIs that do not use project information can use the
+ # resource name format `"monitoredResourceDescriptors/{type}"`.
+ "launchStage": "A String", # Optional. The launch stage of the monitored resource definition.
+ "displayName": "A String", # Optional. A concise name for the monitored resource type that might be
+ # displayed in user interfaces. It should be a Title Cased Noun Phrase,
+ # without any article or other determiners. For example,
+ # `"Google Cloud SQL Database"`.
+ "labels": [ # Required. A set of labels used to describe instances of this monitored
+ # resource type.
+ # The label key name must follow:
+ #
+ # * Only upper and lower-case letters, digits and underscores (_) are
+ # allowed.
+ # * Label name must start with a letter or digit.
+ # * The maximum length of a label name is 100 characters.
+ #
+ # For example, an individual Google Cloud SQL database is
+ # identified by values for the labels `database_id` and `location`.
+ { # A description of a label.
+ "valueType": "A String", # The type of data that can be assigned to the label.
+ "description": "A String", # A human-readable description for the label.
+ "key": "A String", # The label key.
+ },
+ ],
+ "description": "A String", # Optional. A detailed description of the monitored resource type that might
+ # be used in documentation.
+ "type": "A String", # Required. The monitored resource type. For example, the type
+ # `cloudsql_database` represents databases in Google Cloud SQL.
+ #
+ # All service defined monitored resource types must be prefixed with the
+ # service name, in the format of `{service name}/{relative resource name}`.
+ # The relative resource name must follow:
+ #
+ # * Only upper and lower-case letters and digits are allowed.
+ # * It must start with upper case character and is recommended to use Upper
+ # Camel Case style.
+ # * The maximum number of characters allowed for the relative_resource_name
+ # is 100.
+ #
+ # Note there are legacy service monitored resources not following this rule.
+ },
+ ],
"context": { # `Context` defines which contexts an API requests. # Context configuration.
#
# Example:
@@ -7526,14 +7917,6 @@
# **NOTE:** All service configuration rules follow "last one wins" order.
{ # A context rule provides information about the context for an individual API
# element.
- "allowedRequestExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
- # side channel from client to backend.
- "A String",
- ],
- "allowedResponseExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
- # side channel from backend to client.
- "A String",
- ],
"selector": "A String", # Selects the methods to which this rule applies.
#
# Refer to selector for syntax details.
@@ -7543,73 +7926,14 @@
"provided": [ # A list of full type names of provided contexts.
"A String",
],
- },
- ],
- },
- "producerProjectId": "A String", # The Google project that owns this service.
- "backend": { # `Backend` defines the backend configuration for a service. # API backend configuration.
- "rules": [ # A list of API backend rules that apply to individual API methods.
- #
- # **NOTE:** All service configuration rules follow "last one wins" order.
- { # A backend rule provides configuration for an individual API element.
- "operationDeadline": 3.14, # The number of seconds to wait for the completion of a long running
- # operation. The default is no deadline.
- "minDeadline": 3.14, # Minimum deadline in seconds needed for this method. Calls having deadline
- # value lower than this will be rejected.
- "address": "A String", # The address of the API backend.
- #
- # The scheme is used to determine the backend protocol and security.
- # The following schemes are accepted:
- #
- # SCHEME PROTOCOL SECURITY
- # http:// HTTP None
- # https:// HTTP TLS
- # grpc:// gRPC None
- # grpcs:// gRPC TLS
- #
- # It is recommended to explicitly include a scheme. Leaving out the scheme
- # may cause constrasting behaviors across platforms.
- #
- # If the port is unspecified, the default is:
- # - 80 for schemes without TLS
- # - 443 for schemes with TLS
- #
- # For HTTP backends, use protocol
- # to specify the protocol version.
- "pathTranslation": "A String",
- "selector": "A String", # Selects the methods to which this rule applies.
- #
- # Refer to selector for syntax details.
- "jwtAudience": "A String", # The JWT audience is used when generating a JWT ID token for the backend.
- # This ID token will be added in the HTTP "authorization" header, and sent
- # to the backend.
- "disableAuth": True or False, # When disable_auth is true, a JWT ID token won't be generated and the
- # original "Authorization" HTTP header will be preserved. If the header is
- # used to carry the original token and is expected by the backend, this
- # field must be set to true to preserve the header.
- "deadline": 3.14, # The number of seconds to wait for a response from a request. The default
- # varies based on the request protocol and deployment environment.
- "protocol": "A String", # The protocol used for sending a request to the backend.
- # The supported values are "http/1.1" and "h2".
- #
- # The default value is inferred from the scheme in the
- # address field:
- #
- # SCHEME PROTOCOL
- # http:// http/1.1
- # https:// http/1.1
- # grpc:// h2
- # grpcs:// h2
- #
- # For secure HTTP backends (https://) that support HTTP/2, set this field
- # to "h2" for improved performance.
- #
- # Configuring this field to non-default values is only supported for secure
- # HTTP backends. This field will be ignored for all other backends.
- #
- # See
- # https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
- # for more details on the supported values.
+ "allowedRequestExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
+ # side channel from client to backend.
+ "A String",
+ ],
+ "allowedResponseExtensions": [ # A list of full type names or extension IDs of extensions allowed in grpc
+ # side channel from backend to client.
+ "A String",
+ ],
},
],
},
@@ -7661,17 +7985,17 @@
# but the generated config and the sources will NOT be persisted.
"configSource": { # Represents a source file which is used to generate the service configuration # Required. The source configuration for the service.
# defined by `google.api.Service`.
- "id": "A String", # 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.
"files": [ # Set of source configuration files that are used to generate a service
# configuration (`google.api.Service`).
{ # Generic specification of a source configuration file
- "filePath": "A String", # The file name of the configuration file (full or relative path).
"fileType": "A String", # The type of configuration file this represents.
+ "filePath": "A String", # The file name of the configuration file (full or relative path).
"fileContents": "A String", # The bytes that constitute the file.
},
],
+ "id": "A String", # 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.
},
}
@@ -7692,20 +8016,17 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
},
- "name": "A String", # The server-assigned name, which is only unique within the same service that
- # originally returns it. If you use the default HTTP mapping, the
- # `name` should be a resource name ending with `operations/{unique_id}`.
"metadata": { # 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
@@ -7725,6 +8046,9 @@
# `TakeSnapshotResponse`.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "name": "A String", # The server-assigned name, which is only unique within the same service that
+ # originally returns it. If you use the default HTTP mapping, the
+ # `name` should be a resource name ending with `operations/{unique_id}`.
}</pre>
</div>