google-api-client 0.41.2 → 0.44.0

data/generated/google/apis/cloudtrace_v1.rb

@@ -29,7 +29,7 @@ module Google
     # @see https://cloud.google.com/trace
     module CloudtraceV1
       VERSION = 'V1'
-      REVISION = '20200309'
+      REVISION = '20200805'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -22,13 +22,11 @@ module Google
   module Apis
     module CloudtraceV1
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # 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);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated 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); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -45,9 +43,9 @@ module Google
       class ListTracesResponse
         include Google::Apis::Core::Hashable
       
-        # If defined, indicates that there are more traces that match the request
-        # and that this value should be passed to the next request to continue
-        # retrieving additional traces.
+        # If defined, indicates that there are more traces that match the request and
+        # that this value should be passed to the next request to continue retrieving
+        # additional traces.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -68,9 +66,9 @@ module Google
         end
       end
       
-      # A trace describes how long it takes for an application to perform an
-      # operation. It consists of a set of spans, each of which represent a single
-      # timed event within the operation.
+      # A trace describes how long it takes for an application to perform an operation.
+      # It consists of a set of spans, each of which represent a single timed event
+      # within the operation.
       class Trace
         include Google::Apis::Core::Hashable
       
@@ -84,9 +82,9 @@ module Google
         # @return [Array<Google::Apis::CloudtraceV1::TraceSpan>]
         attr_accessor :spans
       
-        # Globally unique identifier for the trace. This identifier is a 128-bit
-        # numeric value formatted as a 32-byte hex string. For example,
-        # `382d4f4c6b7bb2f4a972559d9085001d`.
+        # Globally unique identifier for the trace. This identifier is a 128-bit numeric
+        # value formatted as a 32-byte hex string. For example, `
+        # 382d4f4c6b7bb2f4a972559d9085001d`. The numeric value should not be zero.
         # Corresponds to the JSON property `traceId`
         # @return [String]
         attr_accessor :trace_id
@@ -103,11 +101,11 @@ module Google
         end
       end
       
-      # A span represents a single timed event within a trace. Spans can be nested
-      # and form a trace tree. Often, a trace contains a root span that describes the
-      # end-to-end latency of an operation and, optionally, one or more subspans for
-      # its suboperations. Spans do not need to be contiguous. There may be gaps
-      # between spans in a trace.
+      # A span represents a single timed event within a trace. Spans can be nested and
+      # form a trace tree. Often, a trace contains a root span that describes the end-
+      # to-end latency of an operation and, optionally, one or more subspans for its
+      # suboperations. Spans do not need to be contiguous. There may be gaps between
+      # spans in a trace.
       class TraceSpan
         include Google::Apis::Core::Hashable
       
@@ -117,54 +115,33 @@ module Google
         attr_accessor :end_time
       
         # Distinguishes between spans generated in a particular context. For example,
-        # two spans with the same name may be distinguished using `RPC_CLIENT`
-        # and `RPC_SERVER` to identify queueing latency associated with the span.
+        # two spans with the same name may be distinguished using `RPC_CLIENT` and `
+        # RPC_SERVER` to identify queueing latency associated with the span.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
         # Collection of labels associated with the span. Label keys must be less than
