google-api-client 0.28.4 → 0.28.5

data/generated/google/apis/serviceusage_v1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/service-usage/
     module ServiceusageV1
       VERSION = 'V1'
-      REVISION = '20190115'
+      REVISION = '20190306'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/serviceusage_v1/classes.rb

@@ -103,8 +103,8 @@ module Google
       end
       
       # Configuration for an anthentication provider, including support for
-      # [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-
-      # token-32).
+      # [JSON Web Token
+      # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
       class AuthProvider
         include Google::Apis::Core::Hashable
       
@@ -148,15 +148,16 @@ module Google
         attr_accessor :issuer
       
         # URL of the provider's public key set to validate signature of the JWT. See
-        # [OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#
+        # [OpenID
+        # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#
         # ProviderMetadata).
         # Optional if the key set document:
         # - can be retrieved from
-        # [OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.
-        # html
-        # of the issuer.
-        # - can be inferred from the email domain of the issuer (e.g. a Google service
-        # account).
+        # [OpenID
+        # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
+        # the issuer.
+        # - can be inferred from the email domain of the issuer (e.g. a Google
+        # service account).
         # Example: https://www.googleapis.com/oauth2/v1/certs
         # Corresponds to the JSON property `jwksUri`
         # @return [String]
@@ -177,8 +178,8 @@ module Google
       end
       
       # User-defined authentication requirements, including support for
-      # [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-
-      # token-32).
+      # [JSON Web Token
+      # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
       class AuthRequirement
         include Google::Apis::Core::Hashable
       
@@ -913,8 +914,8 @@ module Google
       class DocumentationRule
         include Google::Apis::Core::Hashable
       
-        # Deprecation description of the selected element(s). It can be provided if an
-        # element is marked as `deprecated`.
+        # Deprecation description of the selected element(s). It can be provided if
+        # an element is marked as `deprecated`.
         # Corresponds to the JSON property `deprecationDescription`
         # @return [String]
         attr_accessor :deprecation_description
@@ -1071,10 +1072,10 @@ module Google
         attr_accessor :name
       
         # The specification of an Internet routable address of API frontend that will
-        # handle requests to this [API Endpoint](https://cloud.google.com/apis/design/
-        # glossary).
-        # It should be either a valid IPv4 address or a fully-qualified domain name.
-        # For example, "8.8.8.8" or "myservice.appspot.com".
+        # handle requests to this [API
+        # Endpoint](https://cloud.google.com/apis/design/glossary). It should be
+        # either a valid IPv4 address or a fully-qualified domain name. For example,
+        # "8.8.8.8" or "myservice.appspot.com".
         # Corresponds to the JSON property `target`
         # @return [String]
         attr_accessor :target
@@ -1596,46 +1597,7 @@ module Google
         # @return [String]
         attr_accessor :producer_project_id
       
-        # Quota configuration helps to achieve fairness and budgeting in service
-        # usage.
-        # The quota configuration works this way:
-        # - The service configuration defines a set of metrics.
-        # - For API calls, the quota.metric_rules maps methods to metrics with
-        # corresponding costs.
-        # - The quota.limits defines limits on the metrics, which will be used for
-        # quota checks at runtime.
-        # An example quota configuration in yaml format:
-        # quota:
-        # limits:
-        # - name: apiWriteQpsPerProject
-        # metric: library.googleapis.com/write_calls
-        # unit: "1/min/`project`"  # rate limit for consumer projects
-        # values:
-        # STANDARD: 10000
-        # # The metric rules bind all methods to the read_calls metric,
-        # # except for the UpdateBook and DeleteBook methods. These two methods
-        # # are mapped to the write_calls metric, with the UpdateBook method
-        # # consuming at twice rate as the DeleteBook method.
-        # metric_rules:
-        # - selector: "*"
-        # metric_costs:
-        # library.googleapis.com/read_calls: 1
-        # - selector: google.example.library.v1.LibraryService.UpdateBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 2
-        # - selector: google.example.library.v1.LibraryService.DeleteBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 1
-        # Corresponding Metric definition:
-        # metrics:
-        # - name: library.googleapis.com/read_calls
-        # display_name: Read requests
-        # metric_kind: DELTA
-        # value_type: INT64
-        # - name: library.googleapis.com/write_calls
-        # display_name: Write requests
-        # metric_kind: DELTA
-        # value_type: INT64
+        # Quota configuration.
         # Corresponds to the JSON property `quota`
         # @return [Google::Apis::ServiceusageV1::Quota]
         attr_accessor :quota
