chore: Update discovery artifacts (#1208)
## Discovery Artifact Change Summary:
admindirectory_v1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/3fc3b7614d5df2917e6285a1d4834cbcffd7c665)
adminreports_v1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/3fc3b7614d5df2917e6285a1d4834cbcffd7c665)
admobv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/a2400d9c226a479be6532e1e2822efecc72b87c5)
admobv1beta[ [More details]](https://github.com/googleapis/google-api-python-client/commit/a2400d9c226a479be6532e1e2822efecc72b87c5)
analyticsv3[ [More details]](https://github.com/googleapis/google-api-python-client/commit/61136a15f60ec8deedca3f31a575865c3a28e49b)
analyticsreportingv4[ [More details]](https://github.com/googleapis/google-api-python-client/commit/03ee301449791d11cb7653d9a6431418304e5fbe)
androidenterprisev1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/09a9ddc212d0062fcac494136a4fc21015cfa527)
assuredworkloadsv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/a7b9f4cadc1168ec764f0839027d17a9a474a9ed)
bigquerydatatransferv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/52de288372258c6c926f646e8b77ced31245f705)
classroomv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/ec6203468fc483eec6a65c9464443f2d1a0b79c0)
cloudassetv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/0e739c196ee75a225348798e2eb29b1ba599841a)
cloudassetv1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/0e739c196ee75a225348798e2eb29b1ba599841a)
cloudassetv1p1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/0e739c196ee75a225348798e2eb29b1ba599841a)
cloudassetv1p4beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/0e739c196ee75a225348798e2eb29b1ba599841a)
cloudassetv1p5beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/0e739c196ee75a225348798e2eb29b1ba599841a)
cloudassetv1p7beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/0e739c196ee75a225348798e2eb29b1ba599841a)
clouderrorreportingv1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/aee2d1da567892798889b6231852bfb48a749de1)
cloudiotv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/c1635fdcd108c85ca6be0901ecb9f7f7468b7e3d)
cloudsearchv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/3ee9ab15d37a6c933d8b48eda9fec8125309040a)
cloudshellv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/e10759569feb88aa1a02472719a21f7beaa8a349)
containerv1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/47958636b0fa68d9c23bacd765b90954293c7551)
datalabelingv1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/ad487d5fd8455823ed044dd6567d1e1a85729755)
dfareportingv3.3[ [More details]](https://github.com/googleapis/google-api-python-client/commit/fc38ed0d8aabe80a003866059d59f03b67c9de9f)
dfareportingv3.4[ [More details]](https://github.com/googleapis/google-api-python-client/commit/fc38ed0d8aabe80a003866059d59f03b67c9de9f)
docsv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/c6dcde43ee5c4bf53fcbbdbc52a88b73b9c45e2d)
domainsv1alpha2[ [More details]](https://github.com/googleapis/google-api-python-client/commit/92b5958ee1e954019be6582e7ce80703ff91f17d)
domainsv1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/92b5958ee1e954019be6582e7ce80703ff91f17d)
doubleclickbidmanagerv1.1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/2cf24fd0a733a07b55ad481165e9635b4e7bf9a3)
drivev2[ [More details]](https://github.com/googleapis/google-api-python-client/commit/a060399fea6a34ed6982db0186345eac27eedadd)
drivev3[ [More details]](https://github.com/googleapis/google-api-python-client/commit/a060399fea6a34ed6982db0186345eac27eedadd)
fcmv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/348a8bc10b44abe8e994b1619bee5e2333074411)
firebasehostingv1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/15eb02bb44876ab6873539c206c064bd08e6684c)
fitnessv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/b40a9bb9c0f0c18c4839f58ecbe5f85c84053259)
gmailv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/6a77c586893584132d964293e1be34356d5fbfcb)
groupssettingsv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/bbbcfde0767f9dff176b9dce7432b4d7f2bc739e)
homegraphv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/a867202c70cd9e7ee711ae13e43b8c5ce3f4cdbf)
indexnan[ [More details]](https://github.com/googleapis/google-api-python-client/commit/a867202c70cd9e7ee711ae13e43b8c5ce3f4cdbf)
loggingv2[ [More details]](https://github.com/googleapis/google-api-python-client/commit/8fcbde03c7790ced3dbcba11e05bea7a8f451ac4)
peoplev1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/6e4c87a393b295e72ec11a5b1e752e2c139685df)
recommendationenginev1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/e6ace9e4dfbe429016788fd3a4a32de8f359a2d1)
recommenderv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/c340d3f0d43cb250159fda91a0f884c06aa19346)
recommenderv1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/c340d3f0d43cb250159fda91a0f884c06aa19346)
redisv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/f0d31fe127c3bcac9285457ff6510a6d9b4d7025)
redisv1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/f0d31fe127c3bcac9285457ff6510a6d9b4d7025)
scriptv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/d235c949a32d1ce099cc6f1f161dc4930949bd80)
servicedirectoryv1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/b8e06d2e15229e868b698cb4a296f3202f84bf24)
servicemanagementv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/eb37d585a103ca332e3af48a0f46c1408e805863)
smartdevicemanagementv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/67bfa0e50eb1a761222f3d424e662043b0a29171)
streetviewpublishv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/5825e78ab4c5b3a0bbfc85fa332e4962096fdb55)
tasksv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/dcd228af6573a3163da3cfaca9c0cb6cd679d282)
texttospeechv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/43220b5cd401440812e76821e6cbd5c3099659cd)
texttospeechv1beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/43220b5cd401440812e76821e6cbd5c3099659cd)
trafficdirectorv2[ [More details]](https://github.com/googleapis/google-api-python-client/commit/4141254d0c9f8627a35a5be19f23f673fc619164)
translatev3[ [More details]](https://github.com/googleapis/google-api-python-client/commit/b0bec6c2662ed00b6e80c5fd361fadf396f4e00c)
translatev3beta1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/b0bec6c2662ed00b6e80c5fd361fadf396f4e00c)
vaultv1[ [More details]](https://github.com/googleapis/google-api-python-client/commit/f946ac2b3cfa3f8566ceea85110b919a7d974352)
workflowsv1beta[ [More details]](https://github.com/googleapis/google-api-python-client/commit/a4ff4fcf07923786768354ab7f5cdef28ba3e29f)
diff --git a/docs/dyn/servicemanagement_v1.services.html b/docs/dyn/servicemanagement_v1.services.html
index 48226a2..73b777f 100644
--- a/docs/dyn/servicemanagement_v1.services.html
+++ b/docs/dyn/servicemanagement_v1.services.html
@@ -347,7 +347,7 @@
Returns:
An object of the form:
- { # `Service` is the root object of Google service configuration schema. It describes basic information about a service, such as the name and the title, and delegates other aspects to sub-sections. Each sub-section is either a proto message or a repeated proto message that configures a specific aspect, such as auth. See each proto message definition for details. Example: type: google.api.Service config_version: 3 name: calendar.googleapis.com title: Google Calendar API apis: - name: google.calendar.v3.Calendar 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
+ { # `Service` is the root object of Google service configuration schema. It describes basic information about a service, such as the name and the title, and delegates other aspects to sub-sections. Each sub-section is either a proto message or a repeated proto message that configures a specific aspect, such as auth. See each proto message definition for details. Example: type: google.api.Service name: calendar.googleapis.com title: Google Calendar API apis: - name: google.calendar.v3.Calendar 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
"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.
"methods": [ # The methods of this interface, in unspecified order.
@@ -448,7 +448,7 @@
},
],
},
- "configVersion": 42, # This field is obsolete. Its value must be set to `3`.
+ "configVersion": 42, # Deprecated. The service config compiler always sets this field to `3`.
"context": { # `Context` defines which contexts an API requests. Example: context: rules: - selector: "*" requested: - google.rpc.context.ProjectContext - google.rpc.context.OriginContext The above specifies that all methods in the API request `google.rpc.context.ProjectContext` and `google.rpc.context.OriginContext`. Available context types are defined in package `google.rpc.context`. This also provides mechanism to allowlist any protobuf message extension that can be sent in grpc metadata using “x-goog-ext--bin” and “x-goog-ext--jspb” format. For example, list any service specific protobuf types that can appear in grpc metadata as follows in your yaml file: Example: context: rules: - selector: "google.example.library.v1.LibraryService.CreateBook" allowed_request_extensions: - google.foo.v1.NewExtension allowed_response_extensions: - google.foo.v1.NewExtension You can also specify extension ID instead of fully qualified extension name here. # Context configuration.
"rules": [ # A list of RPC context rules that apply to individual API methods. **NOTE:** All service configuration rules follow "last one wins" order.
{ # A context rule provides information about the context for an individual API element.
@@ -505,7 +505,7 @@
"summary": "A String", # A short summary of what the service does. Can only be provided by plain text.
},
"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
+ { # `Endpoint` describes a network endpoint of a service that serves a set of APIs. It is commonly known as a service endpoint. A service may expose any number of service endpoints, and all service endpoints share the same service definition, such as quota limits and monitoring metrics. 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
"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",
],
@@ -623,7 +623,7 @@
],
"name": "A String", # The resource name of the metric descriptor.
"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"
- "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").
+ "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 might 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 might 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](https://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").
"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.
},
],
@@ -795,7 +795,7 @@
],
"usage": { # Configuration controlling usage of a service. # Configuration controlling usage of this service.
"producerNotificationChannel": "A String", # The full resource name of a channel used for sending notifications to the service producer. Google Service Management currently only supports [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification 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.
- "requirements": [ # Requirements that must be satisfied before a consumer project can use the service. Each requirement is of the form /; for example 'serviceusage.googleapis.com/billing-enabled'.
+ "requirements": [ # Requirements that must be satisfied before a consumer project can use the service. Each requirement is of the form /; for example 'serviceusage.googleapis.com/billing-enabled'. For Google APIs, a Terms of Service requirement must be included here. Google Cloud APIs must include "serviceusage.googleapis.com/tos/cloud". Other Google APIs should include "serviceusage.googleapis.com/tos/universal". Additional ToS can be included based on the business needs.
"A String",
],
"rules": [ # A list of usage rules that apply to individual API methods. **NOTE:** All service configuration rules follow "last one wins" order.