-        # 128 bytes. Label values must be less than 16 kilobytes (10MB for
-        # `/stacktrace` values).
-        # Some predefined label keys exist, or you may create your own. When creating
-        # your own, we recommend the following formats:
-        # * `/category/product/key` for agents of well-known products (e.g.
-        # `/db/mongodb/read_size`).
-        # * `short_host/path/key` for domain-specific keys (e.g.
-        # `foo.com/myproduct/bar`)
-        # Predefined labels include:
-        # *   `/agent`
-        # *   `/component`
-        # *   `/error/message`
-        # *   `/error/name`
-        # *   `/http/client_city`
-        # *   `/http/client_country`
-        # *   `/http/client_protocol`
-        # *   `/http/client_region`
-        # *   `/http/host`
-        # *   `/http/method`
-        # *   `/http/path`
-        # *   `/http/redirected_url`
-        # *   `/http/request/size`
-        # *   `/http/response/size`
-        # *   `/http/route`
-        # *   `/http/status_code`
-        # *   `/http/url`
-        # *   `/http/user_agent`
-        # *   `/pid`
-        # *   `/stacktrace`
-        # *   `/tid`
+        # 128 bytes. Label values must be less than 16 kilobytes (10MB for `/stacktrace`
+        # values). Some predefined label keys exist, or you may create your own. When
+        # creating your own, we recommend the following formats: * `/category/product/
+        # key` for agents of well-known products (e.g. `/db/mongodb/read_size`). * `
+        # short_host/path/key` for domain-specific keys (e.g. `foo.com/myproduct/bar`)
+        # Predefined labels include: * `/agent` * `/component` * `/error/message` * `/
+        # error/name` * `/http/client_city` * `/http/client_country` * `/http/
+        # client_protocol` * `/http/client_region` * `/http/host` * `/http/method` * `/
+        # http/path` * `/http/redirected_url` * `/http/request/size` * `/http/response/
+        # size` * `/http/route` * `/http/status_code` * `/http/url` * `/http/user_agent`
+        # * `/pid` * `/stacktrace` * `/tid`
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Name of the span. Must be less than 128 bytes. The span name is sanitized
-        # and displayed in the Stackdriver Trace tool in the
-        # Google Cloud Platform Console.
-        # The name may be a method name or some other per-call site name.
-        # For the same executable and the same call point, a best practice is
-        # to use a consistent name, which makes it easier to correlate
-        # cross-trace spans.
+        # Name of the span. Must be less than 128 bytes. The span name is sanitized and
+        # displayed in the Trace tool in the Google Cloud Platform Console. The name may
+        # be a method name or some other per-call site name. For the same executable and
+        # the same call point, a best practice is to use a consistent name, which makes
+        # it easier to correlate cross-trace spans.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -174,8 +151,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :parent_span_id
       
-        # Identifier for the span. Must be a 64-bit integer other than 0 and
-        # unique within a trace. For example, `2205310701640571284`.
+        # Identifier for the span. Must be a 64-bit integer other than 0 and unique
+        # within a trace. For example, `2205310701640571284`.
         # Corresponds to the JSON property `spanId`
         # @return [Fixnum]
         attr_accessor :span_id

data/generated/google/apis/cloudtrace_v1/service.rb

@@ -51,13 +51,11 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Sends new traces to Stackdriver Trace or updates existing traces. If the ID
-        # of a trace that you send matches that of an existing trace, any fields
-        # in the existing trace and its spans are overwritten by the provided values,
-        # and any new fields provided are merged with the existing trace data. If the
-        # ID does not match, a new trace is created.
-        # In this case, writing traces is not considered an active developer
-        # method since traces are machine generated.
+        # Sends new traces to Cloud Trace or updates existing traces. If the ID of a
+        # trace that you send matches that of an existing trace, any fields in the
+        # existing trace and its spans are overwritten by the provided values, and any
+        # new fields provided are merged with the existing trace data. If the ID does
+        # not match, a new trace is created.
         # @param [String] project_id
         #   Required. ID of the Cloud project where the trace data is stored.
         # @param [Google::Apis::CloudtraceV1::Traces] traces_object
@@ -91,8 +89,6 @@ module Google
         end
         
         # Gets a single trace by its ID.
-        # In this case, getting for traces is considered an active developer method,
-        # even though it is technically a read-only method.
         # @param [String] project_id
         #   Required. ID of the Cloud project where the trace data is stored.
         # @param [String] trace_id
@@ -126,66 +122,50 @@ module Google
         end
         
         # Returns of a list of traces that match the specified filter conditions.
-        # In this case, listing for traces is considered an active developer method,
-        # even though it is technically a read-only method.
         # @param [String] project_id
         #   Required. ID of the Cloud project where the trace data is stored.
         # @param [String] end_time
-        #   End of the time interval (inclusive) during which the trace data was
-        #   collected from the application.
+        #   End of the time interval (inclusive) during which the trace data was collected
+        #   from the application.
         # @param [String] filter
-        #   Optional. A filter against labels for the request.
-        #   By default, searches use prefix matching. To specify exact match, prepend
-        #   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`.
+        #   Optional. A filter against labels for the request. By default, searches use
+        #   prefix matching. To specify exact match, prepend 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`.
         # @param [String] order_by
-        #   Optional. Field used to sort the returned traces.
-        #   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)
-        #   Descending order can be specified by appending `desc` to the sort field
-        #   (for example, `name desc`).
-        #   Only one sort field is permitted.
+        #   Optional. Field used to sort the returned traces. 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) Descending order can be specified
+        #   by appending `desc` to the sort field (for example, `name desc`). Only one
+        #   sort field is permitted.
         # @param [Fixnum] page_size
         #   Optional. Maximum number of traces to return. If not specified or <= 0, the
-        #   implementation selects a reasonable value.  The implementation may
-        #   return fewer traces than the requested page size.
+        #   implementation selects a reasonable value. The implementation may return fewer
+        #   traces than the requested page size.
         # @param [String] page_token
