From 3365d9fba157f57a8351f346e750ee27656df322 Mon Sep 17 00:00:00 2001 From: Sebastian Thiel Date: Fri, 5 Jul 2019 17:05:15 +0800 Subject: [PATCH] Regen all remaining APIs with preproc - more changes than anticipated --- gen/accesscontextmanager1/src/lib.rs | 9 +- gen/adexchangebuyer2_v2_beta1/src/lib.rs | 11 +- gen/alertcenter1_beta1/src/lib.rs | 9 +- gen/analyticsreporting4/src/lib.rs | 52 ++-- gen/androiddeviceprovisioning1/src/lib.rs | 9 +- gen/bigquery2/src/lib.rs | 11 +- gen/bigquerydatatransfer1/src/lib.rs | 12 +- gen/bigtableadmin2/src/lib.rs | 197 +++++++------- gen/binaryauthorization1_beta1/src/lib.rs | 73 +++--- gen/classroom1/src/lib.rs | 189 +++++++------- gen/cloudasset1_beta1/src/lib.rs | 142 ++++++----- gen/cloudbilling1/src/lib.rs | 142 ++++++----- gen/cloudbuild1/src/lib.rs | 9 +- gen/clouddebugger2/src/lib.rs | 173 ++++++------- gen/cloudfunctions1/src/lib.rs | 145 ++++++----- gen/cloudiot1/src/lib.rs | 73 +++--- gen/cloudkms1/src/lib.rs | 146 ++++++----- gen/cloudkms1_beta1/src/lib.rs | 113 ++++---- gen/cloudprivatecatalog1_beta1/src/lib.rs | 8 +- .../src/lib.rs | 164 ++++++------ gen/cloudresourcemanager1_beta1/src/lib.rs | 151 +++++------ gen/cloudresourcemanager2/src/lib.rs | 142 ++++++----- gen/cloudscheduler1/src/lib.rs | 12 +- gen/cloudscheduler1_beta1/src/lib.rs | 12 +- gen/cloudshell1/src/lib.rs | 9 +- gen/cloudtasks2/src/lib.rs | 76 +++--- gen/cloudtasks2_beta2/src/lib.rs | 76 +++--- gen/cloudtasks2_beta3/src/lib.rs | 99 +++---- gen/cloudtrace1/src/lib.rs | 67 ++--- gen/cloudtrace2/src/lib.rs | 28 +- gen/commentanalyzer1_alpha1/src/lib.rs | 8 +- gen/composer1/src/lib.rs | 57 +++-- gen/container1/src/lib.rs | 9 +- gen/containeranalysis1_beta1/src/lib.rs | 186 +++++++------- gen/datafusion1_beta1/src/lib.rs | 174 +++++++------ gen/dataproc1/src/lib.rs | 87 ++++--- gen/datastore1/src/lib.rs | 40 +-- gen/dialogflow2/src/lib.rs | 42 +-- gen/dialogflow2_beta1/src/lib.rs | 74 +++--- gen/digitalassetlinks1/src/lib.rs | 190 +++++++------- gen/dlp2/src/lib.rs | 41 +-- gen/dlp2_beta1/src/lib.rs | 40 +-- gen/docs1/src/lib.rs | 38 ++- gen/driveactivity2/src/lib.rs | 27 +- gen/factchecktools1_alpha1/src/lib.rs | 9 +- gen/file1/src/lib.rs | 12 +- gen/file1_beta1/src/lib.rs | 12 +- gen/firebase1_beta1/src/lib.rs | 11 +- gen/firebasedynamiclinks1/src/lib.rs | 22 +- gen/firebasehosting1_beta1/src/lib.rs | 9 +- gen/firestore1/src/lib.rs | 43 ++-- gen/firestore1_beta1/src/lib.rs | 40 +-- gen/genomics1/src/lib.rs | 9 +- gen/healthcare1_beta1/src/lib.rs | 212 +++++++-------- gen/iam1/src/lib.rs | 151 +++++------ gen/iamcredentials1/src/lib.rs | 57 +++-- gen/iap1/src/lib.rs | 64 ++--- gen/iap1_beta1/src/lib.rs | 64 ++--- gen/jobs3/src/lib.rs | 9 +- gen/logging2/src/lib.rs | 16 +- gen/logging2_beta1/src/lib.rs | 16 +- gen/manufacturers1/src/lib.rs | 33 +-- gen/ml1/src/lib.rs | 241 +++++++++--------- gen/monitoring3/src/lib.rs | 15 +- gen/oslogin1/src/lib.rs | 9 +- gen/oslogin1_beta/src/lib.rs | 9 +- gen/partners2/src/lib.rs | 13 +- gen/people1/src/lib.rs | 9 +- gen/proximitybeacon1_beta1/src/lib.rs | 9 +- gen/pubsub1/src/lib.rs | 85 +++--- gen/pubsub1_beta2/src/lib.rs | 73 +++--- gen/redis1/src/lib.rs | 30 ++- gen/remotebuildexecution2/src/lib.rs | 10 +- gen/run1/src/lib.rs | 3 +- gen/runtimeconfig1/src/lib.rs | 9 +- gen/runtimeconfig1_beta1/src/lib.rs | 85 +++--- gen/safebrowsing4/src/lib.rs | 9 +- gen/securitycenter1/src/lib.rs | 190 +++++++------- gen/servicebroker1/src/lib.rs | 64 ++--- gen/sourcerepo1/src/lib.rs | 151 +++++------ gen/speech1/src/lib.rs | 1 + gen/speech1_beta1/src/lib.rs | 31 ++- gen/storagetransfer1/src/lib.rs | 45 ++-- gen/testing1/src/lib.rs | 12 +- gen/tpu1/src/lib.rs | 12 +- gen/tpu1_alpha1/src/lib.rs | 12 +- gen/vault1/src/lib.rs | 9 +- gen/videointelligence1/src/lib.rs | 9 +- gen/videointelligence1_beta1/src/lib.rs | 31 ++- gen/youtubereporting1/src/lib.rs | 9 +- 90 files changed, 2777 insertions(+), 2569 deletions(-) diff --git a/gen/accesscontextmanager1/src/lib.rs b/gen/accesscontextmanager1/src/lib.rs index 0ac0bd1483..be80bb6c8c 100644 --- a/gen/accesscontextmanager1/src/lib.rs +++ b/gen/accesscontextmanager1/src/lib.rs @@ -579,9 +579,11 @@ impl ResponseResult for ListAccessLevelsResponse {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -592,7 +594,6 @@ impl ResponseResult for ListAccessLevelsResponse {} /// /// * [delete operations](struct.OperationDeleteCall.html) (response) /// * [cancel operations](struct.OperationCancelCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/adexchangebuyer2_v2_beta1/src/lib.rs b/gen/adexchangebuyer2_v2_beta1/src/lib.rs index 4e48284ac3..00c335cef0 100644 --- a/gen/adexchangebuyer2_v2_beta1/src/lib.rs +++ b/gen/adexchangebuyer2_v2_beta1/src/lib.rs @@ -2278,9 +2278,11 @@ impl Part for ContactInformation {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -2295,7 +2297,6 @@ impl Part for ContactInformation {} /// * [creatives watch accounts](struct.AccountCreativeWatchCall.html) (response) /// * [filter sets delete bidders](struct.BidderFilterSetDeleteCall.html) (response) /// * [creatives stop watching accounts](struct.AccountCreativeStopWatchingCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -14035,6 +14036,7 @@ impl<'a, C, A> AccountCreativeListCall<'a, C, A> where C: BorrowMutSupported queries are: ///
    ///
  • accountId=account_id_string @@ -20819,6 +20821,7 @@ impl<'a, C, A> AccountCreativeDealAssociationListCall<'a, C, A> where C: BorrowM /// An optional query string to filter deal associations. If no filter is /// specified, all associations will be returned. /// Supported queries are: + /// ///
      ///
    • accountId=account_id_string ///
    • creativeId=creative_id_string diff --git a/gen/alertcenter1_beta1/src/lib.rs b/gen/alertcenter1_beta1/src/lib.rs index 0404cba047..b5dd3db6b9 100644 --- a/gen/alertcenter1_beta1/src/lib.rs +++ b/gen/alertcenter1_beta1/src/lib.rs @@ -498,9 +498,11 @@ impl ResponseResult for ListAlertFeedbackResponse {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -510,7 +512,6 @@ impl ResponseResult for ListAlertFeedbackResponse {} /// The list links the activity name, along with information about where it is used (one of *request* and *response*). /// /// * [delete alerts](struct.AlertDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/analyticsreporting4/src/lib.rs b/gen/analyticsreporting4/src/lib.rs index c18305b197..810b46b8f7 100644 --- a/gen/analyticsreporting4/src/lib.rs +++ b/gen/analyticsreporting4/src/lib.rs @@ -812,21 +812,22 @@ pub struct SegmentFilter { /// For example, to match all visits not from "New York", we can define the /// segment as follows: /// - /// "sessionSegment": { - /// "segmentFilters": [{ - /// "simpleSegment" :{ - /// "orFiltersForSegment": [{ - /// "segmentFilterClauses":[{ - /// "dimensionFilter": { - /// "dimensionName": "ga:city", - /// "expressions": ["New York"] - /// } - /// }] - /// }] - /// }, - /// "not": "True" + /// ````text + /// "sessionSegment": { + /// "segmentFilters": [{ + /// "simpleSegment" :{ + /// "orFiltersForSegment": [{ + /// "segmentFilterClauses":[{ + /// "dimensionFilter": { + /// "dimensionName": "ga:city", + /// "expressions": ["New York"] + /// } + /// }] /// }] /// }, + /// "not": "True" + /// }] + /// },```` pub not: Option, /// A Simple segment conditions consist of one or more dimension/metric /// conditions that can be combined @@ -1221,20 +1222,21 @@ impl Part for DateRangeValues {} /// Defines a cohort group. /// For example: /// -/// "cohortGroup": { -/// "cohorts": [{ -/// "name": "cohort 1", -/// "type": "FIRST_VISIT_DATE", -/// "dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" } -/// },{ -/// "name": "cohort 2" -/// "type": "FIRST_VISIT_DATE" -/// "dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" } -/// }] -/// } +/// ````text +/// "cohortGroup": { +/// "cohorts": [{ +/// "name": "cohort 1", +/// "type": "FIRST_VISIT_DATE", +/// "dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" } +/// },{ +/// "name": "cohort 2" +/// "type": "FIRST_VISIT_DATE" +/// "dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" } +/// }] +/// } +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct CohortGroup { /// The definition for the cohort. diff --git a/gen/androiddeviceprovisioning1/src/lib.rs b/gen/androiddeviceprovisioning1/src/lib.rs index f3d69268e3..f4b8b2810b 100644 --- a/gen/androiddeviceprovisioning1/src/lib.rs +++ b/gen/androiddeviceprovisioning1/src/lib.rs @@ -549,9 +549,11 @@ impl RequestValue for ClaimDeviceRequest {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -565,7 +567,6 @@ impl RequestValue for ClaimDeviceRequest {} /// * [configurations delete customers](struct.CustomerConfigurationDeleteCall.html) (response) /// * [devices remove configuration customers](struct.CustomerDeviceRemoveConfigurationCall.html) (response) /// * [devices unclaim partners](struct.PartnerDeviceUnclaimCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/bigquery2/src/lib.rs b/gen/bigquery2/src/lib.rs index 4d19d2e8d5..56edde29cd 100644 --- a/gen/bigquery2/src/lib.rs +++ b/gen/bigquery2/src/lib.rs @@ -1397,14 +1397,13 @@ impl Part for DatasetAccess {} /// INT64: {type_kind="INT64"} /// ARRAY: {type_kind="ARRAY", array_element_type="STRING"} /// STRUCT>: -/// {type_kind="STRUCT", -/// struct_type={fields=[ -/// {name="x", type={type_kind="STRING"}}, -/// {name="y", type={type_kind="ARRAY", array_element_type="DATE"}} -/// ]}} +/// {type_kind="STRUCT", +/// struct_type={fields=[ +/// {name="x", type={type_kind="STRING"}}, +/// {name="y", type={type_kind="ARRAY", array_element_type="DATE"}} +/// ]}} /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct StandardSqlDataType { /// The fields of this struct, in order, if type_kind = "STRUCT". diff --git a/gen/bigquerydatatransfer1/src/lib.rs b/gen/bigquerydatatransfer1/src/lib.rs index 92b42e7309..32cb2f63a5 100644 --- a/gen/bigquerydatatransfer1/src/lib.rs +++ b/gen/bigquerydatatransfer1/src/lib.rs @@ -563,7 +563,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -604,9 +605,11 @@ impl RequestValue for CheckValidCredsRequest {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -619,7 +622,6 @@ impl RequestValue for CheckValidCredsRequest {} /// * [locations transfer configs runs delete projects](struct.ProjectLocationTransferConfigRunDeleteCall.html) (response) /// * [locations transfer configs delete projects](struct.ProjectLocationTransferConfigDeleteCall.html) (response) /// * [transfer configs runs delete projects](struct.ProjectTransferConfigRunDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/bigtableadmin2/src/lib.rs b/gen/bigtableadmin2/src/lib.rs index a8d3609060..6a7afdde6a 100644 --- a/gen/bigtableadmin2/src/lib.rs +++ b/gen/bigtableadmin2/src/lib.rs @@ -653,7 +653,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -734,9 +735,11 @@ impl ResponseResult for GenerateConsistencyTokenResponse {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -752,7 +755,6 @@ impl ResponseResult for GenerateConsistencyTokenResponse {} /// * [cancel operations](struct.OperationCancelCall.html) (response) /// * [instances delete projects](struct.ProjectInstanceDeleteCall.html) (response) /// * [instances tables delete projects](struct.ProjectInstanceTableDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -776,8 +778,8 @@ impl Part for MultiClusterRoutingUseAny {} /// different programming environments, including REST APIs and RPC APIs. It is /// used by [gRPC](https://github.com/grpc). The error model is designed to be: /// -/// - Simple to use and understand for most users -/// - Flexible enough to meet unexpected needs +/// * Simple to use and understand for most users +/// * Flexible enough to meet unexpected needs /// /// # Overview /// @@ -807,26 +809,25 @@ impl Part for MultiClusterRoutingUseAny {} /// /// Example uses of this error model include: /// -/// - Partial errors. If a service needs to return partial errors to the client, -/// it may embed the `Status` in the normal response to indicate the partial -/// errors. +/// * Partial errors. If a service needs to return partial errors to the client, +/// it may embed the `Status` in the normal response to indicate the partial +/// errors. /// -/// - Workflow errors. A typical workflow has multiple steps. Each step may -/// have a `Status` message for error reporting. +/// * Workflow errors. A typical workflow has multiple steps. Each step may +/// have a `Status` message for error reporting. /// -/// - Batch operations. If a client uses batch request and batch response, the -/// `Status` message should be used directly inside batch response, one for -/// each error sub-response. +/// * Batch operations. If a client uses batch request and batch response, the +/// `Status` message should be used directly inside batch response, one for +/// each error sub-response. /// -/// - Asynchronous operations. If an API call embeds asynchronous operation -/// results in its response, the status of those operations should be -/// represented directly using the `Status` message. +/// * Asynchronous operations. If an API call embeds asynchronous operation +/// results in its response, the status of those operations should be +/// represented directly using the `Status` message. /// -/// - Logging. If some API errors are stored in logs, the message `Status` could -/// be used directly after any stripping needed for security/privacy reasons. +/// * Logging. If some API errors are stored in logs, the message `Status` could +/// be used directly after any stripping needed for security/privacy reasons. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Status { /// A developer-facing error message, which should be in English. Any @@ -846,7 +847,6 @@ impl Part for Status {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -854,37 +854,40 @@ impl Part for Status {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -898,7 +901,6 @@ impl Part for Status {} /// * [instances get iam policy projects](struct.ProjectInstanceGetIamPolicyCall.html) (response) /// * [instances set iam policy projects](struct.ProjectInstanceSetIamPolicyCall.html) (response) /// * [instances tables get iam policy projects](struct.ProjectInstanceTableGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. @@ -1062,25 +1064,26 @@ impl Part for Intersection {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -1136,12 +1139,13 @@ impl RequestValue for TestIamPermissionsRequest {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -1278,14 +1282,14 @@ pub struct CreateTableRequest { /// Example: /// /// * Row keys := `["a", "apple", "custom", "customer_1", "customer_2",` - /// `"other", "zz"]` + /// `"other", "zz"]` /// * initial_split_keys := `["apple", "customer_1", "customer_2", "other"]` /// * Key assignment: - /// - Tablet 1 `[, apple) => {"a"}.` - /// - Tablet 2 `[apple, customer_1) => {"apple", "custom"}.` - /// - Tablet 3 `[customer_1, customer_2) => {"customer_1"}.` - /// - Tablet 4 `[customer_2, other) => {"customer_2"}.` - /// - Tablet 5 `[other, ) => {"other", "zz"}.` + /// * Tablet 1 `[, apple) => {"a"}.` + /// * Tablet 2 `[apple, customer_1) => {"apple", "custom"}.` + /// * Tablet 3 `[customer_1, customer_2) => {"customer_1"}.` + /// * Tablet 4 `[customer_2, other) => {"customer_2"}.` + /// * Tablet 5 `[other, ) => {"other", "zz"}.` #[serde(rename="initialSplits")] pub initial_splits: Option>, /// The name by which the new table should be referred to within the parent @@ -1427,48 +1431,49 @@ impl Part for ClusterState {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// The configuration for logging of each type of permission. diff --git a/gen/binaryauthorization1_beta1/src/lib.rs b/gen/binaryauthorization1_beta1/src/lib.rs index c5fe821633..bbebeb78a3 100644 --- a/gen/binaryauthorization1_beta1/src/lib.rs +++ b/gen/binaryauthorization1_beta1/src/lib.rs @@ -473,12 +473,13 @@ impl Part for AdmissionRule {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -549,7 +550,6 @@ impl Part for Binding {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -557,37 +557,40 @@ impl Part for Binding {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -601,7 +604,6 @@ impl Part for Binding {} /// * [attestors set iam policy projects](struct.ProjectAttestorSetIamPolicyCall.html) (response) /// * [policy get iam policy projects](struct.ProjectPolicyGetIamPolicyCall.html) (response) /// * [attestors get iam policy projects](struct.ProjectAttestorGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct IamPolicy { /// Associates a list of `members` to a `role`. @@ -835,9 +837,11 @@ impl Part for AttestorPublicKey {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -847,7 +851,6 @@ impl Part for AttestorPublicKey {} /// The list links the activity name, along with information about where it is used (one of *request* and *response*). /// /// * [attestors delete projects](struct.ProjectAttestorDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/classroom1/src/lib.rs b/gen/classroom1/src/lib.rs index f0200fea75..e3cfe8a2ac 100644 --- a/gen/classroom1/src/lib.rs +++ b/gen/classroom1/src/lib.rs @@ -723,9 +723,11 @@ impl RequestValue for ReturnStudentSubmissionRequest {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -748,7 +750,6 @@ impl RequestValue for ReturnStudentSubmissionRequest {} /// * [delete registrations](struct.RegistrationDeleteCall.html) (response) /// * [announcements delete courses](struct.CourseAnnouncementDeleteCall.html) (response) /// * [accept invitations](struct.InvitationAcceptCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -2526,10 +2527,10 @@ impl<'a, C, A> CourseMethods<'a, C, A> { /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to modify the - /// requested course or for access errors. + /// requested course or for access errors. /// * `NOT_FOUND` if no course exists with the requested ID. /// * `FAILED_PRECONDITION` for the following request errors: - /// * CourseNotModifiable + /// * CourseNotModifiable /// /// # Arguments /// @@ -2988,12 +2989,12 @@ impl<'a, C, A> CourseMethods<'a, C, A> { /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to access the - /// requested course, create course work in the requested course, share a - /// Drive attachment, or for access errors. + /// requested course, create course work in the requested course, share a + /// Drive attachment, or for access errors. /// * `INVALID_ARGUMENT` if the request is malformed. /// * `NOT_FOUND` if the requested course does not exist. /// * `FAILED_PRECONDITION` for the following request error: - /// * AttachmentNotVisible + /// * AttachmentNotVisible /// /// # Arguments /// @@ -3044,12 +3045,12 @@ impl<'a, C, A> CourseMethods<'a, C, A> { /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to access the - /// requested course, create announcements in the requested course, share a - /// Drive attachment, or for access errors. + /// requested course, create announcements in the requested course, share a + /// Drive attachment, or for access errors. /// * `INVALID_ARGUMENT` if the request is malformed. /// * `NOT_FOUND` if the requested course does not exist. /// * `FAILED_PRECONDITION` for the following request error: - /// * AttachmentNotVisible + /// * AttachmentNotVisible /// /// # Arguments /// @@ -3170,15 +3171,15 @@ impl<'a, C, A> CourseMethods<'a, C, A> { /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to create - /// students in this course or for access errors. + /// students in this course or for access errors. /// * `NOT_FOUND` if the requested course ID does not exist. /// * `FAILED_PRECONDITION` if the requested user's account is disabled, - /// for the following request errors: - /// * CourseMemberLimitReached - /// * CourseNotModifiable - /// * UserGroupsMembershipLimitReached + /// for the following request errors: + /// * CourseMemberLimitReached + /// * CourseNotModifiable + /// * UserGroupsMembershipLimitReached /// * `ALREADY_EXISTS` if the user is already a student or teacher in the - /// course. + /// course. /// /// # Arguments /// @@ -3307,13 +3308,13 @@ impl<'a, C, A> CourseMethods<'a, C, A> { /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to create - /// courses or for access errors. + /// courses or for access errors. /// * `NOT_FOUND` if the primary teacher is not a valid user. /// * `FAILED_PRECONDITION` if the course owner's account is disabled or for - /// the following request errors: - /// * UserGroupsMembershipLimitReached + /// the following request errors: + /// * UserGroupsMembershipLimitReached /// * `ALREADY_EXISTS` if an alias was specified in the `id` and - /// already exists. + /// already exists. /// /// # Arguments /// @@ -3459,12 +3460,12 @@ impl<'a, C, A> CourseMethods<'a, C, A> { /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to modify the - /// requested course or for access errors. + /// requested course or for access errors. /// * `NOT_FOUND` if no course exists with the requested ID. /// * `INVALID_ARGUMENT` if invalid fields are specified in the update mask or - /// if no update mask is supplied. + /// if no update mask is supplied. /// * `FAILED_PRECONDITION` for the following request errors: - /// * CourseNotModifiable + /// * CourseNotModifiable /// /// # Arguments /// @@ -3557,16 +3558,16 @@ impl<'a, C, A> CourseMethods<'a, C, A> { /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to create - /// teachers in this course or for access errors. + /// teachers in this course or for access errors. /// * `NOT_FOUND` if the requested course ID does not exist. /// * `FAILED_PRECONDITION` if the requested user's account is disabled, - /// for the following request errors: - /// * CourseMemberLimitReached - /// * CourseNotModifiable - /// * CourseTeacherLimitReached - /// * UserGroupsMembershipLimitReached + /// for the following request errors: + /// * CourseMemberLimitReached + /// * CourseNotModifiable + /// * CourseTeacherLimitReached + /// * UserGroupsMembershipLimitReached /// * `ALREADY_EXISTS` if the user is already a teacher or student in the - /// course. + /// course. /// /// # Arguments /// @@ -4117,20 +4118,20 @@ impl<'a, C, A> RegistrationMethods<'a, C, A> { /// This method may return the following error codes: /// /// * `PERMISSION_DENIED` if: - /// * the authenticated user does not have permission to receive - /// notifications from the requested field; or - /// * the credential provided does not include the appropriate scope for - /// the requested feed. - /// * another access error is encountered. + /// * the authenticated user does not have permission to receive + /// notifications from the requested field; or + /// * the credential provided does not include the appropriate scope for + /// the requested feed. + /// * another access error is encountered. /// * `INVALID_ARGUMENT` if: - /// * no `cloudPubsubTopic` is specified, or the specified - /// `cloudPubsubTopic` is not valid; or - /// * no `feed` is specified, or the specified `feed` is not valid. + /// * no `cloudPubsubTopic` is specified, or the specified + /// `cloudPubsubTopic` is not valid; or + /// * no `feed` is specified, or the specified `feed` is not valid. /// * `NOT_FOUND` if: - /// * the specified `feed` cannot be located, or the requesting user does - /// not have permission to determine whether or not it exists; or - /// * the specified `cloudPubsubTopic` cannot be located, or Classroom has - /// not been granted permission to publish to it. + /// * the specified `feed` cannot be located, or the requesting user does + /// not have permission to determine whether or not it exists; or + /// * the specified `cloudPubsubTopic` cannot be located, or Classroom has + /// not been granted permission to publish to it. /// /// # Arguments /// @@ -4312,12 +4313,12 @@ impl<'a, C, A> InvitationMethods<'a, C, A> { /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to accept the - /// requested invitation or for access errors. + /// requested invitation or for access errors. /// * `FAILED_PRECONDITION` for the following request errors: - /// * CourseMemberLimitReached - /// * CourseNotModifiable - /// * CourseTeacherLimitReached - /// * UserGroupsMembershipLimitReached + /// * CourseMemberLimitReached + /// * CourseNotModifiable + /// * CourseTeacherLimitReached + /// * UserGroupsMembershipLimitReached /// * `NOT_FOUND` if no invitation exists with the requested ID. /// /// # Arguments @@ -5840,10 +5841,10 @@ impl<'a, C, A> CourseGetCall<'a, C, A> where C: BorrowMut, A: oau /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to modify the -/// requested course or for access errors. +/// requested course or for access errors. /// * `NOT_FOUND` if no course exists with the requested ID. /// * `FAILED_PRECONDITION` for the following request errors: -/// * CourseNotModifiable +/// * CourseNotModifiable /// /// A builder for the *update* method supported by a *course* resource. /// It is not used directly, but through a `CourseMethods` instance. @@ -9730,12 +9731,12 @@ impl<'a, C, A> CourseCourseWorkGetCall<'a, C, A> where C: BorrowMut CourseListCall<'a, C, A> where C: BorrowMut, A: oa /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to access the -/// requested course, create announcements in the requested course, share a -/// Drive attachment, or for access errors. +/// requested course, create announcements in the requested course, share a +/// Drive attachment, or for access errors. /// * `INVALID_ARGUMENT` if the request is malformed. /// * `NOT_FOUND` if the requested course does not exist. /// * `FAILED_PRECONDITION` for the following request error: -/// * AttachmentNotVisible +/// * AttachmentNotVisible /// /// A builder for the *announcements.create* method supported by a *course* resource. /// It is not used directly, but through a `CourseMethods` instance. @@ -11533,15 +11534,15 @@ impl<'a, C, A> CourseAliaseCreateCall<'a, C, A> where C: BorrowMut CourseCourseWorkDeleteCall<'a, C, A> where C: BorrowMut CourseTopicDeleteCall<'a, C, A> where C: BorrowMut /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to modify the -/// requested course or for access errors. +/// requested course or for access errors. /// * `NOT_FOUND` if no course exists with the requested ID. /// * `INVALID_ARGUMENT` if invalid fields are specified in the update mask or -/// if no update mask is supplied. +/// if no update mask is supplied. /// * `FAILED_PRECONDITION` for the following request errors: -/// * CourseNotModifiable +/// * CourseNotModifiable /// /// A builder for the *patch* method supported by a *course* resource. /// It is not used directly, but through a `CourseMethods` instance. @@ -14932,16 +14933,16 @@ impl<'a, C, A> CourseTeacherDeleteCall<'a, C, A> where C: BorrowMut UserProfileGuardianInvitationListCall<'a, C, A> where C: BorrowMu /// This method may return the following error codes: /// /// * `PERMISSION_DENIED` if: -/// * the authenticated user does not have permission to receive -/// notifications from the requested field; or -/// * the credential provided does not include the appropriate scope for -/// the requested feed. -/// * another access error is encountered. +/// * the authenticated user does not have permission to receive +/// notifications from the requested field; or +/// * the credential provided does not include the appropriate scope for +/// the requested feed. +/// * another access error is encountered. /// * `INVALID_ARGUMENT` if: -/// * no `cloudPubsubTopic` is specified, or the specified -/// `cloudPubsubTopic` is not valid; or -/// * no `feed` is specified, or the specified `feed` is not valid. +/// * no `cloudPubsubTopic` is specified, or the specified +/// `cloudPubsubTopic` is not valid; or +/// * no `feed` is specified, or the specified `feed` is not valid. /// * `NOT_FOUND` if: -/// * the specified `feed` cannot be located, or the requesting user does -/// not have permission to determine whether or not it exists; or -/// * the specified `cloudPubsubTopic` cannot be located, or Classroom has -/// not been granted permission to publish to it. +/// * the specified `feed` cannot be located, or the requesting user does +/// not have permission to determine whether or not it exists; or +/// * the specified `cloudPubsubTopic` cannot be located, or Classroom has +/// not been granted permission to publish to it. /// /// A builder for the *create* method supported by a *registration* resource. /// It is not used directly, but through a `RegistrationMethods` instance. @@ -20222,12 +20223,12 @@ impl<'a, C, A> InvitationGetCall<'a, C, A> where C: BorrowMut, A: /// This method returns the following error codes: /// /// * `PERMISSION_DENIED` if the requesting user is not permitted to accept the -/// requested invitation or for access errors. +/// requested invitation or for access errors. /// * `FAILED_PRECONDITION` for the following request errors: -/// * CourseMemberLimitReached -/// * CourseNotModifiable -/// * CourseTeacherLimitReached -/// * UserGroupsMembershipLimitReached +/// * CourseMemberLimitReached +/// * CourseNotModifiable +/// * CourseTeacherLimitReached +/// * UserGroupsMembershipLimitReached /// * `NOT_FOUND` if no invitation exists with the requested ID. /// /// A builder for the *accept* method supported by a *invitation* resource. diff --git a/gen/cloudasset1_beta1/src/lib.rs b/gen/cloudasset1_beta1/src/lib.rs index 03d553d26d..6de39bd6b1 100644 --- a/gen/cloudasset1_beta1/src/lib.rs +++ b/gen/cloudasset1_beta1/src/lib.rs @@ -412,25 +412,26 @@ impl Part for Status {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -535,12 +536,13 @@ impl RequestValue for ExportAssetsRequest {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -657,48 +659,49 @@ impl ResponseResult for BatchGetAssetsHistoryResponse {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// The configuration for logging of each type of permission. @@ -775,7 +778,6 @@ impl Part for TimeWindow {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -783,43 +785,45 @@ impl Part for TimeWindow {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. diff --git a/gen/cloudbilling1/src/lib.rs b/gen/cloudbilling1/src/lib.rs index 825c420620..66ea75c3b4 100644 --- a/gen/cloudbilling1/src/lib.rs +++ b/gen/cloudbilling1/src/lib.rs @@ -571,25 +571,26 @@ impl ResponseResult for ListServicesResponse {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -700,7 +701,6 @@ impl Part for AggregationInfo {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -708,37 +708,40 @@ impl Part for AggregationInfo {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -750,7 +753,6 @@ impl Part for AggregationInfo {} /// /// * [set iam policy billing accounts](struct.BillingAccountSetIamPolicyCall.html) (response) /// * [get iam policy billing accounts](struct.BillingAccountGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. @@ -1033,48 +1035,49 @@ impl ResponseResult for ProjectBillingInfo {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// The configuration for logging of each type of permission. @@ -1091,12 +1094,13 @@ impl Part for AuditConfig {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which diff --git a/gen/cloudbuild1/src/lib.rs b/gen/cloudbuild1/src/lib.rs index 2898f98202..066aea578e 100644 --- a/gen/cloudbuild1/src/lib.rs +++ b/gen/cloudbuild1/src/lib.rs @@ -674,9 +674,11 @@ impl ResponseResult for Build {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -687,7 +689,6 @@ impl ResponseResult for Build {} /// /// * [triggers delete projects](struct.ProjectTriggerDeleteCall.html) (response) /// * [cancel operations](struct.OperationCancelCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/clouddebugger2/src/lib.rs b/gen/clouddebugger2/src/lib.rs index 4cf354e496..1cbc1dd9a0 100644 --- a/gen/clouddebugger2/src/lib.rs +++ b/gen/clouddebugger2/src/lib.rs @@ -621,9 +621,11 @@ impl Part for RepoId {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -633,7 +635,6 @@ impl Part for RepoId {} /// The list links the activity name, along with information about where it is used (one of *request* and *response*). /// /// * [debuggees breakpoints delete debugger](struct.DebuggerDebuggeeBreakpointDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -824,9 +825,8 @@ pub struct FormatMessage { /// /// Examples: /// - /// * `Failed to load '$0' which helps debug $1 the first time it - /// is loaded. Again, $0 is very important.` - /// * `Please pay $$10 to use $0 instead of $1.` + /// * `Failed to load '$0' which helps debug $1 the first time it is loaded. Again, $0 is very important.` + /// * `Please pay $$10 to use $0 instead of $1.` pub format: Option, } @@ -978,84 +978,84 @@ impl RequestValue for Breakpoint {} /// Represents a variable or an argument possibly of a compound object type. /// Note how the following variables are represented: /// -/// 1) A simple variable: +/// 1. A simple variable: +/// +/// int x = 5 +/// +/// { name: "x", value: "5", type: "int" } // Captured variable /// -/// int x = 5 +/// 1. A compound object: +/// +/// struct T { +/// int m1; +/// int m2; +/// }; +/// T x = { 3, 7 }; +/// +/// { // Captured variable +/// name: "x", +/// type: "T", +/// members { name: "m1", value: "3", type: "int" }, +/// members { name: "m2", value: "7", type: "int" } +/// } /// -/// { name: "x", value: "5", type: "int" } // Captured variable +/// 1. A pointer where the pointee was captured: +/// +/// T x = { 3, 7 }; +/// T* p = &x; +/// +/// { // Captured variable +/// name: "p", +/// type: "T*", +/// value: "0x00500500", +/// members { name: "m1", value: "3", type: "int" }, +/// members { name: "m2", value: "7", type: "int" } +/// } /// -/// 2) A compound object: -/// -/// struct T { -/// int m1; -/// int m2; -/// }; -/// T x = { 3, 7 }; -/// -/// { // Captured variable -/// name: "x", -/// type: "T", -/// members { name: "m1", value: "3", type: "int" }, -/// members { name: "m2", value: "7", type: "int" } -/// } -/// -/// 3) A pointer where the pointee was captured: -/// -/// T x = { 3, 7 }; -/// T* p = &x; -/// -/// { // Captured variable -/// name: "p", -/// type: "T*", -/// value: "0x00500500", -/// members { name: "m1", value: "3", type: "int" }, -/// members { name: "m2", value: "7", type: "int" } -/// } -/// -/// 4) A pointer where the pointee was not captured: -/// -/// T* p = new T; -/// -/// { // Captured variable -/// name: "p", -/// type: "T*", -/// value: "0x00400400" -/// status { is_error: true, description { format: "unavailable" } } -/// } +/// 1. A pointer where the pointee was not captured: +/// +/// T* p = new T; +/// +/// { // Captured variable +/// name: "p", +/// type: "T*", +/// value: "0x00400400" +/// status { is_error: true, description { format: "unavailable" } } +/// } /// /// The status should describe the reason for the missing value, /// such as ``, ``, ``. /// /// Note that a null pointer should not have members. /// -/// 5) An unnamed value: +/// 5. An unnamed value: +/// +/// int* p = new int(7); +/// +/// { // Captured variable +/// name: "p", +/// value: "0x00500500", +/// type: "int*", +/// members { value: "7", type: "int" } } /// -/// int* p = new int(7); -/// -/// { // Captured variable -/// name: "p", -/// value: "0x00500500", -/// type: "int*", -/// members { value: "7", type: "int" } } -/// -/// 6) An unnamed pointer where the pointee was not captured: -/// -/// int* p = new int(7); -/// int** pp = &p; -/// -/// { // Captured variable -/// name: "pp", -/// value: "0x00500500", -/// type: "int**", -/// members { -/// value: "0x00400400", -/// type: "int*" -/// status { -/// is_error: true, -/// description: { format: "unavailable" } } -/// } -/// } -/// } +/// 5. An unnamed pointer where the pointee was not captured: +/// +/// int* p = new int(7); +/// int** pp = &p; +/// +/// { // Captured variable +/// name: "pp", +/// value: "0x00500500", +/// type: "int**", +/// members { +/// value: "0x00400400", +/// type: "int*" +/// status { +/// is_error: true, +/// description: { format: "unavailable" } } +/// } +/// } +/// } /// /// To optimize computation, memory and network traffic, variables that /// repeat in the output multiple times can be stored once in a shared @@ -1066,18 +1066,20 @@ impl RequestValue for Breakpoint {} /// /// When using the shared variable table, the following variables: /// -/// T x = { 3, 7 }; -/// T* p = &x; -/// T& r = x; +/// ````text +/// T x = { 3, 7 }; +/// T* p = &x; +/// T& r = x; /// -/// { name: "x", var_table_index: 3, type: "T" } // Captured variables -/// { name: "p", value "0x00500500", type="T*", var_table_index: 3 } -/// { name: "r", type="T&", var_table_index: 3 } +/// { name: "x", var_table_index: 3, type: "T" } // Captured variables +/// { name: "p", value "0x00500500", type="T*", var_table_index: 3 } +/// { name: "r", type="T&", var_table_index: 3 } /// -/// { // Shared variable table entry #3: -/// members { name: "m1", value: "3", type: "int" }, -/// members { name: "m2", value: "7", type: "int" } -/// } +/// { // Shared variable table entry #3: +/// members { name: "m1", value: "3", type: "int" }, +/// members { name: "m2", value: "7", type: "int" } +/// } +/// ```` /// /// Note that the pointer address is stored with the referencing variable /// and not with the referenced variable. This allows the referenced variable @@ -1086,7 +1088,6 @@ impl RequestValue for Breakpoint {} /// The type field is optional. The debugger agent may or may not support it. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Variable { /// Status associated with the variable. This field will usually stay diff --git a/gen/cloudfunctions1/src/lib.rs b/gen/cloudfunctions1/src/lib.rs index 3ed59c7c3e..f64d1e898b 100644 --- a/gen/cloudfunctions1/src/lib.rs +++ b/gen/cloudfunctions1/src/lib.rs @@ -513,12 +513,13 @@ impl RequestValue for SetIamPolicyRequest {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -545,25 +546,26 @@ impl Part for Expr {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -633,7 +635,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -652,7 +655,6 @@ impl Part for Location {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -660,37 +662,40 @@ impl Part for Location {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -702,7 +707,6 @@ impl Part for Location {} /// /// * [locations functions set iam policy projects](struct.ProjectLocationFunctionSetIamPolicyCall.html) (response) /// * [locations functions get iam policy projects](struct.ProjectLocationFunctionGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. @@ -1059,48 +1063,49 @@ impl RequestValue for GenerateUploadUrlRequest {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// The configuration for logging of each type of permission. diff --git a/gen/cloudiot1/src/lib.rs b/gen/cloudiot1/src/lib.rs index 0ae3fe72d0..274d29f3a3 100644 --- a/gen/cloudiot1/src/lib.rs +++ b/gen/cloudiot1/src/lib.rs @@ -495,7 +495,6 @@ impl ResponseResult for DeviceConfig {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -503,37 +502,40 @@ impl ResponseResult for DeviceConfig {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -547,7 +549,6 @@ impl ResponseResult for DeviceConfig {} /// * [locations registries groups set iam policy projects](struct.ProjectLocationRegistryGroupSetIamPolicyCall.html) (response) /// * [locations registries set iam policy projects](struct.ProjectLocationRegistrySetIamPolicyCall.html) (response) /// * [locations registries groups get iam policy projects](struct.ProjectLocationRegistryGroupGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Associates a list of `members` to a `role`. @@ -753,9 +754,11 @@ impl Part for DeviceCredential {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -766,7 +769,6 @@ impl Part for DeviceCredential {} /// /// * [locations registries devices delete projects](struct.ProjectLocationRegistryDeviceDeleteCall.html) (response) /// * [locations registries delete projects](struct.ProjectLocationRegistryDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -1010,12 +1012,13 @@ impl Part for RegistryCredential {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which diff --git a/gen/cloudkms1/src/lib.rs b/gen/cloudkms1/src/lib.rs index b7f75dc9c9..3fe73e9100 100644 --- a/gen/cloudkms1/src/lib.rs +++ b/gen/cloudkms1/src/lib.rs @@ -709,7 +709,6 @@ impl ResponseResult for ImportJob {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -717,37 +716,40 @@ impl ResponseResult for ImportJob {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -763,7 +765,6 @@ impl ResponseResult for ImportJob {} /// * [locations key rings crypto keys set iam policy projects](struct.ProjectLocationKeyRingCryptoKeySetIamPolicyCall.html) (response) /// * [locations key rings set iam policy projects](struct.ProjectLocationKeyRingSetIamPolicyCall.html) (response) /// * [locations key rings crypto keys get iam policy projects](struct.ProjectLocationKeyRingCryptoKeyGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. @@ -1050,25 +1051,26 @@ impl RequestValue for UpdateCryptoKeyPrimaryVersionRequest {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -1188,12 +1190,13 @@ impl ResponseResult for DecryptResponse {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -1243,6 +1246,7 @@ pub struct ImportCryptoKeyVersionRequest { /// RSA_OAEP_4096_SHA1_AES_256. /// /// This field contains the concatenation of two wrapped keys: + /// ///
        ///
      1. An ephemeral AES-256 wrapping key wrapped with the /// public_key using RSAES-OAEP with SHA-1, @@ -1388,48 +1392,49 @@ impl ResponseResult for PublicKey {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// The configuration for logging of each type of permission. @@ -1498,7 +1503,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] diff --git a/gen/cloudkms1_beta1/src/lib.rs b/gen/cloudkms1_beta1/src/lib.rs index 122359e6b9..ed1bf2ba09 100644 --- a/gen/cloudkms1_beta1/src/lib.rs +++ b/gen/cloudkms1_beta1/src/lib.rs @@ -403,25 +403,26 @@ impl ResponseResult for ListCryptoKeysResponse {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -674,7 +675,8 @@ impl ResponseResult for ListLocationsResponse {} pub struct Location { /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -693,7 +695,6 @@ impl ResponseResult for Location {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `Binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -701,23 +702,25 @@ impl ResponseResult for Location {} /// /// **Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com", -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com", /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam). @@ -731,7 +734,6 @@ impl ResponseResult for Location {} /// * [locations key rings get iam policy projects](struct.ProjectLocationKeyRingGetIamPolicyCall.html) (response) /// * [locations key rings crypto keys set iam policy projects](struct.ProjectLocationKeyRingCryptoKeySetIamPolicyCall.html) (response) /// * [locations key rings set iam policy projects](struct.ProjectLocationKeyRingSetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. @@ -1064,48 +1066,49 @@ impl RequestValue for UpdateCryptoKeyPrimaryVersionRequest {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// no description provided diff --git a/gen/cloudprivatecatalog1_beta1/src/lib.rs b/gen/cloudprivatecatalog1_beta1/src/lib.rs index ac10e960e9..30cd3084e8 100644 --- a/gen/cloudprivatecatalog1_beta1/src/lib.rs +++ b/gen/cloudprivatecatalog1_beta1/src/lib.rs @@ -429,7 +429,7 @@ pub struct GoogleCloudPrivatecatalogV1beta1Product { /// When the type is `google.deploymentmanager.Template`, the schema is as /// follows: /// - /// ``` + /// ````text /// "$schema": http://json-schema.org/draft-04/schema# /// type: object /// properties: @@ -475,12 +475,12 @@ pub struct GoogleCloudPrivatecatalogV1beta1Product { /// - description /// additionalProperties: false /// - /// ``` + /// ```` /// /// When the asset type is `google.cloudprivatecatalog.ListingOnly`, the schema /// is as follows: /// - /// ``` + /// ````text /// "$schema": http://json-schema.org/draft-04/schema# /// type: object /// properties: @@ -530,7 +530,7 @@ pub struct GoogleCloudPrivatecatalogV1beta1Product { /// - description /// - signup_url /// additionalProperties: false - /// ``` + /// ```` #[serde(rename="displayMetadata")] pub display_metadata: Option>, /// Output only. The time when the product was created. diff --git a/gen/cloudprivatecatalogproducer1_beta1/src/lib.rs b/gen/cloudprivatecatalogproducer1_beta1/src/lib.rs index fc8b2c7b70..183d4555fb 100644 --- a/gen/cloudprivatecatalogproducer1_beta1/src/lib.rs +++ b/gen/cloudprivatecatalogproducer1_beta1/src/lib.rs @@ -478,7 +478,6 @@ impl RequestValue for GoogleCloudPrivatecatalogproducerV1beta1UndeleteCatalogReq /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -486,37 +485,40 @@ impl RequestValue for GoogleCloudPrivatecatalogproducerV1beta1UndeleteCatalogReq /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -528,7 +530,6 @@ impl RequestValue for GoogleCloudPrivatecatalogproducerV1beta1UndeleteCatalogReq /// /// * [get iam policy catalogs](struct.CatalogGetIamPolicyCall.html) (response) /// * [set iam policy catalogs](struct.CatalogSetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleIamV1Policy { /// Specifies cloud audit logging configuration for this policy. @@ -654,7 +655,7 @@ pub struct GoogleCloudPrivatecatalogproducerV1beta1Version { /// The user-supplied asset payload. The maximum size of the payload is 2MB. /// The JSON schema of the payload is defined as: /// - /// ``` + /// ````text /// type: object /// properties: /// mainTemplate: @@ -675,7 +676,7 @@ pub struct GoogleCloudPrivatecatalogproducerV1beta1Version { /// type: string /// content: /// type: string - /// ``` + /// ```` #[serde(rename="originalAsset")] pub original_asset: Option>, /// Output only. The asset which has been validated and is ready to be @@ -783,7 +784,6 @@ impl ResponseResult for GoogleIamV1TestIamPermissionsResponse {} /// /// * [associations create catalogs](struct.CatalogAssociationCreateCall.html) (response) /// * [associations get catalogs](struct.CatalogAssociationGetCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleCloudPrivatecatalogproducerV1beta1Association { /// Required. The user-supplied fully qualified name of the `Resource` @@ -835,9 +835,11 @@ impl ResponseResult for GoogleCloudPrivatecatalogproducerV1beta1ListProductsResp /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -852,7 +854,6 @@ impl ResponseResult for GoogleCloudPrivatecatalogproducerV1beta1ListProductsResp /// * [associations delete catalogs](struct.CatalogAssociationDeleteCall.html) (response) /// * [delete operations](struct.OperationDeleteCall.html) (response) /// * [products delete catalogs](struct.CatalogProductDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleProtobufEmpty { _never_set: Option } @@ -981,7 +982,7 @@ pub struct GoogleCloudPrivatecatalogproducerV1beta1Product { /// When the type is `google.deploymentmanager.Template`, the schema is as /// follows: /// - /// ``` + /// ````text /// "$schema": http://json-schema.org/draft-04/schema# /// type: object /// properties: @@ -1027,12 +1028,12 @@ pub struct GoogleCloudPrivatecatalogproducerV1beta1Product { /// - description /// additionalProperties: false /// - /// ``` + /// ```` /// /// When the asset type is `google.cloudprivatecatalog.ListingOnly`, the schema /// is as follows: /// - /// ``` + /// ````text /// "$schema": http://json-schema.org/draft-04/schema# /// type: object /// properties: @@ -1082,7 +1083,7 @@ pub struct GoogleCloudPrivatecatalogproducerV1beta1Product { /// - description /// - signup_url /// additionalProperties: false - /// ``` + /// ```` #[serde(rename="displayMetadata")] pub display_metadata: Option>, /// Output only. The time when the product was created. @@ -1096,12 +1097,13 @@ impl ResponseResult for GoogleCloudPrivatecatalogproducerV1beta1Product {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleTypeExpr { /// An optional description of the expression. This is a longer text which @@ -1246,48 +1248,49 @@ impl Part for GoogleRpcStatus {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleIamV1AuditConfig { /// The configuration for logging of each type of permission. @@ -1305,25 +1308,26 @@ impl Part for GoogleIamV1AuditConfig {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleIamV1AuditLogConfig { /// Specifies the identities that do not cause logging for this type of diff --git a/gen/cloudresourcemanager1_beta1/src/lib.rs b/gen/cloudresourcemanager1_beta1/src/lib.rs index e7f63f5e4a..b71c75c809 100644 --- a/gen/cloudresourcemanager1_beta1/src/lib.rs +++ b/gen/cloudresourcemanager1_beta1/src/lib.rs @@ -383,25 +383,26 @@ impl<'a, C, A> CloudResourceManager /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -490,12 +491,13 @@ impl RequestValue for SetIamPolicyRequest {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -564,7 +566,6 @@ impl RequestValue for GetAncestryRequest {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -572,37 +573,40 @@ impl RequestValue for GetAncestryRequest {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -616,7 +620,6 @@ impl RequestValue for GetAncestryRequest {} /// * [set iam policy organizations](struct.OrganizationSetIamPolicyCall.html) (response) /// * [get iam policy projects](struct.ProjectGetIamPolicyCall.html) (response) /// * [get iam policy organizations](struct.OrganizationGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. @@ -713,9 +716,11 @@ impl Part for Ancestor {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -726,7 +731,6 @@ impl Part for Ancestor {} /// /// * [delete projects](struct.ProjectDeleteCall.html) (response) /// * [undelete projects](struct.ProjectUndeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -989,48 +993,49 @@ impl Part for Binding {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// The configuration for logging of each type of permission. diff --git a/gen/cloudresourcemanager2/src/lib.rs b/gen/cloudresourcemanager2/src/lib.rs index 97cbc70de5..7b22cf05f6 100644 --- a/gen/cloudresourcemanager2/src/lib.rs +++ b/gen/cloudresourcemanager2/src/lib.rs @@ -386,25 +386,26 @@ impl<'a, C, A> CloudResourceManager /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -539,12 +540,13 @@ impl RequestValue for SetIamPolicyRequest {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -616,7 +618,6 @@ impl RequestValue for MoveFolderRequest {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -624,37 +625,40 @@ impl RequestValue for MoveFolderRequest {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -666,7 +670,6 @@ impl RequestValue for MoveFolderRequest {} /// /// * [set iam policy folders](struct.FolderSetIamPolicyCall.html) (response) /// * [get iam policy folders](struct.FolderGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. @@ -933,48 +936,49 @@ impl Part for Binding {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// The configuration for logging of each type of permission. diff --git a/gen/cloudscheduler1/src/lib.rs b/gen/cloudscheduler1/src/lib.rs index 88dee3df03..ee907c37cb 100644 --- a/gen/cloudscheduler1/src/lib.rs +++ b/gen/cloudscheduler1/src/lib.rs @@ -617,7 +617,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -670,9 +671,11 @@ impl Part for PubsubTarget {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -682,7 +685,6 @@ impl Part for PubsubTarget {} /// The list links the activity name, along with information about where it is used (one of *request* and *response*). /// /// * [locations jobs delete projects](struct.ProjectLocationJobDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/cloudscheduler1_beta1/src/lib.rs b/gen/cloudscheduler1_beta1/src/lib.rs index d3a92f0109..b578baca45 100644 --- a/gen/cloudscheduler1_beta1/src/lib.rs +++ b/gen/cloudscheduler1_beta1/src/lib.rs @@ -617,7 +617,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -670,9 +671,11 @@ impl Part for PubsubTarget {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -682,7 +685,6 @@ impl Part for PubsubTarget {} /// The list links the activity name, along with information about where it is used (one of *request* and *response*). /// /// * [locations jobs delete projects](struct.ProjectLocationJobDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/cloudshell1/src/lib.rs b/gen/cloudshell1/src/lib.rs index 96f25aed8e..fc1e8df42e 100644 --- a/gen/cloudshell1/src/lib.rs +++ b/gen/cloudshell1/src/lib.rs @@ -476,9 +476,11 @@ impl ResponseResult for Operation {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -489,7 +491,6 @@ impl ResponseResult for Operation {} /// /// * [delete operations](struct.OperationDeleteCall.html) (response) /// * [cancel operations](struct.OperationCancelCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/cloudtasks2/src/lib.rs b/gen/cloudtasks2/src/lib.rs index ed1eeb4c35..41fb2a5c61 100644 --- a/gen/cloudtasks2/src/lib.rs +++ b/gen/cloudtasks2/src/lib.rs @@ -608,12 +608,13 @@ impl RequestValue for PauseQueueRequest {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -781,7 +782,6 @@ impl ResponseResult for Queue {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -789,37 +789,40 @@ impl ResponseResult for Queue {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -831,7 +834,6 @@ impl ResponseResult for Queue {} /// /// * [locations queues set iam policy projects](struct.ProjectLocationQueueSetIamPolicyCall.html) (response) /// * [locations queues get iam policy projects](struct.ProjectLocationQueueGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Associates a list of `members` to a `role`. @@ -1001,7 +1003,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -1067,9 +1070,11 @@ impl RequestValue for RunTaskRequest {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -1080,7 +1085,6 @@ impl RequestValue for RunTaskRequest {} /// /// * [locations queues delete projects](struct.ProjectLocationQueueDeleteCall.html) (response) /// * [locations queues tasks delete projects](struct.ProjectLocationQueueTaskDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/cloudtasks2_beta2/src/lib.rs b/gen/cloudtasks2_beta2/src/lib.rs index e3cd607781..1d8aac5c21 100644 --- a/gen/cloudtasks2_beta2/src/lib.rs +++ b/gen/cloudtasks2_beta2/src/lib.rs @@ -615,7 +615,6 @@ impl RequestValue for PauseQueueRequest {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -623,37 +622,40 @@ impl RequestValue for PauseQueueRequest {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -665,7 +667,6 @@ impl RequestValue for PauseQueueRequest {} /// /// * [locations queues set iam policy projects](struct.ProjectLocationQueueSetIamPolicyCall.html) (response) /// * [locations queues get iam policy projects](struct.ProjectLocationQueueGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Associates a list of `members` to a `role`. @@ -861,7 +862,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -1022,9 +1024,11 @@ impl RequestValue for LeaseTasksRequest {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -1036,7 +1040,6 @@ impl RequestValue for LeaseTasksRequest {} /// * [locations queues delete projects](struct.ProjectLocationQueueDeleteCall.html) (response) /// * [locations queues tasks delete projects](struct.ProjectLocationQueueTaskDeleteCall.html) (response) /// * [locations queues tasks acknowledge projects](struct.ProjectLocationQueueTaskAcknowledgeCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -1209,12 +1212,13 @@ impl RequestValue for TestIamPermissionsRequest {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which diff --git a/gen/cloudtasks2_beta3/src/lib.rs b/gen/cloudtasks2_beta3/src/lib.rs index 55a4b71e95..8f98030286 100644 --- a/gen/cloudtasks2_beta3/src/lib.rs +++ b/gen/cloudtasks2_beta3/src/lib.rs @@ -390,22 +390,21 @@ impl<'a, C, A> CloudTasks /// temporarily reduce the queue's effective rate. User-specified settings /// will not be changed. /// -/// System throttling happens because: +/// System throttling happens because: /// -/// * Cloud Tasks backoffs on all errors. Normally the backoff specified in -/// rate limits will be used. But if the worker returns -/// `429` (Too Many Requests), `503` (Service Unavailable), or the rate of -/// errors is high, Cloud Tasks will use a higher backoff rate. The retry -/// specified in the `Retry-After` HTTP response header is considered. +/// * Cloud Tasks backoffs on all errors. Normally the backoff specified in +/// rate limits will be used. But if the worker returns +/// `429` (Too Many Requests), `503` (Service Unavailable), or the rate of +/// errors is high, Cloud Tasks will use a higher backoff rate. The retry +/// specified in the `Retry-After` HTTP response header is considered. /// -/// * To prevent traffic spikes and to smooth sudden large traffic spikes, -/// dispatches ramp up slowly when the queue is newly created or idle and -/// if large numbers of tasks suddenly become available to dispatch (due to -/// spikes in create task rates, the queue being unpaused, or many tasks -/// that are scheduled at the same time). +/// * To prevent traffic spikes and to smooth sudden large traffic spikes, +/// dispatches ramp up slowly when the queue is newly created or idle and +/// if large numbers of tasks suddenly become available to dispatch (due to +/// spikes in create task rates, the queue being unpaused, or many tasks +/// that are scheduled at the same time). /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct HttpRequest { /// HTTP request body. @@ -713,12 +712,13 @@ impl RequestValue for PauseQueueRequest {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -885,7 +885,6 @@ impl ResponseResult for Queue {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -893,37 +892,40 @@ impl ResponseResult for Queue {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -935,7 +937,6 @@ impl ResponseResult for Queue {} /// /// * [locations queues set iam policy projects](struct.ProjectLocationQueueSetIamPolicyCall.html) (response) /// * [locations queues get iam policy projects](struct.ProjectLocationQueueGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Associates a list of `members` to a `role`. @@ -1112,7 +1113,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -1178,9 +1180,11 @@ impl RequestValue for RunTaskRequest {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -1191,7 +1195,6 @@ impl RequestValue for RunTaskRequest {} /// /// * [locations queues delete projects](struct.ProjectLocationQueueDeleteCall.html) (response) /// * [locations queues tasks delete projects](struct.ProjectLocationQueueTaskDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/cloudtrace1/src/lib.rs b/gen/cloudtrace1/src/lib.rs index 957637bcd8..07bea9c946 100644 --- a/gen/cloudtrace1/src/lib.rs +++ b/gen/cloudtrace1/src/lib.rs @@ -391,9 +391,11 @@ impl ResponseResult for ListTracesResponse {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -403,7 +405,6 @@ impl ResponseResult for ListTracesResponse {} /// The list links the activity name, along with information about where it is used (one of *request* and *response*). /// /// * [patch traces projects](struct.ProjectPatchTraceCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -1438,11 +1439,11 @@ impl<'a, C, A> ProjectTraceListCall<'a, C, A> where C: BorrowMut, /// Field used to sort the returned traces. Optional. /// Can be one of the following: /// - /// * `trace_id` - /// * `name` (`name` field of root span in the trace) - /// * `duration` (difference between `end_time` and `start_time` fields of - /// the root span) - /// * `start` (`start_time` field of the root span) + /// * `trace_id` + /// * `name` (`name` field of root span in the trace) + /// * `duration` (difference between `end_time` and `start_time` fields of + /// the root span) + /// * `start` (`start_time` field of the root span) /// /// Descending order can be specified by appending `desc` to the sort field /// (for example, `name desc`). @@ -1460,30 +1461,30 @@ impl<'a, C, A> ProjectTraceListCall<'a, C, A> where C: BorrowMut, /// a plus symbol (`+`) to the search term. /// Multiple terms are ANDed. Syntax: /// - /// * `root:NAME_PREFIX` or `NAME_PREFIX`: Return traces where any root - /// span starts with `NAME_PREFIX`. - /// * `+root:NAME` or `+NAME`: Return traces where any root span's name is - /// exactly `NAME`. - /// * `span:NAME_PREFIX`: Return traces where any span starts with - /// `NAME_PREFIX`. - /// * `+span:NAME`: Return traces where any span's name is exactly - /// `NAME`. - /// * `latency:DURATION`: Return traces whose overall latency is - /// greater or equal to than `DURATION`. Accepted units are nanoseconds - /// (`ns`), milliseconds (`ms`), and seconds (`s`). Default is `ms`. For - /// example, `latency:24ms` returns traces whose overall latency - /// is greater than or equal to 24 milliseconds. - /// * `label:LABEL_KEY`: Return all traces containing the specified - /// label key (exact match, case-sensitive) regardless of the key:value - /// pair's value (including empty values). - /// * `LABEL_KEY:VALUE_PREFIX`: Return all traces containing the specified - /// label key (exact match, case-sensitive) whose value starts with - /// `VALUE_PREFIX`. Both a key and a value must be specified. - /// * `+LABEL_KEY:VALUE`: Return all traces containing a key:value pair - /// exactly matching the specified text. Both a key and a value must be - /// specified. - /// * `method:VALUE`: Equivalent to `/http/method:VALUE`. - /// * `url:VALUE`: Equivalent to `/http/url:VALUE`. + /// * `root:NAME_PREFIX` or `NAME_PREFIX`: Return traces where any root + /// span starts with `NAME_PREFIX`. + /// * `+root:NAME` or `+NAME`: Return traces where any root span's name is + /// exactly `NAME`. + /// * `span:NAME_PREFIX`: Return traces where any span starts with + /// `NAME_PREFIX`. + /// * `+span:NAME`: Return traces where any span's name is exactly + /// `NAME`. + /// * `latency:DURATION`: Return traces whose overall latency is + /// greater or equal to than `DURATION`. Accepted units are nanoseconds + /// (`ns`), milliseconds (`ms`), and seconds (`s`). Default is `ms`. For + /// example, `latency:24ms` returns traces whose overall latency + /// is greater than or equal to 24 milliseconds. + /// * `label:LABEL_KEY`: Return all traces containing the specified + /// label key (exact match, case-sensitive) regardless of the key:value + /// pair's value (including empty values). + /// * `LABEL_KEY:VALUE_PREFIX`: Return all traces containing the specified + /// label key (exact match, case-sensitive) whose value starts with + /// `VALUE_PREFIX`. Both a key and a value must be specified. + /// * `+LABEL_KEY:VALUE`: Return all traces containing a key:value pair + /// exactly matching the specified text. Both a key and a value must be + /// specified. + /// * `method:VALUE`: Equivalent to `/http/method:VALUE`. + /// * `url:VALUE`: Equivalent to `/http/url:VALUE`. /// /// Sets the *filter* query property to the given value. pub fn filter(mut self, new_value: &str) -> ProjectTraceListCall<'a, C, A> { diff --git a/gen/cloudtrace2/src/lib.rs b/gen/cloudtrace2/src/lib.rs index 3666ff5940..7255acf535 100644 --- a/gen/cloudtrace2/src/lib.rs +++ b/gen/cloudtrace2/src/lib.rs @@ -430,7 +430,10 @@ pub struct Span { pub display_name: Option, /// The resource name of the span in the following format: /// - /// projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/SPAN_ID is a unique identifier for a trace within a project; + /// ````text + /// projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/SPAN_ID is a unique identifier for a trace within a project; + /// ```` + /// /// it is a 32-character hexadecimal encoding of a 16-byte array. /// /// [SPAN_ID] is a unique identifier for a span within a trace; it @@ -552,10 +555,11 @@ pub struct Attributes { /// long. The value can be a string up to 256 bytes, a signed 64-bit integer, /// or the Boolean values `true` and `false`. For example: /// - /// "/instance_id": "my-instance" - /// "/http/user_agent": "" - /// "/http/request_bytes": 300 - /// "abc.com/myattribute": true + /// ````text + /// "/instance_id": "my-instance" + /// "/http/user_agent": "" + /// "/http/request_bytes": 300 + /// "abc.com/myattribute": true```` #[serde(rename="attributeMap")] pub attribute_map: Option>, } @@ -636,9 +640,11 @@ impl RequestValue for BatchWriteSpansRequest {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -648,7 +654,6 @@ impl RequestValue for BatchWriteSpansRequest {} /// The list links the activity name, along with information about where it is used (one of *request* and *response*). /// /// * [traces batch write projects](struct.ProjectTraceBatchWriteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -1121,7 +1126,10 @@ impl<'a, C, A> ProjectTraceSpanCreateSpanCall<'a, C, A> where C: BorrowMut>, /// Scores for the requested attributes. The map keys are attribute names (same /// as the requested_attribute field in AnalyzeCommentRequest, for example diff --git a/gen/composer1/src/lib.rs b/gen/composer1/src/lib.rs index e9cafb7450..ae634de8c5 100644 --- a/gen/composer1/src/lib.rs +++ b/gen/composer1/src/lib.rs @@ -684,9 +684,11 @@ impl Part for NodeConfig {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -696,7 +698,6 @@ impl Part for NodeConfig {} /// The list links the activity name, along with information about where it is used (one of *request* and *response*). /// /// * [locations operations delete projects](struct.ProjectLocationOperationDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -1558,15 +1559,17 @@ impl<'a, C, A> ProjectLocationEnvironmentPatchCall<'a, C, A> where C: BorrowMut< /// "config.softwareConfig.pypiPackages.numpy". The included patch /// environment would specify the scikit-learn version as follows: /// - /// { - /// "config":{ - /// "softwareConfig":{ - /// "pypiPackages":{ - /// "scikit-learn":"==0.19.0" - /// } - /// } + /// ````text + /// { + /// "config":{ + /// "softwareConfig":{ + /// "pypiPackages":{ + /// "scikit-learn":"==0.19.0" /// } /// } + /// } + /// } + /// ```` /// /// Note that in the above example, any existing PyPI packages /// other than scikit-learn and numpy will be unaffected. @@ -1580,12 +1583,14 @@ impl<'a, C, A> ProjectLocationEnvironmentPatchCall<'a, C, A> where C: BorrowMut< /// provide the paths "labels.label1", "labels.label2", and "labels.label3" /// and populate the patch environment as follows: /// - /// { - /// "labels":{ - /// "label1":"new-label1-value" - /// "label2":"new-label2-value" - /// } - /// } + /// ````text + /// { + /// "labels":{ + /// "label1":"new-label1-value" + /// "label2":"new-label2-value" + /// } + /// } + /// ```` /// /// Note that in the above example, any existing labels that are not /// included in the `updateMask` will be unaffected. @@ -1598,19 +1603,21 @@ impl<'a, C, A> ProjectLocationEnvironmentPatchCall<'a, C, A> where C: BorrowMut< /// the path "config.softwareConfig.pypiPackages", and /// the patch environment would be the following: /// - /// { - /// "config":{ - /// "softwareConfig":{ - /// "pypiPackages":{ - /// "botocore":"==1.7.14" - /// } - /// } + /// ````text + /// { + /// "config":{ + /// "softwareConfig":{ + /// "pypiPackages":{ + /// "botocore":"==1.7.14" /// } /// } + /// } + /// } + /// ```` /// /// **Note:** Only the following fields can be updated: /// - /// + ///
        /// /// /// diff --git a/gen/container1/src/lib.rs b/gen/container1/src/lib.rs index 9760586607..f431ebfc84 100644 --- a/gen/container1/src/lib.rs +++ b/gen/container1/src/lib.rs @@ -471,9 +471,11 @@ impl Part for AcceleratorConfig {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -484,7 +486,6 @@ impl Part for AcceleratorConfig {} /// /// * [zones operations cancel projects](struct.ProjectZoneOperationCancelCall.html) (response) /// * [locations operations cancel projects](struct.ProjectLocationOperationCancelCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/containeranalysis1_beta1/src/lib.rs b/gen/containeranalysis1_beta1/src/lib.rs index 0d462cccc5..bef37b6bd9 100644 --- a/gen/containeranalysis1_beta1/src/lib.rs +++ b/gen/containeranalysis1_beta1/src/lib.rs @@ -576,9 +576,11 @@ impl Part for AliasContext {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -589,7 +591,6 @@ impl Part for AliasContext {} /// /// * [notes delete projects](struct.ProjectNoteDeleteCall.html) (response) /// * [occurrences delete projects](struct.ProjectOccurrenceDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -1284,13 +1285,15 @@ pub struct PgpSignedAttestation { /// abbreviated key IDs, but only the full fingerprint is guaranteed to work. /// In gpg, the full fingerprint can be retrieved from the `fpr` field /// returned when calling --list-keys with --with-colons. For example: - /// ``` + /// + /// ````text /// gpg --with-colons --with-fingerprint --force-v4-certs \ /// --list-keys attester@example.com /// tru::1:1513631572:0:3:1:5 /// pub:...... /// fpr:::::::::24FF6481B76AC91E66A00AC657A93A81EF3AE6FB: - /// ``` + /// ```` + /// /// Above, the fingerprint is `24FF6481B76AC91E66A00AC657A93A81EF3AE6FB`. #[serde(rename="pgpKeyId")] pub pgp_key_id: Option, @@ -1422,7 +1425,6 @@ impl Part for Details {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -1430,37 +1432,40 @@ impl Part for Details {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -1474,7 +1479,6 @@ impl Part for Details {} /// * [occurrences set iam policy projects](struct.ProjectOccurrenceSetIamPolicyCall.html) (response) /// * [notes set iam policy projects](struct.ProjectNoteSetIamPolicyCall.html) (response) /// * [occurrences get iam policy projects](struct.ProjectOccurrenceGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. @@ -1745,25 +1749,26 @@ impl Part for BuildSignature {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -1844,12 +1849,13 @@ impl Part for Package {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -1987,9 +1993,10 @@ impl Part for PackageIssue {} /// for quickly selecting a public key ALREADY CONFIGURED on the verifier through /// a trusted channel. Verification implementations MUST reject signatures in any /// of the following circumstances: -/// * The `public_key_id` is not recognized by the verifier. -/// * The public key that `public_key_id` refers to does not verify the -/// signature with respect to the payload. +/// +/// * The `public_key_id` is not recognized by the verifier. +/// * The public key that `public_key_id` refers to does not verify the +/// signature with respect to the payload. /// /// The `signature` contents SHOULD NOT be "attached" (where the payload is /// included with the serialized `signature` bytes). Verifiers MUST ignore any @@ -1999,26 +2006,28 @@ impl Part for PackageIssue {} /// holds this signature). /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Signature { /// The identifier for the public key that verifies this signature. - /// * The `public_key_id` is required. - /// * The `public_key_id` MUST be an RFC3986 conformant URI. - /// * When possible, the `public_key_id` SHOULD be an immutable reference, - /// such as a cryptographic digest. + /// + /// * The `public_key_id` is required. + /// * The `public_key_id` MUST be an RFC3986 conformant URI. + /// * When possible, the `public_key_id` SHOULD be an immutable reference, + /// such as a cryptographic digest. /// /// Examples of valid `public_key_id`s: /// /// OpenPGP V4 public key fingerprint: - /// * "openpgp4fpr:74FAF3B861BDA0870C7B6DEF607E48D2A663AEEA" - /// See https://www.iana.org/assignments/uri-schemes/prov/openpgp4fpr for more - /// details on this scheme. + /// + /// * "openpgp4fpr:74FAF3B861BDA0870C7B6DEF607E48D2A663AEEA" + /// See https://www.iana.org/assignments/uri-schemes/prov/openpgp4fpr for more + /// details on this scheme. /// /// RFC6920 digest-named SubjectPublicKeyInfo (digest of the DER /// serialization): - /// * "ni:///sha-256;cD9o9Cq6LG3jD0iKXqEi_vdjJGecm_iXkbqVoScViaU" - /// * "nih:///sha-256;703f68f42aba2c6de30f488a5ea122fef76324679c9bf89791ba95a1271589a5" + /// + /// * "ni:///sha-256;cD9o9Cq6LG3jD0iKXqEi_vdjJGecm_iXkbqVoScViaU" + /// * "nih:///sha-256;703f68f42aba2c6de30f488a5ea122fef76324679c9bf89791ba95a1271589a5" #[serde(rename="publicKeyId")] pub public_key_id: Option, /// The content of the signature, an opaque bytestring. @@ -2259,48 +2268,49 @@ impl Part for Deployable {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// The configuration for logging of each type of permission. diff --git a/gen/datafusion1_beta1/src/lib.rs b/gen/datafusion1_beta1/src/lib.rs index c4dfba360a..6240b644d6 100644 --- a/gen/datafusion1_beta1/src/lib.rs +++ b/gen/datafusion1_beta1/src/lib.rs @@ -409,23 +409,23 @@ impl ResponseResult for ListInstancesResponse {} /// their respective values. /// /// Supported field names: -/// - "authority", which is "[token]" if IAMContext.token is present, -/// otherwise the value of IAMContext.authority_selector if present, and -/// otherwise a representation of IAMContext.principal; or -/// - "iam_principal", a representation of IAMContext.principal even if a -/// token or authority selector is present; or -/// - "" (empty string), resulting in a counter with no fields. +/// +/// * "authority", which is "[token]" if IAMContext.token is present, +/// otherwise the value of IAMContext.authority_selector if present, and +/// otherwise a representation of IAMContext.principal; or +/// * "iam_principal", a representation of IAMContext.principal even if a +/// token or authority selector is present; or +/// * "" (empty string), resulting in a counter with no fields. /// /// Examples: -/// counter { metric: "/debug_access_count" field: "iam_principal" } -/// ==> increment counter /iam/policy/backend_debug_access_count -/// {iam_principal=[value of IAMContext.principal]} +/// counter { metric: "/debug_access_count" field: "iam_principal" } +/// ==> increment counter /iam/policy/backend_debug_access_count +/// {iam_principal=[value of IAMContext.principal]} /// /// At this time we do not support multiple field names (though this may be /// supported in the future). /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct CounterOptions { /// The field value to attribute. @@ -482,12 +482,13 @@ impl RequestValue for SetIamPolicyRequest {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -514,25 +515,26 @@ impl Part for Expr {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -743,7 +745,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -762,7 +765,6 @@ impl ResponseResult for Location {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -770,37 +772,40 @@ impl ResponseResult for Location {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -812,7 +817,6 @@ impl ResponseResult for Location {} /// /// * [locations instances set iam policy projects](struct.ProjectLocationInstanceSetIamPolicyCall.html) (response) /// * [locations instances get iam policy projects](struct.ProjectLocationInstanceGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. @@ -856,9 +860,11 @@ impl ResponseResult for Policy {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -869,7 +875,6 @@ impl ResponseResult for Policy {} /// /// * [locations operations delete projects](struct.ProjectLocationOperationDeleteCall.html) (response) /// * [locations operations cancel projects](struct.ProjectLocationOperationCancelCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -1043,48 +1048,49 @@ impl RequestValue for UpgradeInstanceRequest {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// no description provided diff --git a/gen/dataproc1/src/lib.rs b/gen/dataproc1/src/lib.rs index f3552cf1d3..d2ecff8f7f 100644 --- a/gen/dataproc1/src/lib.rs +++ b/gen/dataproc1/src/lib.rs @@ -525,34 +525,35 @@ impl Part for YarnApplication {} /// Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources.A Policy consists of a list of bindings. A binding binds a list of members to a role, where the members can be user accounts, Google groups, Google domains, and service accounts. A role is a named list of permissions defined by IAM.JSON Example /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } -/// ] +/// "bindings": [ +/// { +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" +/// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] +/// } +/// ] /// } /// YAML Example /// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// For a description of IAM and its features, see the IAM developer's guide (https://cloud.google.com/iam/docs). +/// +/// * members: +/// * user:mike@example.com +/// * group:admins@example.com +/// * domain:google.com +/// * serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// * members: +/// * user:sean@example.com +/// role: roles/viewer +/// For a description of IAM and its features, see the IAM developer's guide (https://cloud.google.com/iam/docs). /// /// # Activities /// @@ -573,7 +574,6 @@ impl Part for YarnApplication {} /// * [regions jobs set iam policy projects](struct.ProjectRegionJobSetIamPolicyCall.html) (response) /// * [locations workflow templates get iam policy projects](struct.ProjectLocationWorkflowTemplateGetIamPolicyCall.html) (response) /// * [regions autoscaling policies set iam policy projects](struct.ProjectRegionAutoscalingPolicySetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Associates a list of members to a role. bindings with no members will result in an error. @@ -805,15 +805,14 @@ impl RequestValue for SubmitJobRequest {} pub struct QueryList { /// Required. The queries to execute. You do not need to terminate a query with a semicolon. Multiple queries can be specified in one string by separating each with a semicolon. Here is an example of an Cloud Dataproc API snippet that uses a QueryList to specify a HiveJob: /// "hiveJob": { - /// "queryList": { - /// "queries": [ - /// "query1", - /// "query2", - /// "query3;query4", - /// ] - /// } + /// "queryList": { + /// "queries": [ + /// "query1", + /// "query2", + /// "query3;query4", + /// ] + /// } /// } - /// pub queries: Option>, } @@ -7516,19 +7515,19 @@ impl<'a, C, A> ProjectRegionClusterPatchCall<'a, C, A> where C: BorrowMutNote: Currently, only the following fields can be updated:
        Mask
        Mask Purpose
        labels Update labels
        config.worker_config.num_instances Resize primary worker group
        config.secondary_worker_config.num_instances Resize secondary worker group
        /// diff --git a/gen/datastore1/src/lib.rs b/gen/datastore1/src/lib.rs index 6367c3de4f..21bd68284f 100644 --- a/gen/datastore1/src/lib.rs +++ b/gen/datastore1/src/lib.rs @@ -639,9 +639,11 @@ impl Part for ArrayValue {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -652,7 +654,6 @@ impl Part for ArrayValue {} /// /// * [operations delete projects](struct.ProjectOperationDeleteCall.html) (response) /// * [operations cancel projects](struct.ProjectOperationCancelCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -663,8 +664,8 @@ impl ResponseResult for Empty {} /// different programming environments, including REST APIs and RPC APIs. It is /// used by [gRPC](https://github.com/grpc). The error model is designed to be: /// -/// - Simple to use and understand for most users -/// - Flexible enough to meet unexpected needs +/// * Simple to use and understand for most users +/// * Flexible enough to meet unexpected needs /// /// # Overview /// @@ -694,26 +695,25 @@ impl ResponseResult for Empty {} /// /// Example uses of this error model include: /// -/// - Partial errors. If a service needs to return partial errors to the client, -/// it may embed the `Status` in the normal response to indicate the partial -/// errors. +/// * Partial errors. If a service needs to return partial errors to the client, +/// it may embed the `Status` in the normal response to indicate the partial +/// errors. /// -/// - Workflow errors. A typical workflow has multiple steps. Each step may -/// have a `Status` message for error reporting. +/// * Workflow errors. A typical workflow has multiple steps. Each step may +/// have a `Status` message for error reporting. /// -/// - Batch operations. If a client uses batch request and batch response, the -/// `Status` message should be used directly inside batch response, one for -/// each error sub-response. +/// * Batch operations. If a client uses batch request and batch response, the +/// `Status` message should be used directly inside batch response, one for +/// each error sub-response. /// -/// - Asynchronous operations. If an API call embeds asynchronous operation -/// results in its response, the status of those operations should be -/// represented directly using the `Status` message. +/// * Asynchronous operations. If an API call embeds asynchronous operation +/// results in its response, the status of those operations should be +/// represented directly using the `Status` message. /// -/// - Logging. If some API errors are stored in logs, the message `Status` could -/// be used directly after any stripping needed for security/privacy reasons. +/// * Logging. If some API errors are stored in logs, the message `Status` could +/// be used directly after any stripping needed for security/privacy reasons. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Status { /// A developer-facing error message, which should be in English. Any diff --git a/gen/dialogflow2/src/lib.rs b/gen/dialogflow2/src/lib.rs index b1629b37a7..3f7d9436fe 100644 --- a/gen/dialogflow2/src/lib.rs +++ b/gen/dialogflow2/src/lib.rs @@ -406,12 +406,12 @@ pub struct GoogleCloudDialogflowV2DetectIntentRequest { pub output_audio_config: Option, /// Required. The input specification. It can be set to: /// - /// 1. an audio config - /// which instructs the speech recognizer how to process the speech audio, + /// 1. an audio config + /// which instructs the speech recognizer how to process the speech audio, /// - /// 2. a conversational query in the form of text, or + /// 1. a conversational query in the form of text, or /// - /// 3. an event that specifies which intent to trigger. + /// 1. an event that specifies which intent to trigger. #[serde(rename="queryInput")] pub query_input: Option, /// Optional. The parameters of this query. @@ -484,15 +484,14 @@ impl Part for GoogleCloudDialogflowV2IntentMessageSimpleResponses {} /// Represents the query input. It can contain either: /// -/// 1. An audio config which -/// instructs the speech recognizer how to process the speech audio. +/// 1. An audio config which +/// instructs the speech recognizer how to process the speech audio. /// -/// 2. A conversational query in the form of text,. +/// 1. A conversational query in the form of text,. /// -/// 3. An event that specifies which intent to trigger. +/// 1. An event that specifies which intent to trigger. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleCloudDialogflowV2QueryInput { /// The natural language text to be processed. @@ -746,12 +745,12 @@ pub struct GoogleCloudDialogflowV2EntityTypeEntity { /// /// For `KIND_MAP` entity types: /// - /// * A canonical value to be used in place of synonyms. + /// * A canonical value to be used in place of synonyms. /// /// For `KIND_LIST` entity types: /// - /// * A string that can contain references to other entity types (with or - /// without aliases). + /// * A string that can contain references to other entity types (with or + /// without aliases). pub value: Option, } @@ -1055,9 +1054,11 @@ impl Part for GoogleCloudDialogflowV2SynthesizeSpeechConfig {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -1072,7 +1073,6 @@ impl Part for GoogleCloudDialogflowV2SynthesizeSpeechConfig {} /// * [agent sessions contexts delete projects](struct.ProjectAgentSessionContextDeleteCall.html) (response) /// * [agent sessions entity types delete projects](struct.ProjectAgentSessionEntityTypeDeleteCall.html) (response) /// * [agent intents delete projects](struct.ProjectAgentIntentDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleProtobufEmpty { _never_set: Option } @@ -1133,6 +1133,7 @@ pub struct GoogleCloudDialogflowV2ImportAgentRequest { /// The agent to import. /// /// Example for how to import an agent via the command line: + /// ///
        curl \
             ///   'https://dialogflow.googleapis.com/v2/projects/<project_name>/agent:import\
             ///    -X POST \
        @@ -1253,6 +1254,7 @@ pub struct GoogleCloudDialogflowV2RestoreAgentRequest {
             /// The agent to restore.
             /// 
             /// Example for how to restore an agent via the command line:
        +    /// 
             /// 
        curl \
             ///   'https://dialogflow.googleapis.com/v2/projects/<project_name>/agent:restore\
             ///    -X POST \
        @@ -1893,10 +1895,10 @@ pub struct GoogleCloudDialogflowV2IntentTrainingPhrase {
             /// If you want to annotate the training phrase, you must create multiple
             /// parts, where the fields of each part are populated in one of two ways:
             /// 
        -    /// -   `Part.text` is set to a part of the phrase that has no parameters.
        -    /// -   `Part.text` is set to a part of the phrase that you want to annotate,
        -    ///     and the `entity_type`, `alias`, and `user_defined` fields are all
        -    ///     set.
        +    /// * `Part.text` is set to a part of the phrase that has no parameters.
        +    /// * `Part.text` is set to a part of the phrase that you want to annotate,
        +    ///   and the `entity_type`, `alias`, and `user_defined` fields are all
        +    ///   set.
             pub parts: Option>,
             /// Required. The type of the training phrase.
             #[serde(rename="type")]
        diff --git a/gen/dialogflow2_beta1/src/lib.rs b/gen/dialogflow2_beta1/src/lib.rs
        index c2fdec9d89..86b11b2033 100644
        --- a/gen/dialogflow2_beta1/src/lib.rs
        +++ b/gen/dialogflow2_beta1/src/lib.rs
        @@ -919,10 +919,10 @@ pub struct GoogleCloudDialogflowV2beta1IntentTrainingPhrase {
             /// If you want to annotate the training phrase, you must create multiple
             /// parts, where the fields of each part are populated in one of two ways:
             /// 
        -    /// -   `Part.text` is set to a part of the phrase that has no parameters.
        -    /// -   `Part.text` is set to a part of the phrase that you want to annotate,
        -    ///     and the `entity_type`, `alias`, and `user_defined` fields are all
        -    ///     set.
        +    /// * `Part.text` is set to a part of the phrase that has no parameters.
        +    /// * `Part.text` is set to a part of the phrase that you want to annotate,
        +    ///   and the `entity_type`, `alias`, and `user_defined` fields are all
        +    ///   set.
             pub parts: Option>,
             /// Required. The type of the training phrase.
             #[serde(rename="type")]
        @@ -1014,12 +1014,12 @@ pub struct GoogleCloudDialogflowV2beta1DetectIntentRequest {
             pub output_audio_config: Option,
             /// Required. The input specification. It can be set to:
             /// 
        -    /// 1.  an audio config
        -    ///     which instructs the speech recognizer how to process the speech audio,
        +    /// 1. an audio config
        +    ///    which instructs the speech recognizer how to process the speech audio,
             /// 
        -    /// 2.  a conversational query in the form of text, or
        +    /// 1. a conversational query in the form of text, or
             /// 
        -    /// 3.  an event that specifies which intent to trigger.
        +    /// 1. an event that specifies which intent to trigger.
             #[serde(rename="queryInput")]
             pub query_input: Option,
             /// Optional. The parameters of this query.
        @@ -1179,15 +1179,14 @@ impl Part for GoogleCloudDialogflowV2beta1IntentMessageBasicCardButtonOpenUriAct
         
         /// Represents the query input. It can contain either:
         /// 
        -/// 1.  An audio config which
        -///     instructs the speech recognizer how to process the speech audio.
        +/// 1. An audio config which
        +///    instructs the speech recognizer how to process the speech audio.
         /// 
        -/// 2.  A conversational query in the form of text.
        +/// 1. A conversational query in the form of text.
         /// 
        -/// 3.  An event that specifies which intent to trigger.
        +/// 1. An event that specifies which intent to trigger.
         /// 
         /// This type is not used in any activity, and only used as *part* of another schema.
        -/// 
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct GoogleCloudDialogflowV2beta1QueryInput {
             /// The natural language text to be processed.
        @@ -1220,6 +1219,7 @@ pub struct GoogleCloudDialogflowV2beta1ImportAgentRequest {
             /// The agent to import.
             /// 
             /// Example for how to import an agent via the command line:
        +    /// 
             /// 
        curl \
             ///   'https://dialogflow.googleapis.com/v2beta1/projects/<project_name>/agent:import\
             ///    -X POST \
        @@ -1298,9 +1298,11 @@ impl Part for GoogleCloudDialogflowV2beta1KnowledgeAnswers {}
         /// empty messages in your APIs. A typical example is to use it as the request
         /// or the response type of an API method. For instance:
         /// 
        -///     service Foo {
        -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        -///     }
        +/// ````text
        +/// service Foo {
        +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        +/// }
        +/// ````
         /// 
         /// The JSON representation for `Empty` is empty JSON object `{}`.
         /// 
        @@ -1320,7 +1322,6 @@ impl Part for GoogleCloudDialogflowV2beta1KnowledgeAnswers {}
         /// * [agent sessions entity types delete projects](struct.ProjectAgentSessionEntityTypeDeleteCall.html) (response)
         /// * [agent environments users sessions delete contexts projects](struct.ProjectAgentEnvironmentUserSessionDeleteContextCall.html) (response)
         /// * [agent intents delete projects](struct.ProjectAgentIntentDeleteCall.html) (response)
        -/// 
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct GoogleProtobufEmpty { _never_set: Option }
         
        @@ -2791,6 +2792,7 @@ pub struct GoogleCloudDialogflowV2beta1RestoreAgentRequest {
             /// The agent to restore.
             /// 
             /// Example for how to restore an agent via the command line:
        +    /// 
             /// 
        curl \
             ///   'https://dialogflow.googleapis.com/v2beta1/projects/<project_name>/agent:restore\
             ///    -X POST \
        @@ -2829,12 +2831,12 @@ pub struct GoogleCloudDialogflowV2beta1EntityTypeEntity {
             /// 
             /// For `KIND_MAP` entity types:
             /// 
        -    /// *   A canonical value to be used in place of synonyms.
        +    /// * A canonical value to be used in place of synonyms.
             /// 
             /// For `KIND_LIST` entity types:
             /// 
        -    /// *   A string that can contain references to other entity types (with or
        -    ///     without aliases).
        +    /// * A string that can contain references to other entity types (with or
        +    ///   without aliases).
             pub value: Option,
         }
         
        @@ -3066,7 +3068,7 @@ impl<'a, C, A> ProjectMethods<'a, C, A> {
             /// only use `projects.knowledgeBases.documents`.
             /// 
             /// Operation 
        +    /// metadata: KnowledgeOperationMetadata>
             /// 
             /// # Arguments
             ///
        @@ -3282,7 +3284,7 @@ impl<'a, C, A> ProjectMethods<'a, C, A> {
             /// only use `projects.knowledgeBases.documents`.
             /// 
             /// Operation 
        +    /// metadata: KnowledgeOperationMetadata>
             /// 
             /// # Arguments
             ///
        @@ -3341,7 +3343,7 @@ impl<'a, C, A> ProjectMethods<'a, C, A> {
             /// only use `projects.knowledgeBases.documents`.
             /// 
             /// Operation 
        +    /// metadata: KnowledgeOperationMetadata>
             /// 
             /// # Arguments
             ///
        @@ -3576,7 +3578,7 @@ impl<'a, C, A> ProjectMethods<'a, C, A> {
             /// only use `projects.knowledgeBases.documents`.
             /// 
             /// Operation 
        +    /// metadata: KnowledgeOperationMetadata>
             /// 
             /// # Arguments
             ///
        @@ -4107,7 +4109,7 @@ impl<'a, C, A> ProjectMethods<'a, C, A> {
             /// only use `projects.knowledgeBases.documents`.
             /// 
             /// Operation 
        +    /// metadata: KnowledgeOperationMetadata>
             /// 
             /// # Arguments
             ///
        @@ -4176,7 +4178,7 @@ impl<'a, C, A> ProjectMethods<'a, C, A> {
             /// only use `projects.knowledgeBases.documents`.
             /// 
             /// Operation 
        +    /// metadata: KnowledgeOperationMetadata>
             /// 
             /// # Arguments
             ///
        @@ -4228,7 +4230,7 @@ impl<'a, C, A> ProjectMethods<'a, C, A> {
             /// only use `projects.knowledgeBases.documents`.
             /// 
             /// Operation 
        +    /// metadata: KnowledgeOperationMetadata>
             /// 
             /// # Arguments
             ///
        @@ -4532,7 +4534,7 @@ impl<'a, C, A> ProjectMethods<'a, C, A> {
             /// only use `projects.knowledgeBases.documents`.
             /// 
             /// Operation 
        +    /// metadata: KnowledgeOperationMetadata>
             /// 
             /// # Arguments
             ///
        @@ -6508,7 +6510,7 @@ impl<'a, C, A> ProjectAgentKnowledgeBaseDeleteCall<'a, C, A> where C: BorrowMut<
         /// only use `projects.knowledgeBases.documents`.
         /// 
         /// Operation 
        +/// metadata: KnowledgeOperationMetadata>
         ///
         /// A builder for the *agent.knowledgeBases.documents.delete* method supported by a *project* resource.
         /// It is not used directly, but through a `ProjectMethods` instance.
        @@ -9018,7 +9020,7 @@ impl<'a, C, A> ProjectAgentRestoreCall<'a, C, A> where C: BorrowMut
        +/// metadata: KnowledgeOperationMetadata>
         ///
         /// A builder for the *agent.knowledgeBases.documents.patch* method supported by a *project* resource.
         /// It is not used directly, but through a `ProjectMethods` instance.
        @@ -9610,7 +9612,7 @@ impl<'a, C, A> ProjectAgentSessionDetectIntentCall<'a, C, A> where C: BorrowMut<
         /// only use `projects.knowledgeBases.documents`.
         /// 
         /// Operation 
        +/// metadata: KnowledgeOperationMetadata>
         ///
         /// A builder for the *knowledgeBases.documents.create* method supported by a *project* resource.
         /// It is not used directly, but through a `ProjectMethods` instance.
        @@ -12400,7 +12402,7 @@ impl<'a, C, A> ProjectAgentExportCall<'a, C, A> where C: BorrowMut
        +/// metadata: KnowledgeOperationMetadata>
         ///
         /// A builder for the *agent.knowledgeBases.documents.reload* method supported by a *project* resource.
         /// It is not used directly, but through a `ProjectMethods` instance.
        @@ -18752,7 +18754,7 @@ impl<'a, C, A> ProjectAgentSessionContextPatchCall<'a, C, A> where C: BorrowMut<
         /// only use `projects.knowledgeBases.documents`.
         /// 
         /// Operation 
        +/// metadata: KnowledgeOperationMetadata>
         ///
         /// A builder for the *agent.knowledgeBases.documents.create* method supported by a *project* resource.
         /// It is not used directly, but through a `ProjectMethods` instance.
        @@ -19543,7 +19545,7 @@ impl<'a, C, A> ProjectAgentSessionDeleteContextCall<'a, C, A> where C: BorrowMut
         /// only use `projects.knowledgeBases.documents`.
         /// 
         /// Operation 
        +/// metadata: KnowledgeOperationMetadata>
         ///
         /// A builder for the *knowledgeBases.documents.patch* method supported by a *project* resource.
         /// It is not used directly, but through a `ProjectMethods` instance.
        @@ -20122,7 +20124,7 @@ impl<'a, C, A> ProjectKnowledgeBaseDocumentListCall<'a, C, A> where C: BorrowMut
         /// only use `projects.knowledgeBases.documents`.
         /// 
         /// Operation 
        +/// metadata: KnowledgeOperationMetadata>
         ///
         /// A builder for the *knowledgeBases.documents.delete* method supported by a *project* resource.
         /// It is not used directly, but through a `ProjectMethods` instance.
        @@ -23695,7 +23697,7 @@ impl<'a, C, A> ProjectAgentIntentDeleteCall<'a, C, A> where C: BorrowMut
        +/// metadata: KnowledgeOperationMetadata>
         ///
         /// A builder for the *knowledgeBases.documents.reload* method supported by a *project* resource.
         /// It is not used directly, but through a `ProjectMethods` instance.
        diff --git a/gen/digitalassetlinks1/src/lib.rs b/gen/digitalassetlinks1/src/lib.rs
        index 694dff2488..013cb1d235 100644
        --- a/gen/digitalassetlinks1/src/lib.rs
        +++ b/gen/digitalassetlinks1/src/lib.rs
        @@ -439,21 +439,23 @@ impl ResponseResult for ListResponse {}
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct CertificateInfo {
             /// The uppercase SHA-265 fingerprint of the certificate.  From the PEM
        -    ///  certificate, it can be acquired like this:
        +    /// certificate, it can be acquired like this:
             /// 
        -    ///     $ keytool -printcert -file $CERTFILE | grep SHA256:
        -    ///     SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
        -    ///         42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````text
        +    /// $ keytool -printcert -file $CERTFILE | grep SHA256:
        +    /// SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
        +    ///     42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````
             /// 
             /// or like this:
             /// 
        -    ///     $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
        -    ///     SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
        -    ///         16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````text
        +    /// $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
        +    /// SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
        +    ///     16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````
             /// 
        -    /// In this example, the contents of this field would be `14:6D:E9:83:C5:73:
        -    /// 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:
        -    /// 44:E5`.
        +    /// In this example, the contents of this field would be `14:6D:E9:83:C5:73: 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5`.
             /// 
             /// If these tools are not available to you, you can convert the PEM
             /// certificate into the DER format, compute the SHA-256 hash of that string
        @@ -573,7 +575,9 @@ pub struct WebAsset {
             /// Web assets are identified by a URL that contains only the scheme, hostname
             /// and port parts.  The format is
             /// 
        -    ///     http[s]://[:]
        +    /// ````text
        +    /// http[s]://[:]
        +    /// ````
             /// 
             /// Hostnames must be fully qualified: they must end in a single period
             /// ("`.`").
        @@ -590,19 +594,19 @@ pub struct WebAsset {
             /// Example: the asset with the site `https://www.google.com` contains all
             /// these URLs:
             /// 
        -    ///   *   `https://www.google.com/`
        -    ///   *   `https://www.google.com:443/`
        -    ///   *   `https://www.google.com/foo`
        -    ///   *   `https://www.google.com/foo?bar`
        -    ///   *   `https://www.google.com/foo#bar`
        -    ///   *   `https://user@password:www.google.com/`
        +    /// * `https://www.google.com/`
        +    /// * `https://www.google.com:443/`
        +    /// * `https://www.google.com/foo`
        +    /// * `https://www.google.com/foo?bar`
        +    /// * `https://www.google.com/foo#bar`
        +    /// * `https://user@password:www.google.com/`
             /// 
             /// But it does not contain these URLs:
             /// 
        -    ///   *   `http://www.google.com/`       (wrong scheme)
        -    ///   *   `https://google.com/`          (hostname does not match)
        -    ///   *   `https://www.google.com:444/`  (port does not match)
        -    /// REQUIRED
        +    /// * `http://www.google.com/`       (wrong scheme)
        +    /// * `https://google.com/`          (hostname does not match)
        +    /// * `https://www.google.com:444/`  (port does not match)
        +    ///   REQUIRED
             pub site: Option,
         }
         
        @@ -977,7 +981,9 @@ impl<'a, C, A> AssetlinkCheckCall<'a, C, A> where C: BorrowMut, A
             /// Web assets are identified by a URL that contains only the scheme, hostname
             /// and port parts.  The format is
             /// 
        -    ///     http[s]://[:]
        +    /// ````text
        +    /// http[s]://[:]
        +    /// ````
             /// 
             /// Hostnames must be fully qualified: they must end in a single period
             /// ("`.`").
        @@ -994,19 +1000,19 @@ impl<'a, C, A> AssetlinkCheckCall<'a, C, A> where C: BorrowMut, A
             /// Example: the asset with the site `https://www.google.com` contains all
             /// these URLs:
             /// 
        -    ///   *   `https://www.google.com/`
        -    ///   *   `https://www.google.com:443/`
        -    ///   *   `https://www.google.com/foo`
        -    ///   *   `https://www.google.com/foo?bar`
        -    ///   *   `https://www.google.com/foo#bar`
        -    ///   *   `https://user@password:www.google.com/`
        +    /// * `https://www.google.com/`
        +    /// * `https://www.google.com:443/`
        +    /// * `https://www.google.com/foo`
        +    /// * `https://www.google.com/foo?bar`
        +    /// * `https://www.google.com/foo#bar`
        +    /// * `https://user@password:www.google.com/`
             /// 
             /// But it does not contain these URLs:
             /// 
        -    ///   *   `http://www.google.com/`       (wrong scheme)
        -    ///   *   `https://google.com/`          (hostname does not match)
        -    ///   *   `https://www.google.com:444/`  (port does not match)
        -    /// REQUIRED
        +    /// * `http://www.google.com/`       (wrong scheme)
        +    /// * `https://google.com/`          (hostname does not match)
        +    /// * `https://www.google.com:444/`  (port does not match)
        +    ///   REQUIRED
             ///
             /// Sets the *target.web.site* query property to the given value.
             pub fn target_web_site(mut self, new_value: &str) -> AssetlinkCheckCall<'a, C, A> {
        @@ -1024,21 +1030,23 @@ impl<'a, C, A> AssetlinkCheckCall<'a, C, A> where C: BorrowMut, A
                 self
             }
             /// The uppercase SHA-265 fingerprint of the certificate.  From the PEM
        -    ///  certificate, it can be acquired like this:
        +    /// certificate, it can be acquired like this:
             /// 
        -    ///     $ keytool -printcert -file $CERTFILE | grep SHA256:
        -    ///     SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
        -    ///         42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````text
        +    /// $ keytool -printcert -file $CERTFILE | grep SHA256:
        +    /// SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
        +    ///     42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````
             /// 
             /// or like this:
             /// 
        -    ///     $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
        -    ///     SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
        -    ///         16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````text
        +    /// $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
        +    /// SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
        +    ///     16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````
             /// 
        -    /// In this example, the contents of this field would be `14:6D:E9:83:C5:73:
        -    /// 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:
        -    /// 44:E5`.
        +    /// In this example, the contents of this field would be `14:6D:E9:83:C5:73: 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5`.
             /// 
             /// If these tools are not available to you, you can convert the PEM
             /// certificate into the DER format, compute the SHA-256 hash of that string
        @@ -1053,7 +1061,9 @@ impl<'a, C, A> AssetlinkCheckCall<'a, C, A> where C: BorrowMut, A
             /// Web assets are identified by a URL that contains only the scheme, hostname
             /// and port parts.  The format is
             /// 
        -    ///     http[s]://[:]
        +    /// ````text
        +    /// http[s]://[:]
        +    /// ````
             /// 
             /// Hostnames must be fully qualified: they must end in a single period
             /// ("`.`").
        @@ -1070,19 +1080,19 @@ impl<'a, C, A> AssetlinkCheckCall<'a, C, A> where C: BorrowMut, A
             /// Example: the asset with the site `https://www.google.com` contains all
             /// these URLs:
             /// 
        -    ///   *   `https://www.google.com/`
        -    ///   *   `https://www.google.com:443/`
        -    ///   *   `https://www.google.com/foo`
        -    ///   *   `https://www.google.com/foo?bar`
        -    ///   *   `https://www.google.com/foo#bar`
        -    ///   *   `https://user@password:www.google.com/`
        +    /// * `https://www.google.com/`
        +    /// * `https://www.google.com:443/`
        +    /// * `https://www.google.com/foo`
        +    /// * `https://www.google.com/foo?bar`
        +    /// * `https://www.google.com/foo#bar`
        +    /// * `https://user@password:www.google.com/`
             /// 
             /// But it does not contain these URLs:
             /// 
        -    ///   *   `http://www.google.com/`       (wrong scheme)
        -    ///   *   `https://google.com/`          (hostname does not match)
        -    ///   *   `https://www.google.com:444/`  (port does not match)
        -    /// REQUIRED
        +    /// * `http://www.google.com/`       (wrong scheme)
        +    /// * `https://google.com/`          (hostname does not match)
        +    /// * `https://www.google.com:444/`  (port does not match)
        +    ///   REQUIRED
             ///
             /// Sets the *source.web.site* query property to the given value.
             pub fn source_web_site(mut self, new_value: &str) -> AssetlinkCheckCall<'a, C, A> {
        @@ -1100,21 +1110,23 @@ impl<'a, C, A> AssetlinkCheckCall<'a, C, A> where C: BorrowMut, A
                 self
             }
             /// The uppercase SHA-265 fingerprint of the certificate.  From the PEM
        -    ///  certificate, it can be acquired like this:
        +    /// certificate, it can be acquired like this:
             /// 
        -    ///     $ keytool -printcert -file $CERTFILE | grep SHA256:
        -    ///     SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
        -    ///         42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````text
        +    /// $ keytool -printcert -file $CERTFILE | grep SHA256:
        +    /// SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
        +    ///     42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````
             /// 
             /// or like this:
             /// 
        -    ///     $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
        -    ///     SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
        -    ///         16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````text
        +    /// $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
        +    /// SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
        +    ///     16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````
             /// 
        -    /// In this example, the contents of this field would be `14:6D:E9:83:C5:73:
        -    /// 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:
        -    /// 44:E5`.
        +    /// In this example, the contents of this field would be `14:6D:E9:83:C5:73: 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5`.
             /// 
             /// If these tools are not available to you, you can convert the PEM
             /// certificate into the DER format, compute the SHA-256 hash of that string
        @@ -1369,7 +1381,9 @@ impl<'a, C, A> StatementListCall<'a, C, A> where C: BorrowMut, A:
             /// Web assets are identified by a URL that contains only the scheme, hostname
             /// and port parts.  The format is
             /// 
        -    ///     http[s]://[:]
        +    /// ````text
        +    /// http[s]://[:]
        +    /// ````
             /// 
             /// Hostnames must be fully qualified: they must end in a single period
             /// ("`.`").
        @@ -1386,19 +1400,19 @@ impl<'a, C, A> StatementListCall<'a, C, A> where C: BorrowMut, A:
             /// Example: the asset with the site `https://www.google.com` contains all
             /// these URLs:
             /// 
        -    ///   *   `https://www.google.com/`
        -    ///   *   `https://www.google.com:443/`
        -    ///   *   `https://www.google.com/foo`
        -    ///   *   `https://www.google.com/foo?bar`
        -    ///   *   `https://www.google.com/foo#bar`
        -    ///   *   `https://user@password:www.google.com/`
        +    /// * `https://www.google.com/`
        +    /// * `https://www.google.com:443/`
        +    /// * `https://www.google.com/foo`
        +    /// * `https://www.google.com/foo?bar`
        +    /// * `https://www.google.com/foo#bar`
        +    /// * `https://user@password:www.google.com/`
             /// 
             /// But it does not contain these URLs:
             /// 
        -    ///   *   `http://www.google.com/`       (wrong scheme)
        -    ///   *   `https://google.com/`          (hostname does not match)
        -    ///   *   `https://www.google.com:444/`  (port does not match)
        -    /// REQUIRED
        +    /// * `http://www.google.com/`       (wrong scheme)
        +    /// * `https://google.com/`          (hostname does not match)
        +    /// * `https://www.google.com:444/`  (port does not match)
        +    ///   REQUIRED
             ///
             /// Sets the *source.web.site* query property to the given value.
             pub fn source_web_site(mut self, new_value: &str) -> StatementListCall<'a, C, A> {
        @@ -1416,21 +1430,23 @@ impl<'a, C, A> StatementListCall<'a, C, A> where C: BorrowMut, A:
                 self
             }
             /// The uppercase SHA-265 fingerprint of the certificate.  From the PEM
        -    ///  certificate, it can be acquired like this:
        +    /// certificate, it can be acquired like this:
             /// 
        -    ///     $ keytool -printcert -file $CERTFILE | grep SHA256:
        -    ///     SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
        -    ///         42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````text
        +    /// $ keytool -printcert -file $CERTFILE | grep SHA256:
        +    /// SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
        +    ///     42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````
             /// 
             /// or like this:
             /// 
        -    ///     $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
        -    ///     SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
        -    ///         16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````text
        +    /// $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
        +    /// SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
        +    ///     16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
        +    /// ````
             /// 
        -    /// In this example, the contents of this field would be `14:6D:E9:83:C5:73:
        -    /// 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:
        -    /// 44:E5`.
        +    /// In this example, the contents of this field would be `14:6D:E9:83:C5:73: 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5`.
             /// 
             /// If these tools are not available to you, you can convert the PEM
             /// certificate into the DER format, compute the SHA-256 hash of that string
        @@ -1449,9 +1465,9 @@ impl<'a, C, A> StatementListCall<'a, C, A> where C: BorrowMut, A:
             /// 
             /// For a query to match a statement, one of the following must be true:
             /// 
        -    /// *    both the query's and the statement's relation strings match exactly,
        -    ///      or
        -    /// *    the query's relation string is empty or missing.
        +    /// * both the query's and the statement's relation strings match exactly,
        +    ///   or
        +    /// * the query's relation string is empty or missing.
             /// 
             /// Example: A query with relation `delegate_permission/common.handle_all_urls`
             /// matches an asset link with relation
        diff --git a/gen/dlp2/src/lib.rs b/gen/dlp2/src/lib.rs
        index 80e0fac02c..c37208cdb1 100644
        --- a/gen/dlp2/src/lib.rs
        +++ b/gen/dlp2/src/lib.rs
        @@ -4268,9 +4268,11 @@ impl Part for GooglePrivacyDlpV2TransientCryptoKey {}
         /// empty messages in your APIs. A typical example is to use it as the request
         /// or the response type of an API method. For instance:
         /// 
        -///     service Foo {
        -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        -///     }
        +/// ````text
        +/// service Foo {
        +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        +/// }
        +/// ````
         /// 
         /// The JSON representation for `Empty` is empty JSON object `{}`.
         /// 
        @@ -4288,7 +4290,6 @@ impl Part for GooglePrivacyDlpV2TransientCryptoKey {}
         /// * [deidentify templates delete organizations](struct.OrganizationDeidentifyTemplateDeleteCall.html) (response)
         /// * [dlp jobs delete projects](struct.ProjectDlpJobDeleteCall.html) (response)
         /// * [inspect templates delete organizations](struct.OrganizationInspectTemplateDeleteCall.html) (response)
        -/// 
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct GoogleProtobufEmpty { _never_set: Option }
         
        @@ -14761,18 +14762,18 @@ impl<'a, C, A> ProjectDlpJobListCall<'a, C, A> where C: BorrowMut
             /// 
             /// * Filter expressions are made up of one or more restrictions.
             /// * Restrictions can be combined by `AND` or `OR` logical operators. A
        -    /// sequence of restrictions implicitly uses `AND`.
        +    ///   sequence of restrictions implicitly uses `AND`.
             /// * A restriction has the form of `  `.
             /// * Supported fields/values for inspect jobs:
        -    ///     - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED
        -    ///     - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
        -    ///     - `trigger_name` - The resource name of the trigger that created job.
        -    ///     - 'end_time` - Corresponds to time the job finished.
        -    ///     - 'start_time` - Corresponds to time the job finished.
        +    ///   * `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED
        +    ///   * `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
        +    ///   * `trigger_name` - The resource name of the trigger that created job.
        +    ///   * 'end_time` - Corresponds to time the job finished.
        +    ///   * 'start_time` - Corresponds to time the job finished.
             /// * Supported fields for risk analysis jobs:
        -    ///     - `state` - RUNNING|CANCELED|FINISHED|FAILED
        -    ///     - 'end_time` - Corresponds to time the job finished.
        -    ///     - 'start_time` - Corresponds to time the job finished.
        +    ///   * `state` - RUNNING|CANCELED|FINISHED|FAILED
        +    ///   * 'end_time` - Corresponds to time the job finished.
        +    ///   * 'start_time` - Corresponds to time the job finished.
             /// * The operator must be `=` or `!=`.
             /// 
             /// Examples:
        @@ -14780,7 +14781,7 @@ impl<'a, C, A> ProjectDlpJobListCall<'a, C, A> where C: BorrowMut
             /// * inspected_storage = cloud_storage AND state = done
             /// * inspected_storage = cloud_storage OR inspected_storage = bigquery
             /// * inspected_storage = cloud_storage AND (state = done OR state = canceled)
        -    /// * end_time > \"2017-12-12T00:00:00+00:00\"
        +    /// * end_time > "2017-12-12T00:00:00+00:00"
             /// 
             /// The length of this field should be no more than 500 characters.
             ///
        @@ -17868,14 +17869,14 @@ impl<'a, C, A> ProjectJobTriggerListCall<'a, C, A> where C: BorrowMut  `.
             /// * Supported fields/values for inspect jobs:
        -    ///     - `status` - HEALTHY|PAUSED|CANCELLED
        -    ///     - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
        -    ///     - 'last_run_time` - RFC 3339 formatted timestamp, surrounded by
        +    ///   * `status` - HEALTHY|PAUSED|CANCELLED
        +    ///   * `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
        +    ///   * 'last_run_time` - RFC 3339 formatted timestamp, surrounded by
             ///     quotation marks. Nanoseconds are ignored.
        -    ///     - 'error_count' - Number of errors that have occurred while running.
        +    ///   * 'error_count' - Number of errors that have occurred while running.
             /// * The operator must be `=` or `!=` for status and inspected_storage.
             /// 
             /// Examples:
        @@ -17883,7 +17884,7 @@ impl<'a, C, A> ProjectJobTriggerListCall<'a, C, A> where C: BorrowMut \"2017-12-12T00:00:00+00:00\"
        +    /// * last_run_time > "2017-12-12T00:00:00+00:00"
             /// 
             /// The length of this field should be no more than 500 characters.
             ///
        diff --git a/gen/dlp2_beta1/src/lib.rs b/gen/dlp2_beta1/src/lib.rs
        index 08739d81b9..338963fdde 100644
        --- a/gen/dlp2_beta1/src/lib.rs
        +++ b/gen/dlp2_beta1/src/lib.rs
        @@ -758,8 +758,8 @@ impl Part for GooglePrivacyDlpV2beta1ImageRedactionConfig {}
         /// programming environments, including REST APIs and RPC APIs. It is used by
         /// [gRPC](https://github.com/grpc). The error model is designed to be:
         /// 
        -/// - Simple to use and understand for most users
        -/// - Flexible enough to meet unexpected needs
        +/// * Simple to use and understand for most users
        +/// * Flexible enough to meet unexpected needs
         /// 
         /// # Overview
         /// 
        @@ -789,26 +789,25 @@ impl Part for GooglePrivacyDlpV2beta1ImageRedactionConfig {}
         /// 
         /// Example uses of this error model include:
         /// 
        -/// - Partial errors. If a service needs to return partial errors to the client,
        -///     it may embed the `Status` in the normal response to indicate the partial
        -///     errors.
        +/// * Partial errors. If a service needs to return partial errors to the client,
        +///   it may embed the `Status` in the normal response to indicate the partial
        +///   errors.
         /// 
        -/// - Workflow errors. A typical workflow has multiple steps. Each step may
        -///     have a `Status` message for error reporting.
        +/// * Workflow errors. A typical workflow has multiple steps. Each step may
        +///   have a `Status` message for error reporting.
         /// 
        -/// - Batch operations. If a client uses batch request and batch response, the
        -///     `Status` message should be used directly inside batch response, one for
        -///     each error sub-response.
        +/// * Batch operations. If a client uses batch request and batch response, the
        +///   `Status` message should be used directly inside batch response, one for
        +///   each error sub-response.
         /// 
        -/// - Asynchronous operations. If an API call embeds asynchronous operation
        -///     results in its response, the status of those operations should be
        -///     represented directly using the `Status` message.
        +/// * Asynchronous operations. If an API call embeds asynchronous operation
        +///   results in its response, the status of those operations should be
        +///   represented directly using the `Status` message.
         /// 
        -/// - Logging. If some API errors are stored in logs, the message `Status` could
        -///     be used directly after any stripping needed for security/privacy reasons.
        +/// * Logging. If some API errors are stored in logs, the message `Status` could
        +///   be used directly after any stripping needed for security/privacy reasons.
         /// 
         /// This type is not used in any activity, and only used as *part* of another schema.
        -/// 
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct GoogleRpcStatus {
             /// A developer-facing error message, which should be in English. Any
        @@ -1886,9 +1885,11 @@ impl Part for GooglePrivacyDlpV2beta1QuasiIdField {}
         /// empty messages in your APIs. A typical example is to use it as the request
         /// or the response type of an API method. For instance:
         /// 
        -///     service Foo {
        -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        -///     }
        +/// ````text
        +/// service Foo {
        +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        +/// }
        +/// ````
         /// 
         /// The JSON representation for `Empty` is empty JSON object `{}`.
         /// 
        @@ -1901,7 +1902,6 @@ impl Part for GooglePrivacyDlpV2beta1QuasiIdField {}
         /// * [operations delete inspect](struct.InspectOperationDeleteCall.html) (response)
         /// * [operations cancel risk analysis](struct.RiskAnalysiOperationCancelCall.html) (response)
         /// * [operations delete risk analysis](struct.RiskAnalysiOperationDeleteCall.html) (response)
        -/// 
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct GoogleProtobufEmpty { _never_set: Option }
         
        diff --git a/gen/docs1/src/lib.rs b/gen/docs1/src/lib.rs
        index 6e0e24e2c4..5650be1c59 100644
        --- a/gen/docs1/src/lib.rs
        +++ b/gen/docs1/src/lib.rs
        @@ -1267,21 +1267,20 @@ impl Part for InsertTextRequest {}
         /// Inherited text styles are represented as unset fields in this message. A
         /// text style's parent depends on where the text style is defined:
         /// 
        -///   * The TextStyle of text in a Paragraph
        -///     inherits from the paragraph's corresponding named style type.
        -///   * The TextStyle on a named style
        -///     inherits from the normal text named style.
        -///   * The TextStyle of the normal text named style inherits
        -///     from the default text style in the Docs editor.
        -///   * The TextStyle on a Paragraph element
        -///     that is contained in a table may inherit its text style from the table
        -///     style.
        +/// * The TextStyle of text in a Paragraph
        +///   inherits from the paragraph's corresponding named style type.
        +/// * The TextStyle on a named style
        +///   inherits from the normal text named style.
        +/// * The TextStyle of the normal text named style inherits
        +///   from the default text style in the Docs editor.
        +/// * The TextStyle on a Paragraph element
        +///   that is contained in a table may inherit its text style from the table
        +///   style.
         /// 
         /// If the text style does not inherit from a parent, unsetting fields will
         /// revert the style to a value matching the defaults in the Docs editor.
         /// 
         /// This type is not used in any activity, and only used as *part* of another schema.
        -/// 
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct TextStyle {
             /// The foreground color of the text. If set, the color is either an RGB color
        @@ -2732,21 +2731,20 @@ impl Part for Response {}
         /// Inherited paragraph styles are represented as unset fields in this message.
         /// A paragraph style's parent depends on where the paragraph style is defined:
         /// 
        -///   * The ParagraphStyle on a Paragraph
        -///     inherits from the paragraph's corresponding named style type.
        -///   * The ParagraphStyle on a named style
        -///     inherits from the normal text named style.
        -///   * The ParagraphStyle of the normal text named style inherits
        -///     from the default paragraph style in the Docs editor.
        -///   * The ParagraphStyle on a Paragraph
        -///     element that is contained in a table may inherit its paragraph style from
        -///     the table style.
        +/// * The ParagraphStyle on a Paragraph
        +///   inherits from the paragraph's corresponding named style type.
        +/// * The ParagraphStyle on a named style
        +///   inherits from the normal text named style.
        +/// * The ParagraphStyle of the normal text named style inherits
        +///   from the default paragraph style in the Docs editor.
        +/// * The ParagraphStyle on a Paragraph
        +///   element that is contained in a table may inherit its paragraph style from
        +///   the table style.
         /// 
         /// If the paragraph style does not inherit from a parent, unsetting fields will
         /// revert the style to a value matching the defaults in the Docs editor.
         /// 
         /// This type is not used in any activity, and only used as *part* of another schema.
        -/// 
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct ParagraphStyle {
             /// The spacing mode for the paragraph.
        diff --git a/gen/driveactivity2/src/lib.rs b/gen/driveactivity2/src/lib.rs
        index f479b8afba..f43979c22e 100644
        --- a/gen/driveactivity2/src/lib.rs
        +++ b/gen/driveactivity2/src/lib.rs
        @@ -1116,19 +1116,20 @@ pub struct QueryDriveActivityRequest {
             /// 
             /// Supported fields:
             /// 
        -    ///   - time: Uses numerical operators on date values either in
        -    ///     terms of milliseconds since Jan 1, 1970 or in RFC 3339 format.
        -    ///     Examples:
        -    ///       - time > 1452409200000 AND time <= 1492812924310
        -    ///       - time >= "2016-01-10T01:02:03-05:00"
        -    /// 
        -    ///   - detail.action_detail_case: Uses the "has" operator (:) and
        -    ///     either a singular value or a list of allowed action types enclosed in
        -    ///     parentheses.
        -    ///     Examples:
        -    ///       - detail.action_detail_case: RENAME
        -    ///       - detail.action_detail_case:(CREATE UPLOAD)
        -    ///       - -detail.action_detail_case:MOVE
        +    /// * time: Uses numerical operators on date values either in
        +    ///   terms of milliseconds since Jan 1, 1970 or in RFC 3339 format.
        +    ///   Examples:
        +    ///   
        +    ///   * time > 1452409200000 AND time <= 1492812924310
        +    ///   * time >= "2016-01-10T01:02:03-05:00"
        +    /// * detail.action_detail_case: Uses the "has" operator (:) and
        +    ///   either a singular value or a list of allowed action types enclosed in
        +    ///   parentheses.
        +    ///   Examples:
        +    ///   
        +    ///   * detail.action_detail_case: RENAME
        +    ///   * detail.action_detail_case:(CREATE UPLOAD)
        +    ///   * -detail.action_detail_case:MOVE
             pub filter: Option,
             /// The next_page_token value returned from a previous QueryDriveActivity
             /// request, if any.
        diff --git a/gen/factchecktools1_alpha1/src/lib.rs b/gen/factchecktools1_alpha1/src/lib.rs
        index fefb0964d1..ea00285fdb 100644
        --- a/gen/factchecktools1_alpha1/src/lib.rs
        +++ b/gen/factchecktools1_alpha1/src/lib.rs
        @@ -422,9 +422,11 @@ impl Part for GoogleFactcheckingFactchecktoolsV1alpha1ClaimReviewAuthor {}
         /// empty messages in your APIs. A typical example is to use it as the request
         /// or the response type of an API method. For instance:
         /// 
        -///     service Foo {
        -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        -///     }
        +/// ````text
        +/// service Foo {
        +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        +/// }
        +/// ````
         /// 
         /// The JSON representation for `Empty` is empty JSON object `{}`.
         /// 
        @@ -434,7 +436,6 @@ impl Part for GoogleFactcheckingFactchecktoolsV1alpha1ClaimReviewAuthor {}
         /// The list links the activity name, along with information about where it is used (one of *request* and *response*).
         /// 
         /// * [delete pages](struct.PageDeleteCall.html) (response)
        -/// 
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct GoogleProtobufEmpty { _never_set: Option }
         
        diff --git a/gen/file1/src/lib.rs b/gen/file1/src/lib.rs
        index 9d96276ee9..4088012cfb 100644
        --- a/gen/file1/src/lib.rs
        +++ b/gen/file1/src/lib.rs
        @@ -519,7 +519,8 @@ pub struct Location {
             pub display_name: Option,
             /// Cross-service attributes for the location. For example
             /// 
        -    ///     {"cloud.googleapis.com/region": "us-east1"}
        +    /// ````text
        +    /// {"cloud.googleapis.com/region": "us-east1"}````
             pub labels: Option>,
             /// The canonical id for this location. For example: `"us-east1"`.
             #[serde(rename="locationId")]
        @@ -556,9 +557,11 @@ impl Part for FileShareConfig {}
         /// empty messages in your APIs. A typical example is to use it as the request
         /// or the response type of an API method. For instance:
         /// 
        -///     service Foo {
        -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        -///     }
        +/// ````text
        +/// service Foo {
        +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        +/// }
        +/// ````
         /// 
         /// The JSON representation for `Empty` is empty JSON object `{}`.
         /// 
        @@ -569,7 +572,6 @@ impl Part for FileShareConfig {}
         /// 
         /// * [locations operations delete projects](struct.ProjectLocationOperationDeleteCall.html) (response)
         /// * [locations operations cancel projects](struct.ProjectLocationOperationCancelCall.html) (response)
        -/// 
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct Empty { _never_set: Option }
         
        diff --git a/gen/file1_beta1/src/lib.rs b/gen/file1_beta1/src/lib.rs
        index 72c64a74ee..297beef47e 100644
        --- a/gen/file1_beta1/src/lib.rs
        +++ b/gen/file1_beta1/src/lib.rs
        @@ -519,7 +519,8 @@ pub struct Location {
             pub display_name: Option,
             /// Cross-service attributes for the location. For example
             /// 
        -    ///     {"cloud.googleapis.com/region": "us-east1"}
        +    /// ````text
        +    /// {"cloud.googleapis.com/region": "us-east1"}````
             pub labels: Option>,
             /// The canonical id for this location. For example: `"us-east1"`.
             #[serde(rename="locationId")]
        @@ -556,9 +557,11 @@ impl Part for FileShareConfig {}
         /// empty messages in your APIs. A typical example is to use it as the request
         /// or the response type of an API method. For instance:
         /// 
        -///     service Foo {
        -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        -///     }
        +/// ````text
        +/// service Foo {
        +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        +/// }
        +/// ````
         /// 
         /// The JSON representation for `Empty` is empty JSON object `{}`.
         /// 
        @@ -569,7 +572,6 @@ impl Part for FileShareConfig {}
         /// 
         /// * [locations operations delete projects](struct.ProjectLocationOperationDeleteCall.html) (response)
         /// * [locations operations cancel projects](struct.ProjectLocationOperationCancelCall.html) (response)
        -/// 
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct Empty { _never_set: Option }
         
        diff --git a/gen/firebase1_beta1/src/lib.rs b/gen/firebase1_beta1/src/lib.rs
        index a7d0c06689..e29e02a44f 100644
        --- a/gen/firebase1_beta1/src/lib.rs
        +++ b/gen/firebase1_beta1/src/lib.rs
        @@ -824,9 +824,11 @@ impl Part for FirebaseAppInfo {}
         /// empty messages in your APIs. A typical example is to use it as the request
         /// or the response type of an API method. For instance:
         /// 
        -///     service Foo {
        -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        -///     }
        +/// ````text
        +/// service Foo {
        +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
        +/// }
        +/// ````
         /// 
         /// The JSON representation for `Empty` is empty JSON object `{}`.
         /// 
        @@ -836,7 +838,6 @@ impl Part for FirebaseAppInfo {}
         /// The list links the activity name, along with information about where it is used (one of *request* and *response*).
         /// 
         /// * [android apps sha delete projects](struct.ProjectAndroidAppShaDeleteCall.html) (response)
        -/// 
         #[derive(Default, Clone, Debug, Serialize, Deserialize)]
         pub struct Empty { _never_set: Option }
         
        @@ -1322,6 +1323,7 @@ impl<'a, C, A> AvailableProjectMethods<'a, C, A> {
             /// that are available to have Firebase resources added to them.
             /// 
        ///
        A GCP `Project` will only be returned if: + /// ///
          ///
        1. The caller has sufficient /// [Google IAM](https://cloud.google.com/iam) permissions to call @@ -2316,6 +2318,7 @@ impl<'a, C, A> OperationGetCall<'a, C, A> where C: BorrowMut, A: /// that are available to have Firebase resources added to them. ///
          ///
          A GCP `Project` will only be returned if: +/// ///

            ///
          1. The caller has sufficient /// [Google IAM](https://cloud.google.com/iam) permissions to call diff --git a/gen/firebasedynamiclinks1/src/lib.rs b/gen/firebasedynamiclinks1/src/lib.rs index 11c63ae659..69a5550c98 100644 --- a/gen/firebasedynamiclinks1/src/lib.rs +++ b/gen/firebasedynamiclinks1/src/lib.rs @@ -1306,11 +1306,12 @@ impl<'a, C, A> ManagedShortLinkMethods<'a, C, A> { /// The created short Dynamic Link will not expire. /// /// This differs from CreateShortDynamicLink in the following ways: - /// - The request will also contain a name for the link (non unique name - /// for the front end). - /// - The response must be authenticated with an auth token (generated with - /// the admin service account). - /// - The link will appear in the FDL list of links in the console front end. + /// + /// * The request will also contain a name for the link (non unique name + /// for the front end). + /// * The response must be authenticated with an auth token (generated with + /// the admin service account). + /// * The link will appear in the FDL list of links in the console front end. /// /// The Dynamic Link domain in the request must be owned by requester's /// Firebase project. @@ -2346,11 +2347,12 @@ impl<'a, C, A> MethodReopenAttributionCall<'a, C, A> where C: BorrowMut } diff --git a/gen/firestore1/src/lib.rs b/gen/firestore1/src/lib.rs index cee61bd331..de991c69b8 100644 --- a/gen/firestore1/src/lib.rs +++ b/gen/firestore1/src/lib.rs @@ -1240,7 +1240,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -1391,9 +1392,11 @@ impl ResponseResult for GoogleFirestoreAdminV1ListIndexesResponse {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -1407,7 +1410,6 @@ impl ResponseResult for GoogleFirestoreAdminV1ListIndexesResponse {} /// * [databases operations delete projects](struct.ProjectDatabaseOperationDeleteCall.html) (response) /// * [databases collection groups indexes delete projects](struct.ProjectDatabaseCollectionGroupIndexeDeleteCall.html) (response) /// * [databases documents rollback projects](struct.ProjectDatabaseDocumentRollbackCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -1493,8 +1495,8 @@ impl RequestValue for BatchGetDocumentsRequest {} /// different programming environments, including REST APIs and RPC APIs. It is /// used by [gRPC](https://github.com/grpc). The error model is designed to be: /// -/// - Simple to use and understand for most users -/// - Flexible enough to meet unexpected needs +/// * Simple to use and understand for most users +/// * Flexible enough to meet unexpected needs /// /// # Overview /// @@ -1524,26 +1526,25 @@ impl RequestValue for BatchGetDocumentsRequest {} /// /// Example uses of this error model include: /// -/// - Partial errors. If a service needs to return partial errors to the client, -/// it may embed the `Status` in the normal response to indicate the partial -/// errors. +/// * Partial errors. If a service needs to return partial errors to the client, +/// it may embed the `Status` in the normal response to indicate the partial +/// errors. /// -/// - Workflow errors. A typical workflow has multiple steps. Each step may -/// have a `Status` message for error reporting. +/// * Workflow errors. A typical workflow has multiple steps. Each step may +/// have a `Status` message for error reporting. /// -/// - Batch operations. If a client uses batch request and batch response, the -/// `Status` message should be used directly inside batch response, one for -/// each error sub-response. +/// * Batch operations. If a client uses batch request and batch response, the +/// `Status` message should be used directly inside batch response, one for +/// each error sub-response. /// -/// - Asynchronous operations. If an API call embeds asynchronous operation -/// results in its response, the status of those operations should be -/// represented directly using the `Status` message. +/// * Asynchronous operations. If an API call embeds asynchronous operation +/// results in its response, the status of those operations should be +/// represented directly using the `Status` message. /// -/// - Logging. If some API errors are stored in logs, the message `Status` could -/// be used directly after any stripping needed for security/privacy reasons. +/// * Logging. If some API errors are stored in logs, the message `Status` could +/// be used directly after any stripping needed for security/privacy reasons. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Status { /// A developer-facing error message, which should be in English. Any diff --git a/gen/firestore1_beta1/src/lib.rs b/gen/firestore1_beta1/src/lib.rs index 2440c7a1cc..dc16b781c7 100644 --- a/gen/firestore1_beta1/src/lib.rs +++ b/gen/firestore1_beta1/src/lib.rs @@ -638,8 +638,8 @@ impl ResponseResult for BatchGetDocumentsResponse {} /// different programming environments, including REST APIs and RPC APIs. It is /// used by [gRPC](https://github.com/grpc). The error model is designed to be: /// -/// - Simple to use and understand for most users -/// - Flexible enough to meet unexpected needs +/// * Simple to use and understand for most users +/// * Flexible enough to meet unexpected needs /// /// # Overview /// @@ -669,26 +669,25 @@ impl ResponseResult for BatchGetDocumentsResponse {} /// /// Example uses of this error model include: /// -/// - Partial errors. If a service needs to return partial errors to the client, -/// it may embed the `Status` in the normal response to indicate the partial -/// errors. +/// * Partial errors. If a service needs to return partial errors to the client, +/// it may embed the `Status` in the normal response to indicate the partial +/// errors. /// -/// - Workflow errors. A typical workflow has multiple steps. Each step may -/// have a `Status` message for error reporting. +/// * Workflow errors. A typical workflow has multiple steps. Each step may +/// have a `Status` message for error reporting. /// -/// - Batch operations. If a client uses batch request and batch response, the -/// `Status` message should be used directly inside batch response, one for -/// each error sub-response. +/// * Batch operations. If a client uses batch request and batch response, the +/// `Status` message should be used directly inside batch response, one for +/// each error sub-response. /// -/// - Asynchronous operations. If an API call embeds asynchronous operation -/// results in its response, the status of those operations should be -/// represented directly using the `Status` message. +/// * Asynchronous operations. If an API call embeds asynchronous operation +/// results in its response, the status of those operations should be +/// represented directly using the `Status` message. /// -/// - Logging. If some API errors are stored in logs, the message `Status` could -/// be used directly after any stripping needed for security/privacy reasons. +/// * Logging. If some API errors are stored in logs, the message `Status` could +/// be used directly after any stripping needed for security/privacy reasons. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Status { /// A developer-facing error message, which should be in English. Any @@ -847,9 +846,11 @@ impl Part for CompositeFilter {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -861,7 +862,6 @@ impl Part for CompositeFilter {} /// * [databases documents delete projects](struct.ProjectDatabaseDocumentDeleteCall.html) (response) /// * [databases indexes delete projects](struct.ProjectDatabaseIndexeDeleteCall.html) (response) /// * [databases documents rollback projects](struct.ProjectDatabaseDocumentRollbackCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/genomics1/src/lib.rs b/gen/genomics1/src/lib.rs index 119f2dc411..cb0785f432 100644 --- a/gen/genomics1/src/lib.rs +++ b/gen/genomics1/src/lib.rs @@ -372,9 +372,11 @@ impl<'a, C, A> Genomics /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -384,7 +386,6 @@ impl<'a, C, A> Genomics /// The list links the activity name, along with information about where it is used (one of *request* and *response*). /// /// * [cancel operations](struct.OperationCancelCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/healthcare1_beta1/src/lib.rs b/gen/healthcare1_beta1/src/lib.rs index 818ce113b9..7045ef87a5 100644 --- a/gen/healthcare1_beta1/src/lib.rs +++ b/gen/healthcare1_beta1/src/lib.rs @@ -541,9 +541,11 @@ impl Part for ReplaceWithInfoTypeConfig {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -562,7 +564,6 @@ impl Part for ReplaceWithInfoTypeConfig {} /// * [locations datasets hl7 v2 stores messages delete projects](struct.ProjectLocationDatasetHl7V2StoreMessageDeleteCall.html) (response) /// * [locations datasets fhir stores delete projects](struct.ProjectLocationDatasetFhirStoreDeleteCall.html) (response) /// * [locations datasets hl7 v2 stores delete projects](struct.ProjectLocationDatasetHl7V2StoreDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -1077,7 +1078,6 @@ impl RequestValue for SetIamPolicyRequest {} /// payload formats that can't be represented as JSON, such as raw binary or /// an HTML page. /// -/// /// This message can be used both in streaming and non-streaming API methods in /// the request as well as the response. /// @@ -1087,28 +1087,32 @@ impl RequestValue for SetIamPolicyRequest {} /// /// Example: /// -/// message GetResourceRequest { -/// // A unique request id. -/// string request_id = 1; +/// ````text +/// message GetResourceRequest { +/// // A unique request id. +/// string request_id = 1; /// -/// // The raw HTTP body is bound to this field. -/// google.api.HttpBody http_body = 2; -/// } +/// // The raw HTTP body is bound to this field. +/// google.api.HttpBody http_body = 2; +/// } /// -/// service ResourceService { -/// rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); -/// rpc UpdateResource(google.api.HttpBody) returns -/// (google.protobuf.Empty); -/// } +/// service ResourceService { +/// rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); +/// rpc UpdateResource(google.api.HttpBody) returns +/// (google.protobuf.Empty); +/// } +/// ```` /// /// Example with streaming methods: /// -/// service CaldavService { -/// rpc GetCalendar(stream google.api.HttpBody) -/// returns (stream google.api.HttpBody); -/// rpc UpdateCalendar(stream google.api.HttpBody) -/// returns (stream google.api.HttpBody); -/// } +/// ````text +/// service CaldavService { +/// rpc GetCalendar(stream google.api.HttpBody) +/// returns (stream google.api.HttpBody); +/// rpc UpdateCalendar(stream google.api.HttpBody) +/// returns (stream google.api.HttpBody); +/// } +/// ```` /// /// Use of this type only changes how the request and response bodies are /// handled, all other features will continue to work unchanged. @@ -1149,7 +1153,6 @@ impl RequestValue for SetIamPolicyRequest {} /// * [locations datasets fhir stores fhir read projects](struct.ProjectLocationDatasetFhirStoreFhirReadCall.html) (response) /// * [locations datasets fhir stores fhir capabilities projects](struct.ProjectLocationDatasetFhirStoreFhirCapabilityCall.html) (response) /// * [locations datasets dicom stores store instances projects](struct.ProjectLocationDatasetDicomStoreStoreInstanceCall.html) (request|response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct HttpBody { /// The HTTP Content-Type header value specifying the content type of the body. @@ -1204,7 +1207,8 @@ pub struct Location { pub display_name: Option, /// Cross-service attributes for the location. For example /// - /// {"cloud.googleapis.com/region": "us-east1"} + /// ````text + /// {"cloud.googleapis.com/region": "us-east1"}```` pub labels: Option>, /// The canonical id for this location. For example: `"us-east1"`. #[serde(rename="locationId")] @@ -1223,7 +1227,6 @@ impl ResponseResult for Location {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -1231,37 +1234,40 @@ impl ResponseResult for Location {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -1279,7 +1285,6 @@ impl ResponseResult for Location {} /// * [locations datasets set iam policy projects](struct.ProjectLocationDatasetSetIamPolicyCall.html) (response) /// * [locations datasets fhir stores get iam policy projects](struct.ProjectLocationDatasetFhirStoreGetIamPolicyCall.html) (response) /// * [locations datasets hl7 v2 stores get iam policy projects](struct.ProjectLocationDatasetHl7V2StoreGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. @@ -1316,15 +1321,15 @@ pub struct GoogleCloudHealthcareV1beta1DicomGcsSource { /// content only. The URI must be in the following format: /// `gs://{bucket_id}/{object_id}`. The URI can include wildcards in /// `object_id` and thus identify multiple files. Supported wildcards: - /// '*' to match 0 or more non-separator characters - /// '**' to match 0 or more characters (including separators). Must be used at - /// the end of a path and with no other wildcards in the - /// path. Can also be used with a file extension (such as .dcm), which - /// imports all files with the extension in the specified directory and - /// its sub-directories. For example, - /// `gs://my-bucket/my-directory/**.dcm` imports all files with .dcm - /// extensions in `my-directory/` and its sub-directories. - /// '?' to match 1 character + /// '*' to match 0 or more non-separator characters + /// '**' to match 0 or more characters (including separators). Must be used at + /// the end of a path and with no other wildcards in the + /// path. Can also be used with a file extension (such as .dcm), which + /// imports all files with the extension in the specified directory and + /// its sub-directories. For example, + /// `gs://my-bucket/my-directory/**.dcm` imports all files with .dcm + /// extensions in `my-directory/` and its sub-directories. + /// '?' to match 1 character /// All other URI formats are invalid. /// Files matching the wildcard are expected to contain content only, no /// metadata. @@ -1541,25 +1546,26 @@ impl Part for TextConfig {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -1577,12 +1583,13 @@ impl Part for AuditLogConfig {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -1989,48 +1996,49 @@ impl ResponseResult for ListMessagesResponse {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// The configuration for logging of each type of permission. diff --git a/gen/iam1/src/lib.rs b/gen/iam1/src/lib.rs index 469c0dce61..cd2f220620 100644 --- a/gen/iam1/src/lib.rs +++ b/gen/iam1/src/lib.rs @@ -638,7 +638,6 @@ impl ResponseResult for ListServiceAccountsResponse {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -646,37 +645,40 @@ impl ResponseResult for ListServiceAccountsResponse {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -688,7 +690,6 @@ impl ResponseResult for ListServiceAccountsResponse {} /// /// * [service accounts set iam policy projects](struct.ProjectServiceAccountSetIamPolicyCall.html) (response) /// * [service accounts get iam policy projects](struct.ProjectServiceAccountGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Specifies cloud audit logging configuration for this policy. @@ -770,9 +771,11 @@ impl ResponseResult for UndeleteServiceAccountResponse {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -785,7 +788,6 @@ impl ResponseResult for UndeleteServiceAccountResponse {} /// * [service accounts delete projects](struct.ProjectServiceAccountDeleteCall.html) (response) /// * [service accounts keys delete projects](struct.ProjectServiceAccountKeyDeleteCall.html) (response) /// * [service accounts enable projects](struct.ProjectServiceAccountEnableCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -1041,25 +1043,26 @@ impl Part for LintResult {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -1098,12 +1101,13 @@ impl RequestValue for TestIamPermissionsRequest {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -1479,48 +1483,49 @@ impl ResponseResult for ServiceAccountKey {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct AuditConfig { /// The configuration for logging of each type of permission. diff --git a/gen/iamcredentials1/src/lib.rs b/gen/iamcredentials1/src/lib.rs index 2e5e221271..f212526974 100644 --- a/gen/iamcredentials1/src/lib.rs +++ b/gen/iamcredentials1/src/lib.rs @@ -464,23 +464,24 @@ pub struct GenerateIdentityBindingAccessTokenRequest { /// and must have 'kid' field in the header. /// Supported signing algorithms: RS256 (RS512, ES256, ES512 coming soon). /// Mandatory payload fields (along the lines of RFC 7523, section 3): - /// - iss: issuer of the token. Must provide a discovery document at - /// $iss/.well-known/openid-configuration . The document needs to be - /// formatted according to section 4.2 of the OpenID Connect Discovery - /// 1.0 specification. - /// - iat: Issue time in seconds since epoch. Must be in the past. - /// - exp: Expiration time in seconds since epoch. Must be less than 48 hours - /// after iat. We recommend to create tokens that last shorter than 6 - /// hours to improve security unless business reasons mandate longer - /// expiration times. Shorter token lifetimes are generally more secure - /// since tokens that have been exfiltrated by attackers can be used for - /// a shorter time. you can configure the maximum lifetime of the - /// incoming token in the configuration of the mapper. - /// The resulting Google token will expire within an hour or at "exp", - /// whichever is earlier. - /// - sub: JWT subject, identity asserted in the JWT. - /// - aud: Configured in the mapper policy. By default the service account - /// email. + /// + /// * iss: issuer of the token. Must provide a discovery document at + /// $iss/.well-known/openid-configuration . The document needs to be + /// formatted according to section 4.2 of the OpenID Connect Discovery + /// 1.0 specification. + /// * iat: Issue time in seconds since epoch. Must be in the past. + /// * exp: Expiration time in seconds since epoch. Must be less than 48 hours + /// after iat. We recommend to create tokens that last shorter than 6 + /// hours to improve security unless business reasons mandate longer + /// expiration times. Shorter token lifetimes are generally more secure + /// since tokens that have been exfiltrated by attackers can be used for + /// a shorter time. you can configure the maximum lifetime of the + /// incoming token in the configuration of the mapper. + /// The resulting Google token will expire within an hour or at "exp", + /// whichever is earlier. + /// * sub: JWT subject, identity asserted in the JWT. + /// * aud: Configured in the mapper policy. By default the service account + /// email. /// /// Claims from the incoming token can be transferred into the output token /// accoding to the mapper configuration. The outgoing claim size is limited. @@ -489,20 +490,20 @@ pub struct GenerateIdentityBindingAccessTokenRequest { /// /// Example header: /// { - /// "alg": "RS256", - /// "kid": "92a4265e14ab04d4d228a48d10d4ca31610936f8" + /// "alg": "RS256", + /// "kid": "92a4265e14ab04d4d228a48d10d4ca31610936f8" /// } /// Example payload: /// { - /// "iss": "https://accounts.google.com", - /// "iat": 1517963104, - /// "exp": 1517966704, - /// "aud": - /// "https://iamcredentials.googleapis.com/google.iam.credentials.v1.CloudGaia", - /// "sub": "113475438248934895348", - /// "my_claims": { - /// "additional_claim": "value" - /// } + /// "iss": "https://accounts.google.com", + /// "iat": 1517963104, + /// "exp": 1517966704, + /// "aud": + /// "https://iamcredentials.googleapis.com/google.iam.credentials.v1.CloudGaia", + /// "sub": "113475438248934895348", + /// "my_claims": { + /// "additional_claim": "value" + /// } /// } pub jwt: Option, } diff --git a/gen/iap1/src/lib.rs b/gen/iap1/src/lib.rs index 9326dd70a6..8c59a8cd17 100644 --- a/gen/iap1/src/lib.rs +++ b/gen/iap1/src/lib.rs @@ -469,12 +469,13 @@ impl Part for GetPolicyOptions {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -545,7 +546,6 @@ impl Part for Binding {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -553,37 +553,40 @@ impl Part for Binding {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -595,7 +598,6 @@ impl Part for Binding {} /// /// * [get iam policy](struct.MethodGetIamPolicyCall.html) (response) /// * [set iam policy](struct.MethodSetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Associates a list of `members` to a `role`. diff --git a/gen/iap1_beta1/src/lib.rs b/gen/iap1_beta1/src/lib.rs index 907fd52df4..bba21fea3e 100644 --- a/gen/iap1_beta1/src/lib.rs +++ b/gen/iap1_beta1/src/lib.rs @@ -469,12 +469,13 @@ impl Part for GetPolicyOptions {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Expr { /// An optional description of the expression. This is a longer text which @@ -545,7 +546,6 @@ impl Part for Binding {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -553,37 +553,40 @@ impl Part for Binding {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -595,7 +598,6 @@ impl Part for Binding {} /// /// * [get iam policy](struct.MethodGetIamPolicyCall.html) (response) /// * [set iam policy](struct.MethodSetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Policy { /// Associates a list of `members` to a `role`. diff --git a/gen/jobs3/src/lib.rs b/gen/jobs3/src/lib.rs index 8bbb181436..939a4f0209 100644 --- a/gen/jobs3/src/lib.rs +++ b/gen/jobs3/src/lib.rs @@ -735,9 +735,11 @@ impl RequestValue for BatchDeleteJobsRequest {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -749,7 +751,6 @@ impl RequestValue for BatchDeleteJobsRequest {} /// * [jobs delete projects](struct.ProjectJobDeleteCall.html) (response) /// * [jobs batch delete projects](struct.ProjectJobBatchDeleteCall.html) (response) /// * [companies delete projects](struct.ProjectCompanyDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } diff --git a/gen/logging2/src/lib.rs b/gen/logging2/src/lib.rs index 38b4bf1eeb..784f7999c8 100644 --- a/gen/logging2/src/lib.rs +++ b/gen/logging2/src/lib.rs @@ -585,12 +585,10 @@ impl Part for BucketOptions {} /// An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone": /// { "type": "gce_instance", -/// "labels": { "instance_id": "12345678901234", -/// "zone": "us-central1-a" }} -/// +/// "labels": { "instance_id": "12345678901234", +/// "zone": "us-central1-a" }} /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct MonitoredResource { /// Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Compute Engine VM instances use the labels "project_id", "instance_id", and "zone". @@ -962,9 +960,9 @@ pub struct MetricDescriptor { /// Expression = Component { "." Component } { "/" Component } ; /// /// Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] - /// | Annotation - /// | "1" - /// ; + /// | Annotation + /// | "1" + /// ; /// /// Annotation = "{" NAME "}" ; /// Notes: @@ -1033,8 +1031,8 @@ impl ResponseResult for WriteLogEntriesResponse {} pub struct WriteLogEntriesRequest { /// Optional. A default monitored resource object that is assigned to all log entries in entries that do not specify a value for resource. Example: /// { "type": "gce_instance", - /// "labels": { - /// "zone": "us-central1-a", "instance_id": "00000000000000000000" }} + /// "labels": { + /// "zone": "us-central1-a", "instance_id": "00000000000000000000" }} /// See LogEntry. pub resource: Option, /// Optional. If true, the request should expect normal response, but the entries won't be persisted nor exported. Useful for checking whether the logging API endpoints are working properly before sending valuable data. diff --git a/gen/logging2_beta1/src/lib.rs b/gen/logging2_beta1/src/lib.rs index 498f68c265..b9dafa2daa 100644 --- a/gen/logging2_beta1/src/lib.rs +++ b/gen/logging2_beta1/src/lib.rs @@ -509,12 +509,10 @@ impl Part for BucketOptions {} /// An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone": /// { "type": "gce_instance", -/// "labels": { "instance_id": "12345678901234", -/// "zone": "us-central1-a" }} -/// +/// "labels": { "instance_id": "12345678901234", +/// "zone": "us-central1-a" }} /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct MonitoredResource { /// Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Compute Engine VM instances use the labels "project_id", "instance_id", and "zone". @@ -847,9 +845,9 @@ pub struct MetricDescriptor { /// Expression = Component { "." Component } { "/" Component } ; /// /// Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] - /// | Annotation - /// | "1" - /// ; + /// | Annotation + /// | "1" + /// ; /// /// Annotation = "{" NAME "}" ; /// Notes: @@ -914,8 +912,8 @@ impl ResponseResult for WriteLogEntriesResponse {} pub struct WriteLogEntriesRequest { /// Optional. A default monitored resource object that is assigned to all log entries in entries that do not specify a value for resource. Example: /// { "type": "gce_instance", - /// "labels": { - /// "zone": "us-central1-a", "instance_id": "00000000000000000000" }} + /// "labels": { + /// "zone": "us-central1-a", "instance_id": "00000000000000000000" }} /// See LogEntry. pub resource: Option, /// Optional. If true, the request should expect normal response, but the entries won't be persisted nor exported. Useful for checking whether the logging API endpoints are working properly before sending valuable data. diff --git a/gen/manufacturers1/src/lib.rs b/gen/manufacturers1/src/lib.rs index 7c654408e0..07beabaaea 100644 --- a/gen/manufacturers1/src/lib.rs +++ b/gen/manufacturers1/src/lib.rs @@ -410,13 +410,13 @@ pub struct Product { /// Name in the format `{target_country}:{content_language}:{product_id}`. /// /// `target_country` - The target country of the product as a CLDR territory - /// code (for example, US). + /// code (for example, US). /// /// `content_language` - The content language of the product as a two-letter - /// ISO 639-1 language code (for example, en). + /// ISO 639-1 language code (for example, en). /// /// `product_id` - The ID of the product. For more information, see - /// https://support.google.com/manufacturers/answer/6124116#id. + /// https://support.google.com/manufacturers/answer/6124116#id. pub name: Option, /// Attributes of the product uploaded to the Manufacturer Center. Manually /// edited attributes are taken into account. @@ -740,9 +740,11 @@ impl Part for Price {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -753,7 +755,6 @@ impl Part for Price {} /// /// * [products update accounts](struct.AccountProductUpdateCall.html) (response) /// * [products delete accounts](struct.AccountProductDeleteCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct Empty { _never_set: Option } @@ -1463,13 +1464,13 @@ impl<'a, C, A> AccountProductUpdateCall<'a, C, A> where C: BorrowMut AccountProductDeleteCall<'a, C, A> where C: BorrowMut AccountProductGetCall<'a, C, A> where C: BorrowMut /// Name in the format `{target_country}:{content_language}:{product_id}`. /// /// `target_country` - The target country of the product as a CLDR territory - /// code (for example, US). + /// code (for example, US). /// /// `content_language` - The content language of the product as a two-letter - /// ISO 639-1 language code (for example, en). + /// ISO 639-1 language code (for example, en). /// /// `product_id` - The ID of the product. For more information, see - /// https://support.google.com/manufacturers/answer/6124116#id. + /// https://support.google.com/manufacturers/answer/6124116#id. /// /// Sets the *name* path property to the given value. /// diff --git a/gen/ml1/src/lib.rs b/gen/ml1/src/lib.rs index 549d8f79e3..c8ec3359c4 100644 --- a/gen/ml1/src/lib.rs +++ b/gen/ml1/src/lib.rs @@ -563,7 +563,6 @@ impl Part for GoogleCloudMlV1__HyperparameterOutput {} /// Defines an Identity and Access Management (IAM) policy. It is used to /// specify access control policies for Cloud Platform resources. /// -/// /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of /// `members` to a `role`, where the members can be user accounts, Google groups, /// Google domains, and service accounts. A `role` is a named list of permissions @@ -571,37 +570,40 @@ impl Part for GoogleCloudMlV1__HyperparameterOutput {} /// /// **JSON Example** /// +/// ````text +/// { +/// "bindings": [ /// { -/// "bindings": [ -/// { -/// "role": "roles/owner", -/// "members": [ -/// "user:mike@example.com", -/// "group:admins@example.com", -/// "domain:google.com", -/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" -/// ] -/// }, -/// { -/// "role": "roles/viewer", -/// "members": ["user:sean@example.com"] -/// } +/// "role": "roles/owner", +/// "members": [ +/// "user:mike@example.com", +/// "group:admins@example.com", +/// "domain:google.com", +/// "serviceAccount:my-other-app@appspot.gserviceaccount.com" /// ] +/// }, +/// { +/// "role": "roles/viewer", +/// "members": ["user:sean@example.com"] /// } +/// ] +/// } +/// ```` /// /// **YAML Example** /// -/// bindings: -/// - members: -/// - user:mike@example.com -/// - group:admins@example.com -/// - domain:google.com -/// - serviceAccount:my-other-app@appspot.gserviceaccount.com -/// role: roles/owner -/// - members: -/// - user:sean@example.com -/// role: roles/viewer -/// +/// ````text +/// bindings: +/// - members: +/// - user:mike@example.com +/// - group:admins@example.com +/// - domain:google.com +/// - serviceAccount:my-other-app@appspot.gserviceaccount.com +/// role: roles/owner +/// - members: +/// - user:sean@example.com +/// role: roles/viewer +/// ```` /// /// For a description of IAM and its features, see the /// [IAM developer's guide](https://cloud.google.com/iam/docs). @@ -615,7 +617,6 @@ impl Part for GoogleCloudMlV1__HyperparameterOutput {} /// * [jobs set iam policy projects](struct.ProjectJobSetIamPolicyCall.html) (response) /// * [models get iam policy projects](struct.ProjectModelGetIamPolicyCall.html) (response) /// * [jobs get iam policy projects](struct.ProjectJobGetIamPolicyCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleIamV1__Policy { /// Specifies cloud audit logging configuration for this policy. @@ -646,7 +647,6 @@ impl ResponseResult for GoogleIamV1__Policy {} /// payload formats that can't be represented as JSON, such as raw binary or /// an HTML page. /// -/// /// This message can be used both in streaming and non-streaming API methods in /// the request as well as the response. /// @@ -656,28 +656,32 @@ impl ResponseResult for GoogleIamV1__Policy {} /// /// Example: /// -/// message GetResourceRequest { -/// // A unique request id. -/// string request_id = 1; +/// ````text +/// message GetResourceRequest { +/// // A unique request id. +/// string request_id = 1; /// -/// // The raw HTTP body is bound to this field. -/// google.api.HttpBody http_body = 2; -/// } +/// // The raw HTTP body is bound to this field. +/// google.api.HttpBody http_body = 2; +/// } /// -/// service ResourceService { -/// rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); -/// rpc UpdateResource(google.api.HttpBody) returns -/// (google.protobuf.Empty); -/// } +/// service ResourceService { +/// rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); +/// rpc UpdateResource(google.api.HttpBody) returns +/// (google.protobuf.Empty); +/// } +/// ```` /// /// Example with streaming methods: /// -/// service CaldavService { -/// rpc GetCalendar(stream google.api.HttpBody) -/// returns (stream google.api.HttpBody); -/// rpc UpdateCalendar(stream google.api.HttpBody) -/// returns (stream google.api.HttpBody); -/// } +/// ````text +/// service CaldavService { +/// rpc GetCalendar(stream google.api.HttpBody) +/// returns (stream google.api.HttpBody); +/// rpc UpdateCalendar(stream google.api.HttpBody) +/// returns (stream google.api.HttpBody); +/// } +/// ```` /// /// Use of this type only changes how the request and response bodies are /// handled, all other features will continue to work unchanged. @@ -688,7 +692,6 @@ impl ResponseResult for GoogleIamV1__Policy {} /// The list links the activity name, along with information about where it is used (one of *request* and *response*). /// /// * [predict projects](struct.ProjectPredictCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleApi__HttpBody { /// The HTTP Content-Type header value specifying the content type of the body. @@ -708,9 +711,11 @@ impl ResponseResult for GoogleApi__HttpBody {} /// empty messages in your APIs. A typical example is to use it as the request /// or the response type of an API method. For instance: /// -/// service Foo { -/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); -/// } +/// ````text +/// service Foo { +/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); +/// } +/// ```` /// /// The JSON representation for `Empty` is empty JSON object `{}`. /// @@ -721,7 +726,6 @@ impl ResponseResult for GoogleApi__HttpBody {} /// /// * [jobs cancel projects](struct.ProjectJobCancelCall.html) (response) /// * [operations cancel projects](struct.ProjectOperationCancelCall.html) (response) -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleProtobuf__Empty { _never_set: Option } @@ -898,11 +902,12 @@ pub struct GoogleCloudMlV1__Model { /// See the available regions /// for AI Platform services. /// Note: - /// * No matter where a model is deployed, it can always be accessed by - /// users from anywhere, both for online and batch prediction. - /// * The region for a batch prediction job is set by the region field when - /// submitting the batch prediction job and does not take its value from - /// this field. + /// + /// * No matter where a model is deployed, it can always be accessed by + /// users from anywhere, both for online and batch prediction. + /// * The region for a batch prediction job is set by the region field when + /// submitting the batch prediction job and does not take its value from + /// this field. pub regions: Option>, /// `etag` is used for optimistic concurrency control as a way to help /// prevent simultaneous updates of a model from overwriting each other. @@ -1017,48 +1022,49 @@ impl Part for GoogleCloudMlV1__ParameterSpec {} /// /// Example Policy with multiple AuditConfigs: /// +/// ````text +/// { +/// "audit_configs": [ /// { -/// "audit_configs": [ +/// "service": "allServices" +/// "audit_log_configs": [ /// { -/// "service": "allServices" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// }, -/// { -/// "log_type": "ADMIN_READ", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] /// }, /// { -/// "service": "fooservice.googleapis.com" -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// "exempted_members": [ -/// "user:bar@gmail.com" -/// ] -/// } +/// "log_type": "DATA_WRITE", +/// }, +/// { +/// "log_type": "ADMIN_READ", +/// } +/// ] +/// }, +/// { +/// "service": "fooservice.googleapis.com" +/// "audit_log_configs": [ +/// { +/// "log_type": "DATA_READ", +/// }, +/// { +/// "log_type": "DATA_WRITE", +/// "exempted_members": [ +/// "user:bar@gmail.com" /// ] /// } /// ] /// } +/// ] +/// } +/// ```` /// /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ /// logging. It also exempts foo@gmail.com from DATA_READ logging, and /// bar@gmail.com from DATA_WRITE logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleIamV1__AuditConfig { /// The configuration for logging of each type of permission. @@ -1438,25 +1444,26 @@ impl Part for GoogleCloudMlV1__AcceleratorConfig {} /// Provides the configuration for logging a type of permissions. /// Example: /// +/// ````text +/// { +/// "audit_log_configs": [ /// { -/// "audit_log_configs": [ -/// { -/// "log_type": "DATA_READ", -/// "exempted_members": [ -/// "user:foo@gmail.com" -/// ] -/// }, -/// { -/// "log_type": "DATA_WRITE", -/// } +/// "log_type": "DATA_READ", +/// "exempted_members": [ +/// "user:foo@gmail.com" /// ] +/// }, +/// { +/// "log_type": "DATA_WRITE", /// } +/// ] +/// } +/// ```` /// /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting /// foo@gmail.com from DATA_READ logging. /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleIamV1__AuditLogConfig { /// Specifies the identities that do not cause logging for this type of @@ -1642,12 +1649,13 @@ impl Part for GoogleIamV1__Binding {} /// Represents an expression text. Example: /// -/// title: "User account presence" -/// description: "Determines whether the request has a user account" -/// expression: "size(request.user) > 0" +/// ````text +/// title: "User account presence" +/// description: "Determines whether the request has a user account" +/// expression: "size(request.user) > 0" +/// ```` /// /// This type is not used in any activity, and only used as *part* of another schema. -/// #[derive(Default, Clone, Debug, Serialize, Deserialize)] pub struct GoogleType__Expr { /// An optional description of the expression. This is a longer text which @@ -1967,7 +1975,7 @@ pub struct GoogleCloudMlV1__Version { /// /// The following code sample provides the Predictor interface: /// - /// ```py + /// ````textpy /// class Predictor(object): /// """Interface for constructing custom predictors.""" /// @@ -2003,7 +2011,7 @@ pub struct GoogleCloudMlV1__Version { /// An instance implementing this Predictor class. /// """ /// raise NotImplementedError() - /// ``` + /// ```` /// /// Learn more about [the Predictor interface and custom prediction /// routines](/ml-engine/docs/tensorflow/custom-prediction-routines). @@ -2123,6 +2131,7 @@ pub struct GoogleCloudMlV1__AutoScaling { /// /// You can set `min_nodes` when creating the model version, and you can also /// update `min_nodes` for an existing version: + /// ///

                 /// update_body.json:
                 /// {
            @@ -2131,7 +2140,9 @@ pub struct GoogleCloudMlV1__AutoScaling {
                 ///   }
                 /// }
                 /// 
            + /// /// HTTP request: + /// ///
                 /// PATCH
                 /// https://ml.googleapis.com/v1/{name=projects/*/models/*/versions/*}?update_mask=autoScaling.minNodes
            @@ -4753,12 +4764,12 @@ impl<'a, C, A> ProjectModelPatchCall<'a, C, A> where C: BorrowMut
                 /// default version to "version_1", the `update_mask` parameter would be
                 /// specified as `description`, `default_version.name`, and the `PATCH`
                 /// request body would specify the new value, as follows:
            -    ///     {
            -    ///       "description": "foo",
            -    ///       "defaultVersion": {
            -    ///         "name":"version_1"
            -    ///       }
            -    ///     }
            +    /// {
            +    /// "description": "foo",
            +    /// "defaultVersion": {
            +    /// "name":"version_1"
            +    /// }
            +    /// }
                 /// 
                 /// Currently the supported update masks are `description` and
                 /// `default_version.name`.
            @@ -6400,9 +6411,9 @@ impl<'a, C, A> ProjectModelVersionPatchCall<'a, C, A> where C: BorrowMut ProjectJobPatchCall<'a, C, A> where C: BorrowMut,
                 /// For example, to change the labels of a job, the `update_mask` parameter
                 /// would be specified as `labels`, `etag`, and the
                 /// `PATCH` request body would specify the new value, as follows:
            -    ///     {
            -    ///       "labels": {
            -    ///          "owner": "Google",
            -    ///          "color": "Blue"
            -    ///       }
            -    ///       "etag": "33a64df551425fcc55e4d42a148795d9f25f89d4"
            -    ///     }
            +    /// {
            +    /// "labels": {
            +    /// "owner": "Google",
            +    /// "color": "Blue"
            +    /// }
            +    /// "etag": "33a64df551425fcc55e4d42a148795d9f25f89d4"
            +    /// }
                 /// If `etag` matches the one on the server, the labels of the job will be
                 /// replaced with the given ones, and the server end `etag` will be
                 /// recalculated.
            diff --git a/gen/monitoring3/src/lib.rs b/gen/monitoring3/src/lib.rs
            index 820e2beca8..27d2085219 100644
            --- a/gen/monitoring3/src/lib.rs
            +++ b/gen/monitoring3/src/lib.rs
            @@ -506,12 +506,10 @@ impl Part for BucketOptions {}
             
             /// An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone":
             /// { "type": "gce_instance",
            -///   "labels": { "instance_id": "12345678901234",
            -///               "zone": "us-central1-a" }}
            -/// 
            +/// "labels": { "instance_id": "12345678901234",
            +/// "zone": "us-central1-a" }}
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct MonitoredResource {
                 /// Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Compute Engine VM instances use the labels "project_id", "instance_id", and "zone".
            @@ -1343,9 +1341,9 @@ pub struct MetricDescriptor {
                 /// Expression = Component { "." Component } { "/" Component } ;
                 /// 
                 /// Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
            -    ///           | Annotation
            -    ///           | "1"
            -    ///           ;
            +    /// | Annotation
            +    /// | "1"
            +    /// ;
                 /// 
                 /// Annotation = "{" NAME "}" ;
                 /// Notes:
            @@ -6912,8 +6910,7 @@ impl<'a, C, A> ProjectTimeSeryListCall<'a, C, A> where C: BorrowMut ProjectTimeSeryListCall<'a, C, A> {
            diff --git a/gen/oslogin1/src/lib.rs b/gen/oslogin1/src/lib.rs
            index 2baed50c0d..f6671ba1d5 100644
            --- a/gen/oslogin1/src/lib.rs
            +++ b/gen/oslogin1/src/lib.rs
            @@ -424,9 +424,11 @@ impl ResponseResult for ImportSshPublicKeyResponse {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -437,7 +439,6 @@ impl ResponseResult for ImportSshPublicKeyResponse {}
             /// 
             /// * [ssh public keys delete users](struct.UserSshPublicKeyDeleteCall.html) (response)
             /// * [projects delete users](struct.UserProjectDeleteCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            diff --git a/gen/oslogin1_beta/src/lib.rs b/gen/oslogin1_beta/src/lib.rs
            index df455ffbdf..03183e8824 100644
            --- a/gen/oslogin1_beta/src/lib.rs
            +++ b/gen/oslogin1_beta/src/lib.rs
            @@ -432,9 +432,11 @@ impl ResponseResult for ImportSshPublicKeyResponse {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -445,7 +447,6 @@ impl ResponseResult for ImportSshPublicKeyResponse {}
             /// 
             /// * [ssh public keys delete users](struct.UserSshPublicKeyDeleteCall.html) (response)
             /// * [projects delete users](struct.UserProjectDeleteCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            diff --git a/gen/partners2/src/lib.rs b/gen/partners2/src/lib.rs
            index 116fbf6283..4a72e9f64b 100644
            --- a/gen/partners2/src/lib.rs
            +++ b/gen/partners2/src/lib.rs
            @@ -740,9 +740,11 @@ impl Part for EventData {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -752,7 +754,6 @@ impl Part for EventData {}
             /// The list links the activity name, along with information about where it is used (one of *request* and *response*).
             /// 
             /// * [delete company relation users](struct.UserDeleteCompanyRelationCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            @@ -5969,8 +5970,8 @@ impl<'a, C, A> OfferHistoryListCall<'a, C, A> where C: BorrowMut,
                 /// Comma-separated list of fields to order by, e.g.: "foo,bar,baz".
                 /// Use "foo desc" to sort descending.
                 /// List of valid field names is: name, offer_code, expiration_time, status,
            -    ///     last_modified_time, sender_name, creation_time, country_code,
            -    ///     offer_type.
            +    /// last_modified_time, sender_name, creation_time, country_code,
            +    /// offer_type.
                 ///
                 /// Sets the *order by* query property to the given value.
                 pub fn order_by(mut self, new_value: &str) -> OfferHistoryListCall<'a, C, A> {
            diff --git a/gen/people1/src/lib.rs b/gen/people1/src/lib.rs
            index 573ac92e07..4cb0c33a7b 100644
            --- a/gen/people1/src/lib.rs
            +++ b/gen/people1/src/lib.rs
            @@ -834,9 +834,11 @@ impl Part for Birthday {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -847,7 +849,6 @@ impl Part for Birthday {}
             /// 
             /// * [delete contact groups](struct.ContactGroupDeleteCall.html) (response)
             /// * [delete contact people](struct.PeopleDeleteContactCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            diff --git a/gen/proximitybeacon1_beta1/src/lib.rs b/gen/proximitybeacon1_beta1/src/lib.rs
            index c88a2012a9..fcef68a4fe 100644
            --- a/gen/proximitybeacon1_beta1/src/lib.rs
            +++ b/gen/proximitybeacon1_beta1/src/lib.rs
            @@ -749,9 +749,11 @@ impl Part for BeaconInfo {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -765,7 +767,6 @@ impl Part for BeaconInfo {}
             /// * [attachments delete beacons](struct.BeaconAttachmentDeleteCall.html) (response)
             /// * [deactivate beacons](struct.BeaconDeactivateCall.html) (response)
             /// * [activate beacons](struct.BeaconActivateCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            diff --git a/gen/pubsub1/src/lib.rs b/gen/pubsub1/src/lib.rs
            index b993fd8d70..23c83d1b02 100644
            --- a/gen/pubsub1/src/lib.rs
            +++ b/gen/pubsub1/src/lib.rs
            @@ -589,7 +589,6 @@ impl ResponseResult for ListSnapshotsResponse {}
             /// Defines an Identity and Access Management (IAM) policy. It is used to
             /// specify access control policies for Cloud Platform resources.
             /// 
            -/// 
             /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of
             /// `members` to a `role`, where the members can be user accounts, Google groups,
             /// Google domains, and service accounts. A `role` is a named list of permissions
            @@ -597,37 +596,40 @@ impl ResponseResult for ListSnapshotsResponse {}
             /// 
             /// **JSON Example**
             /// 
            +/// ````text
            +/// {
            +///   "bindings": [
             ///     {
            -///       "bindings": [
            -///         {
            -///           "role": "roles/owner",
            -///           "members": [
            -///             "user:mike@example.com",
            -///             "group:admins@example.com",
            -///             "domain:google.com",
            -///             "serviceAccount:my-other-app@appspot.gserviceaccount.com"
            -///           ]
            -///         },
            -///         {
            -///           "role": "roles/viewer",
            -///           "members": ["user:sean@example.com"]
            -///         }
            +///       "role": "roles/owner",
            +///       "members": [
            +///         "user:mike@example.com",
            +///         "group:admins@example.com",
            +///         "domain:google.com",
            +///         "serviceAccount:my-other-app@appspot.gserviceaccount.com"
             ///       ]
            +///     },
            +///     {
            +///       "role": "roles/viewer",
            +///       "members": ["user:sean@example.com"]
             ///     }
            +///   ]
            +/// }
            +/// ````
             /// 
             /// **YAML Example**
             /// 
            -///     bindings:
            -///     - members:
            -///       - user:mike@example.com
            -///       - group:admins@example.com
            -///       - domain:google.com
            -///       - serviceAccount:my-other-app@appspot.gserviceaccount.com
            -///       role: roles/owner
            -///     - members:
            -///       - user:sean@example.com
            -///       role: roles/viewer
            -/// 
            +/// ````text
            +/// bindings:
            +/// - members:
            +///   - user:mike@example.com
            +///   - group:admins@example.com
            +///   - domain:google.com
            +///   - serviceAccount:my-other-app@appspot.gserviceaccount.com
            +///   role: roles/owner
            +/// - members:
            +///   - user:sean@example.com
            +///   role: roles/viewer
            +/// ````
             /// 
             /// For a description of IAM and its features, see the
             /// [IAM developer's guide](https://cloud.google.com/iam/docs).
            @@ -643,7 +645,6 @@ impl ResponseResult for ListSnapshotsResponse {}
             /// * [topics set iam policy projects](struct.ProjectTopicSetIamPolicyCall.html) (response)
             /// * [subscriptions get iam policy projects](struct.ProjectSubscriptionGetIamPolicyCall.html) (response)
             /// * [subscriptions set iam policy projects](struct.ProjectSubscriptionSetIamPolicyCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Policy {
                 /// Associates a list of `members` to a `role`.
            @@ -740,9 +741,11 @@ impl RequestValue for ModifyPushConfigRequest {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -757,7 +760,6 @@ impl RequestValue for ModifyPushConfigRequest {}
             /// * [snapshots delete projects](struct.ProjectSnapshotDeleteCall.html) (response)
             /// * [subscriptions acknowledge projects](struct.ProjectSubscriptionAcknowledgeCall.html) (response)
             /// * [subscriptions delete projects](struct.ProjectSubscriptionDeleteCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            @@ -1049,12 +1051,13 @@ impl RequestValue for TestIamPermissionsRequest {}
             
             /// Represents an expression text. Example:
             /// 
            -///     title: "User account presence"
            -///     description: "Determines whether the request has a user account"
            -///     expression: "size(request.user) > 0"
            +/// ````text
            +/// title: "User account presence"
            +/// description: "Determines whether the request has a user account"
            +/// expression: "size(request.user) > 0"
            +/// ````
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Expr {
                 /// An optional description of the expression. This is a longer text which
            @@ -1238,12 +1241,12 @@ pub struct CreateSnapshotRequest {
                 pub labels: Option>,
                 /// The subscription whose backlog the snapshot retains.
                 /// Specifically, the created snapshot is guaranteed to retain:
            -    ///  (a) The existing backlog on the subscription. More precisely, this is
            -    ///      defined as the messages in the subscription's backlog that are
            -    ///      unacknowledged upon the successful completion of the
            -    ///      `CreateSnapshot` request; as well as:
            -    ///  (b) Any messages published to the subscription's topic following the
            -    ///      successful completion of the CreateSnapshot request.
            +    /// (a) The existing backlog on the subscription. More precisely, this is
            +    /// defined as the messages in the subscription's backlog that are
            +    /// unacknowledged upon the successful completion of the
            +    /// `CreateSnapshot` request; as well as:
            +    /// (b) Any messages published to the subscription's topic following the
            +    /// successful completion of the CreateSnapshot request.
                 /// Format is `projects/{project}/subscriptions/{sub}`.
                 pub subscription: Option,
             }
            diff --git a/gen/pubsub1_beta2/src/lib.rs b/gen/pubsub1_beta2/src/lib.rs
            index e2ca9aa6b0..2bc8b3acc7 100644
            --- a/gen/pubsub1_beta2/src/lib.rs
            +++ b/gen/pubsub1_beta2/src/lib.rs
            @@ -578,7 +578,6 @@ impl RequestValue for PublishRequest {}
             /// Defines an Identity and Access Management (IAM) policy. It is used to
             /// specify access control policies for Cloud Platform resources.
             /// 
            -/// 
             /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of
             /// `members` to a `role`, where the members can be user accounts, Google groups,
             /// Google domains, and service accounts. A `role` is a named list of permissions
            @@ -586,37 +585,40 @@ impl RequestValue for PublishRequest {}
             /// 
             /// **JSON Example**
             /// 
            +/// ````text
            +/// {
            +///   "bindings": [
             ///     {
            -///       "bindings": [
            -///         {
            -///           "role": "roles/owner",
            -///           "members": [
            -///             "user:mike@example.com",
            -///             "group:admins@example.com",
            -///             "domain:google.com",
            -///             "serviceAccount:my-other-app@appspot.gserviceaccount.com"
            -///           ]
            -///         },
            -///         {
            -///           "role": "roles/viewer",
            -///           "members": ["user:sean@example.com"]
            -///         }
            +///       "role": "roles/owner",
            +///       "members": [
            +///         "user:mike@example.com",
            +///         "group:admins@example.com",
            +///         "domain:google.com",
            +///         "serviceAccount:my-other-app@appspot.gserviceaccount.com"
             ///       ]
            +///     },
            +///     {
            +///       "role": "roles/viewer",
            +///       "members": ["user:sean@example.com"]
             ///     }
            +///   ]
            +/// }
            +/// ````
             /// 
             /// **YAML Example**
             /// 
            -///     bindings:
            -///     - members:
            -///       - user:mike@example.com
            -///       - group:admins@example.com
            -///       - domain:google.com
            -///       - serviceAccount:my-other-app@appspot.gserviceaccount.com
            -///       role: roles/owner
            -///     - members:
            -///       - user:sean@example.com
            -///       role: roles/viewer
            -/// 
            +/// ````text
            +/// bindings:
            +/// - members:
            +///   - user:mike@example.com
            +///   - group:admins@example.com
            +///   - domain:google.com
            +///   - serviceAccount:my-other-app@appspot.gserviceaccount.com
            +///   role: roles/owner
            +/// - members:
            +///   - user:sean@example.com
            +///   role: roles/viewer
            +/// ````
             /// 
             /// For a description of IAM and its features, see the
             /// [IAM developer's guide](https://cloud.google.com/iam/docs).
            @@ -630,7 +632,6 @@ impl RequestValue for PublishRequest {}
             /// * [topics get iam policy projects](struct.ProjectTopicGetIamPolicyCall.html) (response)
             /// * [subscriptions set iam policy projects](struct.ProjectSubscriptionSetIamPolicyCall.html) (response)
             /// * [topics set iam policy projects](struct.ProjectTopicSetIamPolicyCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Policy {
                 /// Associates a list of `members` to a `role`.
            @@ -727,9 +728,11 @@ impl RequestValue for ModifyPushConfigRequest {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -743,7 +746,6 @@ impl RequestValue for ModifyPushConfigRequest {}
             /// * [subscriptions delete projects](struct.ProjectSubscriptionDeleteCall.html) (response)
             /// * [topics delete projects](struct.ProjectTopicDeleteCall.html) (response)
             /// * [subscriptions modify ack deadline projects](struct.ProjectSubscriptionModifyAckDeadlineCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            @@ -910,12 +912,13 @@ impl Part for Binding {}
             
             /// Represents an expression text. Example:
             /// 
            -///     title: "User account presence"
            -///     description: "Determines whether the request has a user account"
            -///     expression: "size(request.user) > 0"
            +/// ````text
            +/// title: "User account presence"
            +/// description: "Determines whether the request has a user account"
            +/// expression: "size(request.user) > 0"
            +/// ````
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Expr {
                 /// An optional description of the expression. This is a longer text which
            diff --git a/gen/redis1/src/lib.rs b/gen/redis1/src/lib.rs
            index 917212884a..aa5c39f21f 100644
            --- a/gen/redis1/src/lib.rs
            +++ b/gen/redis1/src/lib.rs
            @@ -508,7 +508,7 @@ pub struct Instance {
                 pub display_name: Option,
                 /// Required. Unique name of the resource in this scope including project and
                 /// location using the form:
            -    ///     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
            +    /// `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
                 /// 
                 /// Note: Redis instances are managed and addressed at regional level so
                 /// location_id here refers to a GCP region; however, users may choose which
            @@ -590,7 +590,8 @@ pub struct Location {
                 pub display_name: Option,
                 /// Cross-service attributes for the location. For example
                 /// 
            -    ///     {"cloud.googleapis.com/region": "us-east1"}
            +    /// ````text
            +    /// {"cloud.googleapis.com/region": "us-east1"}````
                 pub labels: Option>,
                 /// Resource ID for the region. For example: "us-east1".
                 #[serde(rename="locationId")]
            @@ -708,9 +709,11 @@ impl Part for InputConfig {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -721,7 +724,6 @@ impl Part for InputConfig {}
             /// 
             /// * [locations operations delete projects](struct.ProjectLocationOperationDeleteCall.html) (response)
             /// * [locations operations cancel projects](struct.ProjectLocationOperationCancelCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            @@ -1426,7 +1428,7 @@ impl<'a, C, A> ProjectLocationInstanceImportCall<'a, C, A> where C: BorrowMut ProjectLocationInstanceDeleteCall<'a, C, A> where C: BorrowMut ProjectLocationInstanceExportCall<'a, C, A> where C: BorrowMut ProjectLocationInstanceGetCall<'a, C, A> where C: BorrowMut ProjectLocationInstanceFailoverCall<'a, C, A> where C: BorrowMut<
                     self
                 }
                 /// Required. Redis instance resource name using the form:
            -    ///     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
            +    /// `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
                 /// where `location_id` refers to a GCP region.
                 ///
                 /// Sets the *name* path property to the given value.
            @@ -3285,7 +3287,7 @@ impl<'a, C, A> ProjectLocationInstancePatchCall<'a, C, A> where C: BorrowMut ProjectLocationInstanceCreateCall<'a, C, A> where C: BorrowMut ProjectLocationInstanceListCall<'a, C, A> where C: BorrowMut,
                 /// Cross-service attributes for the location. For example
                 /// 
            -    ///     {"cloud.googleapis.com/region": "us-east1"}
            +    /// ````text
            +    /// {"cloud.googleapis.com/region": "us-east1"}````
                 pub labels: Option>,
                 /// The canonical id for this location. For example: `"us-east1"`.
                 #[serde(rename="locationId")]
            diff --git a/gen/runtimeconfig1/src/lib.rs b/gen/runtimeconfig1/src/lib.rs
            index 6320fd40a5..357a76a78b 100644
            --- a/gen/runtimeconfig1/src/lib.rs
            +++ b/gen/runtimeconfig1/src/lib.rs
            @@ -456,9 +456,11 @@ impl RequestValue for CancelOperationRequest {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -469,7 +471,6 @@ impl RequestValue for CancelOperationRequest {}
             /// 
             /// * [delete operations](struct.OperationDeleteCall.html) (response)
             /// * [cancel operations](struct.OperationCancelCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            diff --git a/gen/runtimeconfig1_beta1/src/lib.rs b/gen/runtimeconfig1_beta1/src/lib.rs
            index 0685187700..a11729361f 100644
            --- a/gen/runtimeconfig1_beta1/src/lib.rs
            +++ b/gen/runtimeconfig1_beta1/src/lib.rs
            @@ -463,7 +463,9 @@ pub struct Waiter {
                 pub done: Option,
                 /// The name of the Waiter resource, in the format:
                 /// 
            -    ///     projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
            +    /// ````text
            +    /// projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]
            +    /// ````
                 /// 
                 /// The `[PROJECT_ID]` must be a valid Google Cloud project ID,
                 /// the `[CONFIG_NAME]` must be a valid RuntimeConfig resource, the
            @@ -498,12 +500,13 @@ impl ResponseResult for Waiter {}
             
             /// Represents an expression text. Example:
             /// 
            -///     title: "User account presence"
            -///     description: "Determines whether the request has a user account"
            -///     expression: "size(request.user) > 0"
            +/// ````text
            +/// title: "User account presence"
            +/// description: "Determines whether the request has a user account"
            +/// expression: "size(request.user) > 0"
            +/// ````
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Expr {
                 /// An optional description of the expression. This is a longer text which
            @@ -556,7 +559,6 @@ impl ResponseResult for ListVariablesResponse {}
             /// Defines an Identity and Access Management (IAM) policy. It is used to
             /// specify access control policies for Cloud Platform resources.
             /// 
            -/// 
             /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of
             /// `members` to a `role`, where the members can be user accounts, Google groups,
             /// Google domains, and service accounts. A `role` is a named list of permissions
            @@ -564,37 +566,40 @@ impl ResponseResult for ListVariablesResponse {}
             /// 
             /// **JSON Example**
             /// 
            +/// ````text
            +/// {
            +///   "bindings": [
             ///     {
            -///       "bindings": [
            -///         {
            -///           "role": "roles/owner",
            -///           "members": [
            -///             "user:mike@example.com",
            -///             "group:admins@example.com",
            -///             "domain:google.com",
            -///             "serviceAccount:my-other-app@appspot.gserviceaccount.com"
            -///           ]
            -///         },
            -///         {
            -///           "role": "roles/viewer",
            -///           "members": ["user:sean@example.com"]
            -///         }
            +///       "role": "roles/owner",
            +///       "members": [
            +///         "user:mike@example.com",
            +///         "group:admins@example.com",
            +///         "domain:google.com",
            +///         "serviceAccount:my-other-app@appspot.gserviceaccount.com"
             ///       ]
            +///     },
            +///     {
            +///       "role": "roles/viewer",
            +///       "members": ["user:sean@example.com"]
             ///     }
            +///   ]
            +/// }
            +/// ````
             /// 
             /// **YAML Example**
             /// 
            -///     bindings:
            -///     - members:
            -///       - user:mike@example.com
            -///       - group:admins@example.com
            -///       - domain:google.com
            -///       - serviceAccount:my-other-app@appspot.gserviceaccount.com
            -///       role: roles/owner
            -///     - members:
            -///       - user:sean@example.com
            -///       role: roles/viewer
            -/// 
            +/// ````text
            +/// bindings:
            +/// - members:
            +///   - user:mike@example.com
            +///   - group:admins@example.com
            +///   - domain:google.com
            +///   - serviceAccount:my-other-app@appspot.gserviceaccount.com
            +///   role: roles/owner
            +/// - members:
            +///   - user:sean@example.com
            +///   role: roles/viewer
            +/// ````
             /// 
             /// For a description of IAM and its features, see the
             /// [IAM developer's guide](https://cloud.google.com/iam/docs).
            @@ -606,7 +611,6 @@ impl ResponseResult for ListVariablesResponse {}
             /// 
             /// * [configs get iam policy projects](struct.ProjectConfigGetIamPolicyCall.html) (response)
             /// * [configs set iam policy projects](struct.ProjectConfigSetIamPolicyCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Policy {
                 /// Associates a list of `members` to a `role`.
            @@ -634,9 +638,11 @@ impl ResponseResult for Policy {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -648,7 +654,6 @@ impl ResponseResult for Policy {}
             /// * [configs waiters delete projects](struct.ProjectConfigWaiterDeleteCall.html) (response)
             /// * [configs variables delete projects](struct.ProjectConfigVariableDeleteCall.html) (response)
             /// * [configs delete projects](struct.ProjectConfigDeleteCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            @@ -775,7 +780,9 @@ pub struct RuntimeConfig {
                 pub description: Option,
                 /// The resource name of a runtime config. The name must have the format:
                 /// 
            -    ///     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
            +    /// ````text
            +    /// projects/[PROJECT_ID]/configs/[CONFIG_NAME]
            +    /// ````
                 /// 
                 /// The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
                 /// arbitrary name that matches the
            @@ -887,7 +894,9 @@ pub struct Variable {
                 pub value: Option,
                 /// The name of the variable resource, in the format:
                 /// 
            -    ///     projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]
            +    /// ````text
            +    /// projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]
            +    /// ````
                 /// 
                 /// The `[PROJECT_ID]` must be a valid project ID, `[CONFIG_NAME]` must be a
                 /// valid RuntimeConfig resource and `[VARIABLE_NAME]` follows Unix file system
            diff --git a/gen/safebrowsing4/src/lib.rs b/gen/safebrowsing4/src/lib.rs
            index 4485fce7a2..7be4b9ad2e 100644
            --- a/gen/safebrowsing4/src/lib.rs
            +++ b/gen/safebrowsing4/src/lib.rs
            @@ -568,9 +568,11 @@ impl Part for RiceDeltaEncoding {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -580,7 +582,6 @@ impl Part for RiceDeltaEncoding {}
             /// The list links the activity name, along with information about where it is used (one of *request* and *response*).
             /// 
             /// * [create threat hits](struct.ThreatHitCreateCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            diff --git a/gen/securitycenter1/src/lib.rs b/gen/securitycenter1/src/lib.rs
            index 1b55a76f43..250235832e 100644
            --- a/gen/securitycenter1/src/lib.rs
            +++ b/gen/securitycenter1/src/lib.rs
            @@ -419,7 +419,6 @@ impl RequestValue for SetIamPolicyRequest {}
             /// Defines an Identity and Access Management (IAM) policy. It is used to
             /// specify access control policies for Cloud Platform resources.
             /// 
            -/// 
             /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of
             /// `members` to a `role`, where the members can be user accounts, Google groups,
             /// Google domains, and service accounts. A `role` is a named list of permissions
            @@ -427,37 +426,40 @@ impl RequestValue for SetIamPolicyRequest {}
             /// 
             /// **JSON Example**
             /// 
            +/// ````text
            +/// {
            +///   "bindings": [
             ///     {
            -///       "bindings": [
            -///         {
            -///           "role": "roles/owner",
            -///           "members": [
            -///             "user:mike@example.com",
            -///             "group:admins@example.com",
            -///             "domain:google.com",
            -///             "serviceAccount:my-other-app@appspot.gserviceaccount.com"
            -///           ]
            -///         },
            -///         {
            -///           "role": "roles/viewer",
            -///           "members": ["user:sean@example.com"]
            -///         }
            +///       "role": "roles/owner",
            +///       "members": [
            +///         "user:mike@example.com",
            +///         "group:admins@example.com",
            +///         "domain:google.com",
            +///         "serviceAccount:my-other-app@appspot.gserviceaccount.com"
             ///       ]
            +///     },
            +///     {
            +///       "role": "roles/viewer",
            +///       "members": ["user:sean@example.com"]
             ///     }
            +///   ]
            +/// }
            +/// ````
             /// 
             /// **YAML Example**
             /// 
            -///     bindings:
            -///     - members:
            -///       - user:mike@example.com
            -///       - group:admins@example.com
            -///       - domain:google.com
            -///       - serviceAccount:my-other-app@appspot.gserviceaccount.com
            -///       role: roles/owner
            -///     - members:
            -///       - user:sean@example.com
            -///       role: roles/viewer
            -/// 
            +/// ````text
            +/// bindings:
            +/// - members:
            +///   - user:mike@example.com
            +///   - group:admins@example.com
            +///   - domain:google.com
            +///   - serviceAccount:my-other-app@appspot.gserviceaccount.com
            +///   role: roles/owner
            +/// - members:
            +///   - user:sean@example.com
            +///   role: roles/viewer
            +/// ````
             /// 
             /// For a description of IAM and its features, see the
             /// [IAM developer's guide](https://cloud.google.com/iam/docs).
            @@ -469,7 +471,6 @@ impl RequestValue for SetIamPolicyRequest {}
             /// 
             /// * [sources get iam policy organizations](struct.OrganizationSourceGetIamPolicyCall.html) (response)
             /// * [sources set iam policy organizations](struct.OrganizationSourceSetIamPolicyCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Policy {
                 /// Specifies cloud audit logging configuration for this policy.
            @@ -609,11 +610,11 @@ pub struct GroupFindingsRequest {
                 /// Possible "state_change" values when compare_duration is specified:
                 /// 
                 /// * "CHANGED":   indicates that the finding was present at the start of
            -    ///                  compare_duration, but changed its state at read_time.
            +    ///   compare_duration, but changed its state at read_time.
                 /// * "UNCHANGED": indicates that the finding was present at the start of
            -    ///                  compare_duration and did not change state at read_time.
            +    ///   compare_duration and did not change state at read_time.
                 /// * "ADDED":     indicates that the finding was not present at the start
            -    ///                  of compare_duration, but was present at read_time.
            +    ///   of compare_duration, but was present at read_time.
                 /// 
                 /// If compare_duration is not specified, then the only possible state_change
                 /// is "UNUSED",  which will be the state_change set for all findings present
            @@ -758,9 +759,11 @@ impl ResponseResult for ListAssetsResponse {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -771,7 +774,6 @@ impl ResponseResult for ListAssetsResponse {}
             /// 
             /// * [operations cancel organizations](struct.OrganizationOperationCancelCall.html) (response)
             /// * [operations delete organizations](struct.OrganizationOperationDeleteCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            @@ -1007,11 +1009,12 @@ pub struct SecurityMarks {
                 pub name: Option,
                 /// Mutable user specified security marks belonging to the parent resource.
                 /// Constraints are as follows:
            -    ///   - Keys and values are treated as case insensitive
            -    ///   - Keys must be between 1 - 256 characters (inclusive)
            -    ///   - Keys must be letters, numbers, underscores, or dashes
            -    ///   - Values have leading and trailing whitespace trimmed, remaining
            -    ///     characters must be between 1 - 4096 characters (inclusive)
            +    /// 
            +    /// * Keys and values are treated as case insensitive
            +    /// * Keys must be between 1 - 256 characters (inclusive)
            +    /// * Keys must be letters, numbers, underscores, or dashes
            +    /// * Values have leading and trailing whitespace trimmed, remaining
            +    ///   characters must be between 1 - 4096 characters (inclusive)
                 pub marks: Option>,
             }
             
            @@ -1022,25 +1025,26 @@ impl ResponseResult for SecurityMarks {}
             /// Provides the configuration for logging a type of permissions.
             /// Example:
             /// 
            +/// ````text
            +/// {
            +///   "audit_log_configs": [
             ///     {
            -///       "audit_log_configs": [
            -///         {
            -///           "log_type": "DATA_READ",
            -///           "exempted_members": [
            -///             "user:foo@gmail.com"
            -///           ]
            -///         },
            -///         {
            -///           "log_type": "DATA_WRITE",
            -///         }
            +///       "log_type": "DATA_READ",
            +///       "exempted_members": [
            +///         "user:foo@gmail.com"
             ///       ]
            +///     },
            +///     {
            +///       "log_type": "DATA_WRITE",
             ///     }
            +///   ]
            +/// }
            +/// ````
             /// 
             /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
             /// foo@gmail.com from DATA_READ logging.
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct AuditLogConfig {
                 /// Specifies the identities that do not cause logging for this type of
            @@ -1098,12 +1102,13 @@ impl RequestValue for TestIamPermissionsRequest {}
             
             /// Represents an expression text. Example:
             /// 
            -///     title: "User account presence"
            -///     description: "Determines whether the request has a user account"
            -///     expression: "size(request.user) > 0"
            +/// ````text
            +/// title: "User account presence"
            +/// description: "Determines whether the request has a user account"
            +/// expression: "size(request.user) > 0"
            +/// ````
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Expr {
                 /// An optional description of the expression. This is a longer text which
            @@ -1232,12 +1237,12 @@ pub struct GroupAssetsRequest {
                 /// Possible "state_change" values when compare_duration is specified:
                 /// 
                 /// * "ADDED":   indicates that the asset was not present at the start of
            -    ///                compare_duration, but present at reference_time.
            +    ///   compare_duration, but present at reference_time.
                 /// * "REMOVED": indicates that the asset was present at the start of
            -    ///                compare_duration, but not present at reference_time.
            +    ///   compare_duration, but not present at reference_time.
                 /// * "ACTIVE":  indicates that the asset was present at both the
            -    ///                start and the end of the time period defined by
            -    ///                compare_duration and reference_time.
            +    ///   start and the end of the time period defined by
            +    ///   compare_duration and reference_time.
                 /// 
                 /// If compare_duration is not specified, then the only possible state_change
                 /// is "UNUSED", which will be the state_change set for all assets present at
            @@ -1444,48 +1449,49 @@ impl Part for Binding {}
             /// 
             /// Example Policy with multiple AuditConfigs:
             /// 
            +/// ````text
            +/// {
            +///   "audit_configs": [
             ///     {
            -///       "audit_configs": [
            +///       "service": "allServices"
            +///       "audit_log_configs": [
             ///         {
            -///           "service": "allServices"
            -///           "audit_log_configs": [
            -///             {
            -///               "log_type": "DATA_READ",
            -///               "exempted_members": [
            -///                 "user:foo@gmail.com"
            -///               ]
            -///             },
            -///             {
            -///               "log_type": "DATA_WRITE",
            -///             },
            -///             {
            -///               "log_type": "ADMIN_READ",
            -///             }
            +///           "log_type": "DATA_READ",
            +///           "exempted_members": [
            +///             "user:foo@gmail.com"
             ///           ]
             ///         },
             ///         {
            -///           "service": "fooservice.googleapis.com"
            -///           "audit_log_configs": [
            -///             {
            -///               "log_type": "DATA_READ",
            -///             },
            -///             {
            -///               "log_type": "DATA_WRITE",
            -///               "exempted_members": [
            -///                 "user:bar@gmail.com"
            -///               ]
            -///             }
            +///           "log_type": "DATA_WRITE",
            +///         },
            +///         {
            +///           "log_type": "ADMIN_READ",
            +///         }
            +///       ]
            +///     },
            +///     {
            +///       "service": "fooservice.googleapis.com"
            +///       "audit_log_configs": [
            +///         {
            +///           "log_type": "DATA_READ",
            +///         },
            +///         {
            +///           "log_type": "DATA_WRITE",
            +///           "exempted_members": [
            +///             "user:bar@gmail.com"
             ///           ]
             ///         }
             ///       ]
             ///     }
            +///   ]
            +/// }
            +/// ````
             /// 
             /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
             /// logging. It also exempts foo@gmail.com from DATA_READ logging, and
             /// bar@gmail.com from DATA_WRITE logging.
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct AuditConfig {
                 /// The configuration for logging of each type of permission.
            @@ -5007,11 +5013,11 @@ impl<'a, C, A> OrganizationSourceFindingListCall<'a, C, A> where C: BorrowMut OrganizationAssetListCall<'a, C, A> where C: BorrowMut 0"
            +/// ````text
            +/// title: "User account presence"
            +/// description: "Determines whether the request has a user account"
            +/// expression: "size(request.user) > 0"
            +/// ````
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct GoogleType__Expr {
                 /// An optional description of the expression. This is a longer text which
            @@ -488,7 +489,6 @@ impl Part for GoogleType__Expr {}
             /// Defines an Identity and Access Management (IAM) policy. It is used to
             /// specify access control policies for Cloud Platform resources.
             /// 
            -/// 
             /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of
             /// `members` to a `role`, where the members can be user accounts, Google groups,
             /// Google domains, and service accounts. A `role` is a named list of permissions
            @@ -496,37 +496,40 @@ impl Part for GoogleType__Expr {}
             /// 
             /// **JSON Example**
             /// 
            +/// ````text
            +/// {
            +///   "bindings": [
             ///     {
            -///       "bindings": [
            -///         {
            -///           "role": "roles/owner",
            -///           "members": [
            -///             "user:mike@example.com",
            -///             "group:admins@example.com",
            -///             "domain:google.com",
            -///             "serviceAccount:my-other-app@appspot.gserviceaccount.com"
            -///           ]
            -///         },
            -///         {
            -///           "role": "roles/viewer",
            -///           "members": ["user:sean@example.com"]
            -///         }
            +///       "role": "roles/owner",
            +///       "members": [
            +///         "user:mike@example.com",
            +///         "group:admins@example.com",
            +///         "domain:google.com",
            +///         "serviceAccount:my-other-app@appspot.gserviceaccount.com"
             ///       ]
            +///     },
            +///     {
            +///       "role": "roles/viewer",
            +///       "members": ["user:sean@example.com"]
             ///     }
            +///   ]
            +/// }
            +/// ````
             /// 
             /// **YAML Example**
             /// 
            -///     bindings:
            -///     - members:
            -///       - user:mike@example.com
            -///       - group:admins@example.com
            -///       - domain:google.com
            -///       - serviceAccount:my-other-app@appspot.gserviceaccount.com
            -///       role: roles/owner
            -///     - members:
            -///       - user:sean@example.com
            -///       role: roles/viewer
            -/// 
            +/// ````text
            +/// bindings:
            +/// - members:
            +///   - user:mike@example.com
            +///   - group:admins@example.com
            +///   - domain:google.com
            +///   - serviceAccount:my-other-app@appspot.gserviceaccount.com
            +///   role: roles/owner
            +/// - members:
            +///   - user:sean@example.com
            +///   role: roles/viewer
            +/// ````
             /// 
             /// For a description of IAM and its features, see the
             /// [IAM developer's guide](https://cloud.google.com/iam/docs).
            @@ -538,7 +541,6 @@ impl Part for GoogleType__Expr {}
             /// 
             /// * [set iam policy](struct.MethodSetIamPolicyCall.html) (response)
             /// * [get iam policy](struct.MethodGetIamPolicyCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct GoogleIamV1__Policy {
                 /// Associates a list of `members` to a `role`.
            diff --git a/gen/sourcerepo1/src/lib.rs b/gen/sourcerepo1/src/lib.rs
            index 40f51ca54f..425c614a49 100644
            --- a/gen/sourcerepo1/src/lib.rs
            +++ b/gen/sourcerepo1/src/lib.rs
            @@ -385,25 +385,26 @@ impl<'a, C, A> CloudSourceRepositories
             /// Provides the configuration for logging a type of permissions.
             /// Example:
             /// 
            +/// ````text
            +/// {
            +///   "audit_log_configs": [
             ///     {
            -///       "audit_log_configs": [
            -///         {
            -///           "log_type": "DATA_READ",
            -///           "exempted_members": [
            -///             "user:foo@gmail.com"
            -///           ]
            -///         },
            -///         {
            -///           "log_type": "DATA_WRITE",
            -///         }
            +///       "log_type": "DATA_READ",
            +///       "exempted_members": [
            +///         "user:foo@gmail.com"
             ///       ]
            +///     },
            +///     {
            +///       "log_type": "DATA_WRITE",
             ///     }
            +///   ]
            +/// }
            +/// ````
             /// 
             /// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
             /// foo@gmail.com from DATA_READ logging.
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct AuditLogConfig {
                 /// Specifies the identities that do not cause logging for this type of
            @@ -470,12 +471,13 @@ impl RequestValue for SetIamPolicyRequest {}
             
             /// Represents an expression text. Example:
             /// 
            -///     title: "User account presence"
            -///     description: "Determines whether the request has a user account"
            -///     expression: "size(request.user) > 0"
            +/// ````text
            +/// title: "User account presence"
            +/// description: "Determines whether the request has a user account"
            +/// expression: "size(request.user) > 0"
            +/// ````
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Expr {
                 /// An optional description of the expression. This is a longer text which
            @@ -527,7 +529,6 @@ impl Part for MirrorConfig {}
             /// Defines an Identity and Access Management (IAM) policy. It is used to
             /// specify access control policies for Cloud Platform resources.
             /// 
            -/// 
             /// A `Policy` consists of a list of `bindings`. A `binding` binds a list of
             /// `members` to a `role`, where the members can be user accounts, Google groups,
             /// Google domains, and service accounts. A `role` is a named list of permissions
            @@ -535,37 +536,40 @@ impl Part for MirrorConfig {}
             /// 
             /// **JSON Example**
             /// 
            +/// ````text
            +/// {
            +///   "bindings": [
             ///     {
            -///       "bindings": [
            -///         {
            -///           "role": "roles/owner",
            -///           "members": [
            -///             "user:mike@example.com",
            -///             "group:admins@example.com",
            -///             "domain:google.com",
            -///             "serviceAccount:my-other-app@appspot.gserviceaccount.com"
            -///           ]
            -///         },
            -///         {
            -///           "role": "roles/viewer",
            -///           "members": ["user:sean@example.com"]
            -///         }
            +///       "role": "roles/owner",
            +///       "members": [
            +///         "user:mike@example.com",
            +///         "group:admins@example.com",
            +///         "domain:google.com",
            +///         "serviceAccount:my-other-app@appspot.gserviceaccount.com"
             ///       ]
            +///     },
            +///     {
            +///       "role": "roles/viewer",
            +///       "members": ["user:sean@example.com"]
             ///     }
            +///   ]
            +/// }
            +/// ````
             /// 
             /// **YAML Example**
             /// 
            -///     bindings:
            -///     - members:
            -///       - user:mike@example.com
            -///       - group:admins@example.com
            -///       - domain:google.com
            -///       - serviceAccount:my-other-app@appspot.gserviceaccount.com
            -///       role: roles/owner
            -///     - members:
            -///       - user:sean@example.com
            -///       role: roles/viewer
            -/// 
            +/// ````text
            +/// bindings:
            +/// - members:
            +///   - user:mike@example.com
            +///   - group:admins@example.com
            +///   - domain:google.com
            +///   - serviceAccount:my-other-app@appspot.gserviceaccount.com
            +///   role: roles/owner
            +/// - members:
            +///   - user:sean@example.com
            +///   role: roles/viewer
            +/// ````
             /// 
             /// For a description of IAM and its features, see the
             /// [IAM developer's guide](https://cloud.google.com/iam/docs).
            @@ -577,7 +581,6 @@ impl Part for MirrorConfig {}
             /// 
             /// * [repos set iam policy projects](struct.ProjectRepoSetIamPolicyCall.html) (response)
             /// * [repos get iam policy projects](struct.ProjectRepoGetIamPolicyCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Policy {
                 /// Specifies cloud audit logging configuration for this policy.
            @@ -631,9 +634,11 @@ impl RequestValue for UpdateRepoRequest {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -643,7 +648,6 @@ impl RequestValue for UpdateRepoRequest {}
             /// The list links the activity name, along with information about where it is used (one of *request* and *response*).
             /// 
             /// * [repos delete projects](struct.ProjectRepoDeleteCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            @@ -828,48 +832,49 @@ impl ResponseResult for Repo {}
             /// 
             /// Example Policy with multiple AuditConfigs:
             /// 
            +/// ````text
            +/// {
            +///   "audit_configs": [
             ///     {
            -///       "audit_configs": [
            +///       "service": "allServices"
            +///       "audit_log_configs": [
             ///         {
            -///           "service": "allServices"
            -///           "audit_log_configs": [
            -///             {
            -///               "log_type": "DATA_READ",
            -///               "exempted_members": [
            -///                 "user:foo@gmail.com"
            -///               ]
            -///             },
            -///             {
            -///               "log_type": "DATA_WRITE",
            -///             },
            -///             {
            -///               "log_type": "ADMIN_READ",
            -///             }
            +///           "log_type": "DATA_READ",
            +///           "exempted_members": [
            +///             "user:foo@gmail.com"
             ///           ]
             ///         },
             ///         {
            -///           "service": "fooservice.googleapis.com"
            -///           "audit_log_configs": [
            -///             {
            -///               "log_type": "DATA_READ",
            -///             },
            -///             {
            -///               "log_type": "DATA_WRITE",
            -///               "exempted_members": [
            -///                 "user:bar@gmail.com"
            -///               ]
            -///             }
            +///           "log_type": "DATA_WRITE",
            +///         },
            +///         {
            +///           "log_type": "ADMIN_READ",
            +///         }
            +///       ]
            +///     },
            +///     {
            +///       "service": "fooservice.googleapis.com"
            +///       "audit_log_configs": [
            +///         {
            +///           "log_type": "DATA_READ",
            +///         },
            +///         {
            +///           "log_type": "DATA_WRITE",
            +///           "exempted_members": [
            +///             "user:bar@gmail.com"
             ///           ]
             ///         }
             ///       ]
             ///     }
            +///   ]
            +/// }
            +/// ````
             /// 
             /// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
             /// logging. It also exempts foo@gmail.com from DATA_READ logging, and
             /// bar@gmail.com from DATA_WRITE logging.
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct AuditConfig {
                 /// The configuration for logging of each type of permission.
            diff --git a/gen/speech1/src/lib.rs b/gen/speech1/src/lib.rs
            index e85a92921f..bb30c6ce4d 100644
            --- a/gen/speech1/src/lib.rs
            +++ b/gen/speech1/src/lib.rs
            @@ -749,6 +749,7 @@ pub struct RecognitionConfig {
                 /// best suited to your domain to get best results. If a model is not
                 /// explicitly specified, then we auto-select a model based on the parameters
                 /// in the RecognitionConfig.
            +    /// 
                 /// 
                 ///   
                 ///     
            diff --git a/gen/speech1_beta1/src/lib.rs b/gen/speech1_beta1/src/lib.rs
            index 0b0dce3a7a..b33f21fe35 100644
            --- a/gen/speech1_beta1/src/lib.rs
            +++ b/gen/speech1_beta1/src/lib.rs
            @@ -375,8 +375,8 @@ impl<'a, C, A> Speech
             /// programming environments, including REST APIs and RPC APIs. It is used by
             /// [gRPC](https://github.com/grpc). The error model is designed to be:
             /// 
            -/// - Simple to use and understand for most users
            -/// - Flexible enough to meet unexpected needs
            +/// * Simple to use and understand for most users
            +/// * Flexible enough to meet unexpected needs
             /// 
             /// # Overview
             /// 
            @@ -406,26 +406,25 @@ impl<'a, C, A> Speech
             /// 
             /// Example uses of this error model include:
             /// 
            -/// - Partial errors. If a service needs to return partial errors to the client,
            -///     it may embed the `Status` in the normal response to indicate the partial
            -///     errors.
            +/// * Partial errors. If a service needs to return partial errors to the client,
            +///   it may embed the `Status` in the normal response to indicate the partial
            +///   errors.
             /// 
            -/// - Workflow errors. A typical workflow has multiple steps. Each step may
            -///     have a `Status` message for error reporting.
            +/// * Workflow errors. A typical workflow has multiple steps. Each step may
            +///   have a `Status` message for error reporting.
             /// 
            -/// - Batch operations. If a client uses batch request and batch response, the
            -///     `Status` message should be used directly inside batch response, one for
            -///     each error sub-response.
            +/// * Batch operations. If a client uses batch request and batch response, the
            +///   `Status` message should be used directly inside batch response, one for
            +///   each error sub-response.
             /// 
            -/// - Asynchronous operations. If an API call embeds asynchronous operation
            -///     results in its response, the status of those operations should be
            -///     represented directly using the `Status` message.
            +/// * Asynchronous operations. If an API call embeds asynchronous operation
            +///   results in its response, the status of those operations should be
            +///   represented directly using the `Status` message.
             /// 
            -/// - Logging. If some API errors are stored in logs, the message `Status` could
            -///     be used directly after any stripping needed for security/privacy reasons.
            +/// * Logging. If some API errors are stored in logs, the message `Status` could
            +///   be used directly after any stripping needed for security/privacy reasons.
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Status {
                 /// A developer-facing error message, which should be in English. Any
            diff --git a/gen/storagetransfer1/src/lib.rs b/gen/storagetransfer1/src/lib.rs
            index 04cd67c309..0a18ffe3d9 100644
            --- a/gen/storagetransfer1/src/lib.rs
            +++ b/gen/storagetransfer1/src/lib.rs
            @@ -472,29 +472,29 @@ pub struct ObjectConditions {
                 /// 
                 /// Requirements:
                 /// 
            -    ///   * Each include-prefix and exclude-prefix can contain any sequence of
            -    ///     Unicode characters, of max length 1024 bytes when UTF8-encoded, and
            -    ///     must not contain Carriage Return or Line Feed characters.  Wildcard
            -    ///     matching and regular expression matching are not supported.
            +    /// * Each include-prefix and exclude-prefix can contain any sequence of
            +    ///   Unicode characters, of max length 1024 bytes when UTF8-encoded, and
            +    ///   must not contain Carriage Return or Line Feed characters.  Wildcard
            +    ///   matching and regular expression matching are not supported.
                 /// 
            -    ///   * Each include-prefix and exclude-prefix must omit the leading slash.
            -    ///     For example, to include the `requests.gz` object in a transfer from
            -    ///     `s3://my-aws-bucket/logs/y=2015/requests.gz`, specify the include
            -    ///     prefix as `logs/y=2015/requests.gz`.
            +    /// * Each include-prefix and exclude-prefix must omit the leading slash.
            +    ///   For example, to include the `requests.gz` object in a transfer from
            +    ///   `s3://my-aws-bucket/logs/y=2015/requests.gz`, specify the include
            +    ///   prefix as `logs/y=2015/requests.gz`.
                 /// 
            -    ///   * None of the include-prefix or the exclude-prefix values can be empty,
            -    ///     if specified.
            +    /// * None of the include-prefix or the exclude-prefix values can be empty,
            +    ///   if specified.
                 /// 
            -    ///   * Each include-prefix must include a distinct portion of the object
            -    ///     namespace, i.e., no include-prefix may be a prefix of another
            -    ///     include-prefix.
            +    /// * Each include-prefix must include a distinct portion of the object
            +    ///   namespace, i.e., no include-prefix may be a prefix of another
            +    ///   include-prefix.
                 /// 
            -    ///   * Each exclude-prefix must exclude a distinct portion of the object
            -    ///     namespace, i.e., no exclude-prefix may be a prefix of another
            -    ///     exclude-prefix.
            +    /// * Each exclude-prefix must exclude a distinct portion of the object
            +    ///   namespace, i.e., no exclude-prefix may be a prefix of another
            +    ///   exclude-prefix.
                 /// 
            -    ///   * If `includePrefixes` is specified, then each exclude-prefix must start
            -    ///     with the value of a path explicitly included by `includePrefixes`.
            +    /// * If `includePrefixes` is specified, then each exclude-prefix must start
            +    ///   with the value of a path explicitly included by `includePrefixes`.
                 /// 
                 /// The max size of `includePrefixes` is 1000.
                 #[serde(rename="includePrefixes")]
            @@ -774,9 +774,11 @@ impl Part for TimeOfDay {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -789,7 +791,6 @@ impl Part for TimeOfDay {}
             /// * [cancel transfer operations](struct.TransferOperationCancelCall.html) (response)
             /// * [delete transfer operations](struct.TransferOperationDeleteCall.html) (response)
             /// * [resume transfer operations](struct.TransferOperationResumeCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            diff --git a/gen/testing1/src/lib.rs b/gen/testing1/src/lib.rs
            index 6af9fd7b52..bcd02bc078 100644
            --- a/gen/testing1/src/lib.rs
            +++ b/gen/testing1/src/lib.rs
            @@ -2030,9 +2030,9 @@ impl<'a, C, A> ProjectMethods<'a, C, A> {
                 /// 
                 /// May return any of the following canonical error codes:
                 /// 
            -    /// - PERMISSION_DENIED - if the user is not authorized to write to project
            -    /// - INVALID_ARGUMENT - if the request is malformed or if the matrix expands
            -    ///                      to more than 200 supported executions
            +    /// * PERMISSION_DENIED - if the user is not authorized to write to project
            +    /// * INVALID_ARGUMENT - if the request is malformed or if the matrix expands
            +    ///   to more than 200 supported executions
                 /// 
                 /// # Arguments
                 ///
            @@ -2621,9 +2621,9 @@ impl<'a, C, A> ApplicationDetailServiceGetApkDetailCall<'a, C, A> where C: Borro
             /// 
             /// May return any of the following canonical error codes:
             /// 
            -/// - PERMISSION_DENIED - if the user is not authorized to write to project
            -/// - INVALID_ARGUMENT - if the request is malformed or if the matrix expands
            -///                      to more than 200 supported executions
            +/// * PERMISSION_DENIED - if the user is not authorized to write to project
            +/// * INVALID_ARGUMENT - if the request is malformed or if the matrix expands
            +///   to more than 200 supported executions
             ///
             /// A builder for the *testMatrices.create* method supported by a *project* resource.
             /// It is not used directly, but through a `ProjectMethods` instance.
            diff --git a/gen/tpu1/src/lib.rs b/gen/tpu1/src/lib.rs
            index 5031484bf7..2f3d8dc6de 100644
            --- a/gen/tpu1/src/lib.rs
            +++ b/gen/tpu1/src/lib.rs
            @@ -535,7 +535,8 @@ pub struct Location {
                 pub display_name: Option,
                 /// Cross-service attributes for the location. For example
                 /// 
            -    ///     {"cloud.googleapis.com/region": "us-east1"}
            +    /// ````text
            +    /// {"cloud.googleapis.com/region": "us-east1"}````
                 pub labels: Option>,
                 /// The canonical id for this location. For example: `"us-east1"`.
                 #[serde(rename="locationId")]
            @@ -599,9 +600,11 @@ impl ResponseResult for AcceleratorType {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -612,7 +615,6 @@ impl ResponseResult for AcceleratorType {}
             /// 
             /// * [locations operations delete projects](struct.ProjectLocationOperationDeleteCall.html) (response)
             /// * [locations operations cancel projects](struct.ProjectLocationOperationCancelCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            diff --git a/gen/tpu1_alpha1/src/lib.rs b/gen/tpu1_alpha1/src/lib.rs
            index 6f78a6a9e7..e090fe47b7 100644
            --- a/gen/tpu1_alpha1/src/lib.rs
            +++ b/gen/tpu1_alpha1/src/lib.rs
            @@ -535,7 +535,8 @@ pub struct Location {
                 pub display_name: Option,
                 /// Cross-service attributes for the location. For example
                 /// 
            -    ///     {"cloud.googleapis.com/region": "us-east1"}
            +    /// ````text
            +    /// {"cloud.googleapis.com/region": "us-east1"}````
                 pub labels: Option>,
                 /// The canonical id for this location. For example: `"us-east1"`.
                 #[serde(rename="locationId")]
            @@ -599,9 +600,11 @@ impl ResponseResult for AcceleratorType {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -612,7 +615,6 @@ impl ResponseResult for AcceleratorType {}
             /// 
             /// * [locations operations delete projects](struct.ProjectLocationOperationDeleteCall.html) (response)
             /// * [locations operations cancel projects](struct.ProjectLocationOperationCancelCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            diff --git a/gen/vault1/src/lib.rs b/gen/vault1/src/lib.rs
            index 775b5a58c3..03e4149676 100644
            --- a/gen/vault1/src/lib.rs
            +++ b/gen/vault1/src/lib.rs
            @@ -676,9 +676,11 @@ impl Part for CloudStorageFile {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -692,7 +694,6 @@ impl Part for CloudStorageFile {}
             /// * [saved queries delete matters](struct.MatterSavedQueryDeleteCall.html) (response)
             /// * [exports delete matters](struct.MatterExportDeleteCall.html) (response)
             /// * [remove permissions matters](struct.MatterRemovePermissionCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            diff --git a/gen/videointelligence1/src/lib.rs b/gen/videointelligence1/src/lib.rs
            index 136a64319a..9452ac8909 100644
            --- a/gen/videointelligence1/src/lib.rs
            +++ b/gen/videointelligence1/src/lib.rs
            @@ -387,9 +387,11 @@ impl<'a, C, A> CloudVideoIntelligence
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -404,7 +406,6 @@ impl<'a, C, A> CloudVideoIntelligence
             /// * [projects locations operations cancel operations](struct.OperationProjectLocationOperationCancelCall.html) (response)
             /// * [projects locations operations delete operations](struct.OperationProjectLocationOperationDeleteCall.html) (response)
             /// * [cancel operations](struct.OperationCancelCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct GoogleProtobuf_Empty { _never_set: Option }
             
            diff --git a/gen/videointelligence1_beta1/src/lib.rs b/gen/videointelligence1_beta1/src/lib.rs
            index 244b260ee9..ba3114e629 100644
            --- a/gen/videointelligence1_beta1/src/lib.rs
            +++ b/gen/videointelligence1_beta1/src/lib.rs
            @@ -422,8 +422,8 @@ impl RequestValue for GoogleCloudVideointelligenceV1beta1_AnnotateVideoRequest {
             /// programming environments, including REST APIs and RPC APIs. It is used by
             /// [gRPC](https://github.com/grpc). The error model is designed to be:
             /// 
            -/// - Simple to use and understand for most users
            -/// - Flexible enough to meet unexpected needs
            +/// * Simple to use and understand for most users
            +/// * Flexible enough to meet unexpected needs
             /// 
             /// # Overview
             /// 
            @@ -453,26 +453,25 @@ impl RequestValue for GoogleCloudVideointelligenceV1beta1_AnnotateVideoRequest {
             /// 
             /// Example uses of this error model include:
             /// 
            -/// - Partial errors. If a service needs to return partial errors to the client,
            -///     it may embed the `Status` in the normal response to indicate the partial
            -///     errors.
            +/// * Partial errors. If a service needs to return partial errors to the client,
            +///   it may embed the `Status` in the normal response to indicate the partial
            +///   errors.
             /// 
            -/// - Workflow errors. A typical workflow has multiple steps. Each step may
            -///     have a `Status` message for error reporting.
            +/// * Workflow errors. A typical workflow has multiple steps. Each step may
            +///   have a `Status` message for error reporting.
             /// 
            -/// - Batch operations. If a client uses batch request and batch response, the
            -///     `Status` message should be used directly inside batch response, one for
            -///     each error sub-response.
            +/// * Batch operations. If a client uses batch request and batch response, the
            +///   `Status` message should be used directly inside batch response, one for
            +///   each error sub-response.
             /// 
            -/// - Asynchronous operations. If an API call embeds asynchronous operation
            -///     results in its response, the status of those operations should be
            -///     represented directly using the `Status` message.
            +/// * Asynchronous operations. If an API call embeds asynchronous operation
            +///   results in its response, the status of those operations should be
            +///   represented directly using the `Status` message.
             /// 
            -/// - Logging. If some API errors are stored in logs, the message `Status` could
            -///     be used directly after any stripping needed for security/privacy reasons.
            +/// * Logging. If some API errors are stored in logs, the message `Status` could
            +///   be used directly after any stripping needed for security/privacy reasons.
             /// 
             /// This type is not used in any activity, and only used as *part* of another schema.
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct GoogleRpc_Status {
                 /// A developer-facing error message, which should be in English. Any
            diff --git a/gen/youtubereporting1/src/lib.rs b/gen/youtubereporting1/src/lib.rs
            index 1fbd399623..05c2883862 100644
            --- a/gen/youtubereporting1/src/lib.rs
            +++ b/gen/youtubereporting1/src/lib.rs
            @@ -566,9 +566,11 @@ impl Resource for ReportType {}
             /// empty messages in your APIs. A typical example is to use it as the request
             /// or the response type of an API method. For instance:
             /// 
            -///     service Foo {
            -///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            -///     }
            +/// ````text
            +/// service Foo {
            +///   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
            +/// }
            +/// ````
             /// 
             /// The JSON representation for `Empty` is empty JSON object `{}`.
             /// 
            @@ -578,7 +580,6 @@ impl Resource for ReportType {}
             /// The list links the activity name, along with information about where it is used (one of *request* and *response*).
             /// 
             /// * [delete jobs](struct.JobDeleteCall.html) (response)
            -/// 
             #[derive(Default, Clone, Debug, Serialize, Deserialize)]
             pub struct Empty { _never_set: Option }
             
            
            Model