@@ -1875,46 +1837,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Quota configuration helps to achieve fairness and budgeting in service
-        # usage.
-        # The quota configuration works this way:
-        # - The service configuration defines a set of metrics.
-        # - For API calls, the quota.metric_rules maps methods to metrics with
-        # corresponding costs.
-        # - The quota.limits defines limits on the metrics, which will be used for
-        # quota checks at runtime.
-        # An example quota configuration in yaml format:
-        # quota:
-        # limits:
-        # - name: apiWriteQpsPerProject
-        # metric: library.googleapis.com/write_calls
-        # unit: "1/min/`project`"  # rate limit for consumer projects
-        # values:
-        # STANDARD: 10000
-        # # The metric rules bind all methods to the read_calls metric,
-        # # except for the UpdateBook and DeleteBook methods. These two methods
-        # # are mapped to the write_calls metric, with the UpdateBook method
-        # # consuming at twice rate as the DeleteBook method.
-        # metric_rules:
-        # - selector: "*"
-        # metric_costs:
-        # library.googleapis.com/read_calls: 1
-        # - selector: google.example.library.v1.LibraryService.UpdateBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 2
-        # - selector: google.example.library.v1.LibraryService.DeleteBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 1
-        # Corresponding Metric definition:
-        # metrics:
-        # - name: library.googleapis.com/read_calls
-        # display_name: Read requests
-        # metric_kind: DELTA
-        # value_type: INT64
-        # - name: library.googleapis.com/write_calls
-        # display_name: Write requests
-        # metric_kind: DELTA
-        # value_type: INT64
+        # Quota configuration.
         # Corresponds to the JSON property `quota`
         # @return [Google::Apis::ServiceusageV1::Quota]
         attr_accessor :quota
@@ -1952,7 +1875,7 @@ module Google
       class Http
         include Google::Apis::Core::Hashable
       
-        # When set to true, URL path parmeters will be fully URI-decoded except in
+        # When set to true, URL path parameters will be fully URI-decoded except in
         # cases of single segment matches in reserved expansion, where "%2F" will be
         # left encoded.
         # The default behavior is to not decode RFC 6570 reserved characters in multi
@@ -3058,14 +2981,14 @@ module Google
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for 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:
+        # The `Status` type defines a logical error model that is suitable for
+        # 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
         # # Overview
-        # The `Status` message contains three pieces of data: error code, error message,
-        # and error details. The error code should be an enum value of
+        # The `Status` message contains three pieces of data: error code, error
+        # message, and error details. The error code should be an enum value of
         # google.rpc.Code, but it may accept additional error codes if needed.  The
         # error message should be a developer-facing English message that helps
         # developers *understand* and *resolve* the error. If a localized user-facing
@@ -3199,9 +3122,8 @@ module Google
       class Page
         include Google::Apis::Core::Hashable
       
-        # The Markdown content of the page. You can use <code>&#40;== include `path` ==&#
-        # 41;</code>
-        # to include content from a Markdown file.
+        # The Markdown content of the page. You can use <code>&#40;== include `path`
+        # ==&#41;</code> to include content from a Markdown file.
         # Corresponds to the JSON property `content`
         # @return [String]
         attr_accessor :content
@@ -3242,46 +3164,7 @@ module Google
         end
       end
       
-      # Quota configuration helps to achieve fairness and budgeting in service
-      # usage.
-      # The quota configuration works this way:
-      # - The service configuration defines a set of metrics.
-      # - For API calls, the quota.metric_rules maps methods to metrics with
-      # corresponding costs.
-      # - The quota.limits defines limits on the metrics, which will be used for
-      # quota checks at runtime.
-      # An example quota configuration in yaml format:
-      # quota:
-      # limits:
-      # - name: apiWriteQpsPerProject
-      # metric: library.googleapis.com/write_calls
-      # unit: "1/min/`project`"  # rate limit for consumer projects
-      # values:
-      # STANDARD: 10000
-      # # The metric rules bind all methods to the read_calls metric,
-      # # except for the UpdateBook and DeleteBook methods. These two methods
-      # # are mapped to the write_calls metric, with the UpdateBook method
-      # # consuming at twice rate as the DeleteBook method.
-      # metric_rules:
-      # - selector: "*"
-      # metric_costs:
-      # library.googleapis.com/read_calls: 1
-      # - selector: google.example.library.v1.LibraryService.UpdateBook
-      # metric_costs:
-      # library.googleapis.com/write_calls: 2
-      # - selector: google.example.library.v1.LibraryService.DeleteBook
-      # metric_costs:
-      # library.googleapis.com/write_calls: 1
-      # Corresponding Metric definition:
-      # metrics:
-      # - name: library.googleapis.com/read_calls
-      # display_name: Read requests
-      # metric_kind: DELTA
-      # value_type: INT64
-      # - name: library.googleapis.com/write_calls
-      # display_name: Write requests
-      # metric_kind: DELTA
-      # value_type: INT64
+      # 
       class Quota
         include Google::Apis::Core::Hashable
       