-        #   Token identifying the page of results to return. If provided, use the
-        #   value of the `next_page_token` field from a previous request.
+        #   Token identifying the page of results to return. If provided, use the value of
+        #   the `next_page_token` field from a previous request.
         # @param [String] start_time
         #   Start of the time interval (inclusive) during which the trace data was
         #   collected from the application.
         # @param [String] view
-        #   Optional. Type of data returned for traces in the list. Default is
-        #   `MINIMAL`.
+        #   Optional. Type of data returned for traces in the list. Default is `MINIMAL`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

data/generated/google/apis/cloudtrace_v2.rb

@@ -29,7 +29,7 @@ module Google
     # @see https://cloud.google.com/trace
     module CloudtraceV2
       VERSION = 'V2'
-      REVISION = '20200414'
+      REVISION = '20200805'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -83,19 +83,18 @@ module Google
       class Attributes
         include Google::Apis::Core::Hashable
       
-        # The set of attributes. Each attribute's key can be up to 128 bytes
-        # 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": ` "string_value": ` "value": "my-instance" ` `
-        # "/http/request_bytes": ` "int_value": 300 `
-        # "abc.com/myattribute": ` "bool_value": false `
+        # The set of attributes. Each attribute's key can be up to 128 bytes 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": ` "string_value": ` "
+        # value": "my-instance" ` ` "/http/request_bytes": ` "int_value": 300 ` "abc.com/
+        # myattribute": ` "bool_value": false `
         # Corresponds to the JSON property `attributeMap`
         # @return [Hash<String,Google::Apis::CloudtraceV2::AttributeValue>]
         attr_accessor :attribute_map
       
         # The number of attributes that were discarded. Attributes can be discarded
-        # because their keys are too long or because there are too many attributes.
-        # If this value is 0 then all attributes are valid.
+        # because their keys are too long or because there are too many attributes. If
+        # this value is 0 then all attributes are valid.
         # Corresponds to the JSON property `droppedAttributesCount`
         # @return [Fixnum]
         attr_accessor :dropped_attributes_count
@@ -115,8 +114,8 @@ module Google
       class BatchWriteSpansRequest
         include Google::Apis::Core::Hashable
       
-        # Required. A list of new spans. The span names must not match existing
-        # spans, or the results are undefined.
+        # Required. A list of new spans. The span names must not match existing spans,
+        # or the results are undefined.
         # Corresponds to the JSON property `spans`
         # @return [Array<Google::Apis::CloudtraceV2::Span>]
         attr_accessor :spans
@@ -131,13 +130,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # 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);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated 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); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -151,9 +148,9 @@ module Google
       end
       
       # A pointer from the current span to another span in the same trace or in a
-      # different trace. For example, this can be used in batching operations,
-      # where a single batch handler processes multiple requests from different
-      # traces or when the handler receives a request from a different project.
+      # different trace. For example, this can be used in batching operations, where a
+      # single batch handler processes multiple requests from different traces or when
+      # the handler receives a request from a different project.
       class Link
         include Google::Apis::Core::Hashable
       
@@ -190,13 +187,13 @@ module Google
         end
       end
       
-      # A collection of links, which are references from this span to a span
-      # in the same or different trace.
+      # A collection of links, which are references from this span to a span in the
+      # same or different trace.
       class Links
         include Google::Apis::Core::Hashable
       
-        # The number of dropped links after the maximum size was enforced. If
-        # this value is 0, then no links were dropped.
+        # The number of dropped links after the maximum size was enforced. If this value
+        # is 0, then no links were dropped.
         # Corresponds to the JSON property `droppedLinksCount`
         # @return [Fixnum]
         attr_accessor :dropped_links_count
@@ -221,21 +218,19 @@ module Google
       class MessageEvent
         include Google::Apis::Core::Hashable
       
-        # The number of compressed bytes sent or received. If missing assumed to
-        # be the same size as uncompressed.
+        # The number of compressed bytes sent or received. If missing assumed to be the
+        # same size as uncompressed.
         # Corresponds to the JSON property `compressedSizeBytes`
         # @return [Fixnum]
         attr_accessor :compressed_size_bytes
       
-        # An identifier for the MessageEvent's message that can be used to match
-        # SENT and RECEIVED MessageEvents. It is recommended to be unique within
-        # a Span.
+        # An identifier for the MessageEvent's message that can be used to match SENT
+        # and RECEIVED MessageEvents. It is recommended to be unique within a Span.
         # Corresponds to the JSON property `id`
         # @return [Fixnum]
         attr_accessor :id
       
-        # Type of MessageEvent. Indicates whether the message was sent or
-        # received.
+        # Type of MessageEvent. Indicates whether the message was sent or received.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -283,12 +278,11 @@ module Google
         end
       end
       
-      # A span represents a single operation within a trace. Spans can be
-      # nested to form a trace tree. Often, a trace contains a root span
-      # that describes the end-to-end latency, and one or more subspans for
-      # its sub-operations. A trace can also contain multiple root spans,
-      # or none at all. Spans do not need to be contiguous&mdash;there may be
-      # gaps or overlaps between spans in a trace.
+      # A span represents a single operation within a trace. Spans can be nested to
+      # form a trace tree. Often, a trace contains a root span that describes the end-
+      # to-end latency, and one or more subspans for its sub-operations. A trace can
+      # also contain multiple root spans, or none at all. Spans do not need to be
+      # contiguous—there may be gaps or overlaps between spans in a trace.
       class Span
         include Google::Apis::Core::Hashable
       
@@ -297,8 +291,8 @@ module Google
         # @return [Google::Apis::CloudtraceV2::Attributes]
         attr_accessor :attributes
       
-        # Optional. The number of child spans that were generated while this span
-        # was active. If set, allows implementation to detect missing child spans.
+        # Optional. The number of child spans that were generated while this span was
+        # active. If set, allows implementation to detect missing child spans.
         # Corresponds to the JSON property `childSpanCount`
         # @return [Fixnum]
         attr_accessor :child_span_count
@@ -309,39 +303,36 @@ module Google
         attr_accessor :display_name
       
         # Required. The end time of the span. On the client side, this is the time kept
-        # by
-        # the local machine where the span execution ends. On the server side, this
+        # by the local machine where the span execution ends. On the server side, this
         # is the time when the server application handler stops running.
         # Corresponds to the JSON property `endTime`
         # @return [String]
         attr_accessor :end_time
       
-        # A collection of links, which are references from this span to a span
-        # in the same or different trace.
+        # A collection of links, which are references from this span to a span in the
+        # same or different trace.
         # Corresponds to the JSON property `links`
         # @return [Google::Apis::CloudtraceV2::Links]
         attr_accessor :links
       
-        # 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;
-        # 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
-        # is a 16-character hexadecimal encoding of an 8-byte array.
+        # Required. 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; 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 is a 16-
+        # character hexadecimal encoding of an 8-byte array. It should not be zero.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The [SPAN_ID] of this span's parent span. If this is a root span,
-        # then this field must be empty.
+        # The [SPAN_ID] of this span's parent span. If this is a root span, then this
+        # field must be empty.
         # Corresponds to the JSON property `parentSpanId`
         # @return [String]
         attr_accessor :parent_span_id
       
-        # Optional. Set this parameter to indicate whether this span is in
-        # the same process as its parent. If you do not set this parameter,
-        # Stackdriver Trace is unable to take advantage of this helpful
-        # information.
+        # Optional. Set this parameter to indicate whether this span is in the same
+        # process as its parent. If you do not set this parameter, Trace is unable to
+        # take advantage of this helpful information.
         # Corresponds to the JSON property `sameProcessAsParentSpan`
         # @return [Boolean]
         attr_accessor :same_process_as_parent_span
@@ -352,9 +343,9 @@ module Google
         # @return [String]
         attr_accessor :span_id
       
-        # Distinguishes between spans generated in a particular context. For example,
-        # two spans with the same name may be distinguished using `CLIENT` (caller)
-        # and `SERVER` (callee) to identify an RPC call.
+        # Optional. Distinguishes between spans generated in a particular context. For
+        # example, two spans with the same name may be distinguished using `CLIENT` (
+        # caller) and `SERVER` (callee) to identify an RPC call.
         # Corresponds to the JSON property `spanKind`
         # @return [String]
         attr_accessor :span_kind
@@ -365,26 +356,25 @@ module Google
         attr_accessor :stack_trace
       
         # Required. The start time of the span. On the client side, this is the time
-        # kept by
-        # the local machine where the span execution starts. On the server side, this
-        # is the time when the server's application handler starts running.
+        # kept by the local machine where the span execution starts. On the server side,
+        # this is the time when the server's application handler starts running.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
       
-        # 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). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # 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). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::CloudtraceV2::Status]
         attr_accessor :status
       