@@ -3463,14 +3346,14 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for 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:
+      # The `Status` type defines a logical error model that is suitable for
+      # 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
       # # Overview
-      # The `Status` message contains three pieces of data: error code, error message,
-      # and error details. The error code should be an enum value of
+      # The `Status` message contains three pieces of data: error code, error
+      # message, and error details. The error code should be an enum value of
       # google.rpc.Code, but it may accept additional error codes if needed.  The
       # error message should be a developer-facing English message that helps
       # developers *understand* and *resolve* the error. If a localized user-facing

data/generated/google/apis/serviceusage_v1beta1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/service-usage/
     module ServiceusageV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20190109'
+      REVISION = '20190306'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/serviceusage_v1beta1/classes.rb

@@ -103,8 +103,8 @@ module Google
       end
       
       # Configuration for an anthentication provider, including support for
-      # [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-
-      # token-32).
+      # [JSON Web Token
+      # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
       class AuthProvider
         include Google::Apis::Core::Hashable
       
@@ -148,15 +148,16 @@ module Google
         attr_accessor :issuer
       
         # URL of the provider's public key set to validate signature of the JWT. See
-        # [OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#
+        # [OpenID
+        # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#
         # ProviderMetadata).
         # Optional if the key set document:
         # - can be retrieved from
-        # [OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.
-        # html
-        # of the issuer.
-        # - can be inferred from the email domain of the issuer (e.g. a Google service
-        # account).
+        # [OpenID
+        # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
+        # the issuer.
+        # - can be inferred from the email domain of the issuer (e.g. a Google
+        # service account).
         # Example: https://www.googleapis.com/oauth2/v1/certs
         # Corresponds to the JSON property `jwksUri`
         # @return [String]
@@ -177,8 +178,8 @@ module Google
       end
       
       # User-defined authentication requirements, including support for
-      # [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-
-      # token-32).
+      # [JSON Web Token
+      # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
       class AuthRequirement
         include Google::Apis::Core::Hashable
       
@@ -889,8 +890,8 @@ module Google
       class DocumentationRule
         include Google::Apis::Core::Hashable
       
-        # Deprecation description of the selected element(s). It can be provided if an
-        # element is marked as `deprecated`.
+        # Deprecation description of the selected element(s). It can be provided if
+        # an element is marked as `deprecated`.
         # Corresponds to the JSON property `deprecationDescription`
         # @return [String]
         attr_accessor :deprecation_description
@@ -1047,10 +1048,10 @@ module Google
         attr_accessor :name
       
         # The specification of an Internet routable address of API frontend that will
-        # handle requests to this [API Endpoint](https://cloud.google.com/apis/design/
-        # glossary).
-        # It should be either a valid IPv4 address or a fully-qualified domain name.
-        # For example, "8.8.8.8" or "myservice.appspot.com".
+        # handle requests to this [API
+        # Endpoint](https://cloud.google.com/apis/design/glossary). It should be
+        # either a valid IPv4 address or a fully-qualified domain name. For example,
+        # "8.8.8.8" or "myservice.appspot.com".
         # Corresponds to the JSON property `target`
         # @return [String]
         attr_accessor :target
@@ -1572,46 +1573,7 @@ module Google
         # @return [String]
         attr_accessor :producer_project_id
       
-        # Quota configuration helps to achieve fairness and budgeting in service
-        # usage.
-        # The quota configuration works this way:
-        # - The service configuration defines a set of metrics.
-        # - For API calls, the quota.metric_rules maps methods to metrics with
-        # corresponding costs.
-        # - The quota.limits defines limits on the metrics, which will be used for
-        # quota checks at runtime.
-        # An example quota configuration in yaml format:
-        # quota:
-        # limits:
-        # - name: apiWriteQpsPerProject
-        # metric: library.googleapis.com/write_calls
-        # unit: "1/min/`project`"  # rate limit for consumer projects
-        # values:
-        # STANDARD: 10000
-        # # The metric rules bind all methods to the read_calls metric,
-        # # except for the UpdateBook and DeleteBook methods. These two methods
-        # # are mapped to the write_calls metric, with the UpdateBook method
-        # # consuming at twice rate as the DeleteBook method.
-        # metric_rules:
-        # - selector: "*"
-        # metric_costs:
-        # library.googleapis.com/read_calls: 1
-        # - selector: google.example.library.v1.LibraryService.UpdateBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 2
-        # - selector: google.example.library.v1.LibraryService.DeleteBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 1
-        # Corresponding Metric definition:
-        # metrics:
-        # - name: library.googleapis.com/read_calls
-        # display_name: Read requests
-        # metric_kind: DELTA
-        # value_type: INT64
-        # - name: library.googleapis.com/write_calls
-        # display_name: Write requests
-        # metric_kind: DELTA
-        # value_type: INT64
+        # Quota configuration.
         # Corresponds to the JSON property `quota`
         # @return [Google::Apis::ServiceusageV1beta1::Quota]
         attr_accessor :quota
@@ -1851,46 +1813,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Quota configuration helps to achieve fairness and budgeting in service
-        # usage.
-        # The quota configuration works this way:
-        # - The service configuration defines a set of metrics.
-        # - For API calls, the quota.metric_rules maps methods to metrics with
-        # corresponding costs.
-        # - The quota.limits defines limits on the metrics, which will be used for
-        # quota checks at runtime.
-        # An example quota configuration in yaml format:
-        # quota:
-        # limits:
-        # - name: apiWriteQpsPerProject
-        # metric: library.googleapis.com/write_calls
-        # unit: "1/min/`project`"  # rate limit for consumer projects
-        # values:
-        # STANDARD: 10000
-        # # The metric rules bind all methods to the read_calls metric,
-        # # except for the UpdateBook and DeleteBook methods. These two methods
-        # # are mapped to the write_calls metric, with the UpdateBook method
-        # # consuming at twice rate as the DeleteBook method.
-        # metric_rules:
-        # - selector: "*"
-        # metric_costs:
-        # library.googleapis.com/read_calls: 1
-        # - selector: google.example.library.v1.LibraryService.UpdateBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 2
-        # - selector: google.example.library.v1.LibraryService.DeleteBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 1
-        # Corresponding Metric definition:
-        # metrics:
-        # - name: library.googleapis.com/read_calls
-        # display_name: Read requests
-        # metric_kind: DELTA
-        # value_type: INT64
-        # - name: library.googleapis.com/write_calls
-        # display_name: Write requests
-        # metric_kind: DELTA
-        # value_type: INT64
+        # Quota configuration.
         # Corresponds to the JSON property `quota`
         # @return [Google::Apis::ServiceusageV1beta1::Quota]
         attr_accessor :quota
@@ -1928,7 +1851,7 @@ module Google
       class Http
         include Google::Apis::Core::Hashable
       
-        # When set to true, URL path parmeters will be fully URI-decoded except in
+        # When set to true, URL path parameters will be fully URI-decoded except in
         # cases of single segment matches in reserved expansion, where "%2F" will be
         # left encoded.
         # The default behavior is to not decode RFC 6570 reserved characters in multi
@@ -3034,14 +2957,14 @@ module Google
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for 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:
+        # The `Status` type defines a logical error model that is suitable for
+        # 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
         # # Overview
-        # The `Status` message contains three pieces of data: error code, error message,
-        # and error details. The error code should be an enum value of
+        # The `Status` message contains three pieces of data: error code, error
+        # message, and error details. The error code should be an enum value of
         # google.rpc.Code, but it may accept additional error codes if needed.  The
         # error message should be a developer-facing English message that helps
         # developers *understand* and *resolve* the error. If a localized user-facing
@@ -3175,9 +3098,8 @@ module Google
       class Page
         include Google::Apis::Core::Hashable
       