-        # A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation
-        # on the span, consisting of either user-supplied key:value pairs, or
-        # details of a message sent/received between Spans.
+        # A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation on
+        # the span, consisting of either user-supplied key:value pairs, or details of a
+        # message sent/received between Spans.
         # Corresponds to the JSON property `timeEvents`
         # @return [Google::Apis::CloudtraceV2::TimeEvents]
         attr_accessor :time_events
@@ -416,8 +406,8 @@ module Google
       class StackFrame
         include Google::Apis::Core::Hashable
       
-        # The column number where the function call appears, if available.
-        # This is important in JavaScript because of its anonymous functions.
+        # The column number where the function call appears, if available. This is
+        # important in JavaScript because of its anonymous functions.
         # Corresponds to the JSON property `columnNumber`
         # @return [Fixnum]
         attr_accessor :column_number
@@ -472,9 +462,8 @@ module Google
       class StackFrames
         include Google::Apis::Core::Hashable
       
-        # The number of stack frames that were dropped because there
-        # were too many stack frames.
-        # If this value is 0, then no stack frames were dropped.
+        # The number of stack frames that were dropped because there were too many stack
+        # frames. If this value is 0, then no stack frames were dropped.
         # Corresponds to the JSON property `droppedFramesCount`
         # @return [Fixnum]
         attr_accessor :dropped_frames_count
@@ -504,13 +493,11 @@ module Google
         # @return [Google::Apis::CloudtraceV2::StackFrames]
         attr_accessor :stack_frames
       
-        # The hash ID is used to conserve network bandwidth for duplicate
-        # stack traces within a single trace.
-        # Often multiple spans will have identical stack traces.
-        # The first occurrence of a stack trace should contain both the
-        # `stackFrame` content and a value in `stackTraceHashId`.
-        # Subsequent spans within the same request can refer
-        # to that stack trace by only setting `stackTraceHashId`.
+        # The hash ID is used to conserve network bandwidth for duplicate stack traces
+        # within a single trace. Often multiple spans will have identical stack traces.
+        # The first occurrence of a stack trace should contain both the `stackFrame`
+        # content and a value in `stackTraceHashId`. Subsequent spans within the same
+        # request can refer to that stack trace by only setting `stackTraceHashId`.
         # Corresponds to the JSON property `stackTraceHashId`
         # @return [Fixnum]
         attr_accessor :stack_trace_hash_id
@@ -526,12 +513,12 @@ 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). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # 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). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -540,15 +527,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -596,20 +583,20 @@ module Google
         end
       end
       
-      # A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation
-      # on the span, consisting of either user-supplied key:value pairs, or
-      # details of a message sent/received between Spans.
+      # A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation on
+      # the span, consisting of either user-supplied key:value pairs, or details of a
+      # message sent/received between Spans.
       class TimeEvents
         include Google::Apis::Core::Hashable
       
-        # The number of dropped annotations in all the included time events.
-        # If the value is 0, then no annotations were dropped.
+        # The number of dropped annotations in all the included time events. If the
+        # value is 0, then no annotations were dropped.
         # Corresponds to the JSON property `droppedAnnotationsCount`
         # @return [Fixnum]
         attr_accessor :dropped_annotations_count
       
-        # The number of dropped message events in all the included time events.
-        # If the value is 0, then no message events were dropped.
+        # The number of dropped message events in all the included time events. If the
+        # value is 0, then no message events were dropped.
         # Corresponds to the JSON property `droppedMessageEventsCount`
         # @return [Fixnum]
         attr_accessor :dropped_message_events_count
@@ -635,18 +622,17 @@ module Google
       class TruncatableString
         include Google::Apis::Core::Hashable
       
-        # The number of bytes removed from the original string. If this
-        # value is 0, then the string was not shortened.
+        # The number of bytes removed from the original string. If this value is 0, then
+        # the string was not shortened.
         # Corresponds to the JSON property `truncatedByteCount`
         # @return [Fixnum]
         attr_accessor :truncated_byte_count
       
-        # The shortened string. For example, if the original string is 500
-        # bytes long and the limit of the string is 128 bytes, then
-        # `value` contains the first 128 bytes of the 500-byte string.
-        # Truncation always happens on a UTF8 character boundary. If there
-        # are multi-byte characters in the string, then the length of the
-        # shortened string might be less than the size limit.
+        # The shortened string. For example, if the original string is 500 bytes long
+        # and the limit of the string is 128 bytes, then `value` contains the first 128
+        # bytes of the 500-byte string. Truncation always happens on a UTF8 character
+        # boundary. If there are multi-byte characters in the string, then the length of
+        # the shortened string might be less than the size limit.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value