-        # The Markdown content of the page. You can use <code>&#40;== include `path` ==&#
-        # 41;</code>
-        # to include content from a Markdown file.
+        # The Markdown content of the page. You can use <code>&#40;== include `path`
+        # ==&#41;</code> to include content from a Markdown file.
         # Corresponds to the JSON property `content`
         # @return [String]
         attr_accessor :content
@@ -3218,46 +3140,7 @@ module Google
         end
       end
       
-      # Quota configuration helps to achieve fairness and budgeting in service
-      # usage.
-      # The quota configuration works this way:
-      # - The service configuration defines a set of metrics.
-      # - For API calls, the quota.metric_rules maps methods to metrics with
-      # corresponding costs.
-      # - The quota.limits defines limits on the metrics, which will be used for
-      # quota checks at runtime.
-      # An example quota configuration in yaml format:
-      # quota:
-      # limits:
-      # - name: apiWriteQpsPerProject
-      # metric: library.googleapis.com/write_calls
-      # unit: "1/min/`project`"  # rate limit for consumer projects
-      # values:
-      # STANDARD: 10000
-      # # The metric rules bind all methods to the read_calls metric,
-      # # except for the UpdateBook and DeleteBook methods. These two methods
-      # # are mapped to the write_calls metric, with the UpdateBook method
-      # # consuming at twice rate as the DeleteBook method.
-      # metric_rules:
-      # - selector: "*"
-      # metric_costs:
-      # library.googleapis.com/read_calls: 1
-      # - selector: google.example.library.v1.LibraryService.UpdateBook
-      # metric_costs:
-      # library.googleapis.com/write_calls: 2
-      # - selector: google.example.library.v1.LibraryService.DeleteBook
-      # metric_costs:
-      # library.googleapis.com/write_calls: 1
-      # Corresponding Metric definition:
-      # metrics:
-      # - name: library.googleapis.com/read_calls
-      # display_name: Read requests
-      # metric_kind: DELTA
-      # value_type: INT64
-      # - name: library.googleapis.com/write_calls
-      # display_name: Write requests
-      # metric_kind: DELTA
-      # value_type: INT64
+      # 
       class Quota
         include Google::Apis::Core::Hashable
       
@@ -3533,46 +3416,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Quota configuration helps to achieve fairness and budgeting in service
-        # usage.
-        # The quota configuration works this way:
-        # - The service configuration defines a set of metrics.
-        # - For API calls, the quota.metric_rules maps methods to metrics with
-        # corresponding costs.
-        # - The quota.limits defines limits on the metrics, which will be used for
-        # quota checks at runtime.
-        # An example quota configuration in yaml format:
-        # quota:
-        # limits:
-        # - name: apiWriteQpsPerProject
-        # metric: library.googleapis.com/write_calls
-        # unit: "1/min/`project`"  # rate limit for consumer projects
-        # values:
-        # STANDARD: 10000
-        # # The metric rules bind all methods to the read_calls metric,
-        # # except for the UpdateBook and DeleteBook methods. These two methods
-        # # are mapped to the write_calls metric, with the UpdateBook method
-        # # consuming at twice rate as the DeleteBook method.
-        # metric_rules:
-        # - selector: "*"
-        # metric_costs:
-        # library.googleapis.com/read_calls: 1
-        # - selector: google.example.library.v1.LibraryService.UpdateBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 2
-        # - selector: google.example.library.v1.LibraryService.DeleteBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 1
-        # Corresponding Metric definition:
-        # metrics:
-        # - name: library.googleapis.com/read_calls
-        # display_name: Read requests
-        # metric_kind: DELTA
-        # value_type: INT64
-        # - name: library.googleapis.com/write_calls
-        # display_name: Write requests
-        # metric_kind: DELTA
-        # value_type: INT64
+        # Quota configuration.
         # Corresponds to the JSON property `quota`
         # @return [Google::Apis::ServiceusageV1beta1::Quota]
         attr_accessor :quota
@@ -3644,14 +3488,14 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for 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:
+      # The `Status` type defines a logical error model that is suitable for
+      # 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
       # # Overview
-      # The `Status` message contains three pieces of data: error code, error message,
-      # and error details. The error code should be an enum value of
+      # The `Status` message contains three pieces of data: error code, error
+      # message, and error details. The error code should be an enum value of
       # google.rpc.Code, but it may accept additional error codes if needed.  The
       # error message should be a developer-facing English message that helps
       # developers *understand* and *resolve* the error. If a localized user-facing