Api-roll 47: 2017-03-27

discovery/googleapis/tracing__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
-                "https://www.googleapis.com/auth/trace.readonly": {
-                    "description": "Read Trace data for a project or application"
-                },
                 "https://www.googleapis.com/auth/trace.append": {
                     "description": "Write Trace data for a project or application"
                 },
                 "https://www.googleapis.com/auth/cloud-platform": {
                     "description": "View and manage your data across Google Cloud Platform services"
+                },
+                "https://www.googleapis.com/auth/trace.readonly": {
+                    "description": "Read Trace data for a project or application"
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://tracing.googleapis.com/",
     "batchPath": "batch",
     "canonicalName": "Tracing",
     "description": "Send and retrieve trace data from Google Stackdriver Trace.\n",
     "discoveryVersion": "v1",
@@ skipping 66 matching lines @@
                 "proto"
             ],
             "enumDescriptions": [
                 "Responses with Content-Type of application/json",
                 "Media download with context-dependent Content-Type",
                 "Responses with Content-Type of application/x-protobuf"
             ],
             "location": "query",
             "type": "string"
         },
+        "access_token": {
+            "description": "OAuth access token.",
+            "location": "query",
+            "type": "string"
+        },
         "key": {
             "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
             "location": "query",
             "type": "string"
         },
-        "access_token": {
-            "description": "OAuth access token.",
-            "location": "query",
-            "type": "string"
-        },
         "quotaUser": {
             "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
             "location": "query",
             "type": "string"
         },
         "pp": {
             "default": "true",
             "description": "Pretty-print response.",
             "location": "query",
             "type": "boolean"
         }
     },
     "protocol": "rest",
     "resources": {
         "projects": {
             "resources": {
                 "traces": {
                     "methods": {
+                        "listSpans": {
+                            "description": "Returns a list of spans within a trace.",
+                            "httpMethod": "GET",
+                            "id": "tracing.projects.traces.listSpans",
+                            "parameterOrder": [
+                                "name"
+                            ],
+                            "parameters": {
+                                "name": {
+                                    "description": "ID of the trace for which to list child spans. Format is\n`projects/PROJECT_ID/traces/TRACE_ID`.",
+                                    "location": "path",
+                                    "pattern": "^projects/[^/]+/traces/[^/]+$",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "pageToken": {
+                                    "description": "Token identifying the page of results to return. If provided, use the\nvalue of the `nextPageToken` field from a previous request. Optional.",
+                                    "location": "query",
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1/{+name}:listSpans",
+                            "response": {
+                                "$ref": "ListSpansResponse"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/cloud-platform",
+                                "https://www.googleapis.com/auth/trace.readonly"
+                            ]
+                        },
                         "list": {
                             "description": "Returns of a list of traces that match the specified filter conditions.",
                             "httpMethod": "GET",
                             "id": "tracing.projects.traces.list",
                             "parameterOrder": [
                                 "parent"
                             ],
                             "parameters": {
-                                "pageSize": {
-                                    "description": "Maximum number of traces to return. If not specified or <= 0, the\nimplementation selects a reasonable value.  The implementation may\nreturn fewer traces than the requested page size. Optional.",
-                                    "format": "int32",
-                                    "location": "query",
-                                    "type": "integer"
-                                },
-                                "parent": {
-                                    "description": "ID of the Cloud project where the trace data is stored.",
-                                    "location": "path",
-                                    "pattern": "^projects/[^/]+$",
-                                    "required": true,
-                                    "type": "string"
-                                },
-                                "orderBy": {
-                                    "description": "Field used to sort the returned traces. Optional.\nCan be one of the following:\n\n*   `trace_id`\n*   `name` (`name` field of root span in the trace)\n*   `duration` (difference between `end_time` and `start_time` fields of\n     the root span)\n*   `start` (`start_time` field of the root span)\n\nDescending order can be specified by appending `desc` to the sort field\n(for example, `name desc`).\n\nOnly one sort field is permitted.",
+                                "filter": {
+                                    "description": "An optional filter for the request.\nExample:\n`version_label_key:a some_label:some_label_key`\nreturns traces from version `a` and has `some_label` with `some_label_key`.",
                                     "location": "query",
                                     "type": "string"
                                 },
-                                "filter": {
-                                    "description": "An optional filter for the request.\nExample:\n\"version_label_key:a some_label:some_label_key\"\nreturns traces from version a and has some_label with some_label_key.",
-                                    "location": "query",
-                                    "type": "string"
-                                },
                                 "endTime": {
                                     "description": "End of the time interval (inclusive) during which the trace data was\ncollected from the application.",
                                     "format": "google-datetime",
                                     "location": "query",
                                     "type": "string"
                                 },
+                                "startTime": {
+                                    "description": "Start of the time interval (inclusive) during which the trace data was\ncollected from the application.",
+                                    "format": "google-datetime",
+                                    "location": "query",
+                                    "type": "string"
+                                },
                                 "pageToken": {
                                     "description": "Token identifying the page of results to return. If provided, use the\nvalue of the `next_page_token` field from a previous request. Optional.",
                                     "location": "query",
                                     "type": "string"
                                 },
-                                "startTime": {
-                                    "description": "Start of the time interval (inclusive) during which the trace data was\ncollected from the application.",
-                                    "format": "google-datetime",
+                                "pageSize": {
+                                    "description": "Maximum number of traces to return. If not specified or <= 0, the\nimplementation selects a reasonable value. The implementation may\nreturn fewer traces than the requested page size. Optional.",
+                                    "format": "int32",
+                                    "location": "query",
+                                    "type": "integer"
+                                },
+                                "parent": {
+                                    "description": "ID of the Cloud project where the trace data is stored.",
+                                    "location": "path",
+                                    "pattern": "^projects/[^/]+$",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "orderBy": {
+                                    "description": "Field used to sort the returned traces. Optional.\nCan be one of the following:\n\n*   `trace_id`\n*   `name` (`name` field of root span in the trace)\n*   `duration` (difference between `end_time` and `start_time` fields of\n     the root span)\n*   `start` (`start_time` field of the root span)\n\nDescending order can be specified by appending `desc` to the sort field\n(for example, `name desc`).\n\nOnly one sort field is permitted.",
                                     "location": "query",
                                     "type": "string"
                                 }
                             },
                             "path": "v1/{+parent}/traces",
                             "response": {
                                 "$ref": "ListTracesResponse"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/cloud-platform",
                                 "https://www.googleapis.com/auth/trace.readonly"
                             ]
                         },
                         "get": {
                             "description": "Returns a specific trace.",
                             "httpMethod": "GET",
                             "id": "tracing.projects.traces.get",
                             "parameterOrder": [
                                 "name"
                             ],
                             "parameters": {
                                 "name": {
-                                    "description": "ID of the trace which is \"projects/<project_id>/traces/<trace_id>\".",
+                                    "description": "ID of the trace. Format is `projects/PROJECT_ID/traces/TRACE_ID`.",
                                     "location": "path",
                                     "pattern": "^projects/[^/]+/traces/[^/]+$",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v1/{+name}",
                             "response": {
                                 "$ref": "Trace"
                             },
@@ skipping 22 matching lines @@
                             "request": {
                                 "$ref": "BatchUpdateSpansRequest"
                             },
                             "response": {
                                 "$ref": "Empty"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/cloud-platform",
                                 "https://www.googleapis.com/auth/trace.append"
                             ]
-                        },
-                        "listSpans": {
-                            "description": "Returns a list of spans within a trace.",
-                            "httpMethod": "GET",
-                            "id": "tracing.projects.traces.listSpans",
-                            "parameterOrder": [
-                                "name"
-                            ],
-                            "parameters": {
-                                "name": {
-                                    "description": "ID of the span set where is \"projects/<project_id>/traces/<trace_id>\".",
-                                    "location": "path",
-                                    "pattern": "^projects/[^/]+/traces/[^/]+$",
-                                    "required": true,
-                                    "type": "string"
-                                },
-                                "pageToken": {
-                                    "description": "Token identifying the page of results to return. If provided, use the\nvalue of the `page_token` field from a previous request. Optional.",
-                                    "location": "query",
-                                    "type": "string"
-                                }
-                            },
-                            "path": "v1/{+name}:listSpans",
-                            "response": {
-                                "$ref": "ListSpansResponse"
-                            },
-                            "scopes": [
-                                "https://www.googleapis.com/auth/cloud-platform",
-                                "https://www.googleapis.com/auth/trace.readonly"
-                            ]
                         }
                     }
                 }
             }
         }
     },
-    "revision": "20170225",
+    "revision": "20170320",
     "rootUrl": "https://tracing.googleapis.com/",
     "schemas": {
+        "StackTrace": {
+            "description": "StackTrace collected in a trace.",
+            "id": "StackTrace",
+            "properties": {
+                "stackFrame": {
+                    "description": "Stack frames of this stack trace.",
+                    "items": {
+                        "$ref": "StackFrame"
+                    },
+                    "type": "array"
+                },
+                "stackTraceHashId": {
+                    "description": "The hash ID is used to conserve network bandwidth for duplicate\nstack traces within a single trace.\n\nOften multiple spans will have identical stack traces.\nThe first occurance of a stack trace should contain both the\n`stackFrame` content and a value in `stackTraceHashId`.\n\nSubsequent spans within the same request can refer\nto that stack trace by only setting `stackTraceHashId`.",
+                    "format": "uint64",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "TimeEvent": {
+            "description": "A time-stamped annotation in the Span.",
+            "id": "TimeEvent",
+            "properties": {
+                "localTime": {
+                    "description": "The timestamp indicating the time the event occurred.",
+                    "format": "google-datetime",
+                    "type": "string"
+                },
+                "networkEvent": {
+                    "$ref": "NetworkEvent",
+                    "description": "An event describing an RPC message sent/received on the network."
+                },
+                "annotation": {
+                    "$ref": "Annotation",
+                    "description": "One or more key:value pairs."
+                }
+            },
+            "type": "object"
+        },
+        "NetworkEvent": {
+            "description": "An event describing an RPC message sent/received on the network.",
+            "id": "NetworkEvent",
+            "properties": {
+                "kernelTime": {
+                    "description": "If available, this is the kernel time:\n\n*  For sent messages, this is the time at which the first bit was sent.\n*  For received messages, this is the time at which the last bit was\n   received.",
+                    "format": "google-datetime",
+                    "type": "string"
+                },
+                "type": {
+                    "description": "Type of NetworkEvent. Indicates whether the RPC message was sent or\nreceived.",
+                    "enum": [
+                        "TYPE_UNSPECIFIED",
+                        "SENT",
+                        "RECV"
+                    ],
+                    "enumDescriptions": [
+                        "Unknown event type.",
+                        "Indicates a sent RPC message.",
+                        "Indicates a received RPC message."
+                    ],
+                    "type": "string"
+                },
+                "messageId": {
+                    "description": "An identifier for the message, which must be unique in this span.",
+                    "format": "uint64",
+                    "type": "string"
+                },
+                "messageSize": {
+                    "description": "The number of bytes sent or received.",
+                    "format": "uint64",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "ListSpansResponse": {
+            "description": "The response message for the `ListSpans` method.",
+            "id": "ListSpansResponse",
+            "properties": {
+                "nextPageToken": {
+                    "description": "If defined, indicates that there are more spans that match the request.\nPass this as the value of `pageToken` in a subsequent request to retrieve\nadditional spans.",
+                    "type": "string"
+                },
+                "spans": {
+                    "description": "The requested spans if there are any in the specified trace.",
+                    "items": {
+                        "$ref": "Span"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
+        "SpanUpdates": {
+            "description": "Collection of spans to update.",
+            "id": "SpanUpdates",
+            "properties": {
+                "spans": {
+                    "description": "A collection of spans.",
+                    "items": {
+                        "$ref": "Span"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
+        "StackFrame": {
+            "description": "Represents a single stack frame in a stack trace.",
+            "id": "StackFrame",
+            "properties": {
+                "fileName": {
+                    "description": "The filename of the file containing this frame.",
+                    "type": "string"
+                },
+                "sourceVersion": {
+                    "description": "The version of the deployed source code.",
+                    "type": "string"
+                },
+                "originalFunctionName": {
+                    "description": "Used when the function name is\n[mangled](http://www.avabodh.com/cxxin/namemangling.html). May be\nfully-qualified.",
+                    "type": "string"
+                },
+                "functionName": {
+                    "description": "The fully-qualified name that uniquely identifies this function or\nmethod.",
+                    "type": "string"
+                },
+                "lineNumber": {
+                    "description": "Line number of the frame.",
+                    "format": "int64",
+                    "type": "string"
+                },
+                "loadModule": {
+                    "$ref": "Module",
+                    "description": "Binary module the code is loaded from."
+                },
+                "columnNumber": {
+                    "description": "Column number is important in JavaScript (anonymous functions).\nMay not be available in some languages.",
+                    "format": "int64",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "Link": {
-            "description": "Link one span with another which may be in a different Trace. Used (for\nexample) in batching operations, where a single batch handler processes\nmultiple requests from different traces.",
+            "description": "A pointer from this span to another span in a different `Trace`. Used\n(for example) in batching operations, where a single batch handler\nprocesses multiple requests from different traces.",
             "id": "Link",
             "properties": {
+                "traceId": {
+                    "description": "The ID of the parent trace of the linked span.",
+                    "type": "string"
+                },
+                "spanId": {
+                    "description": "The `id` of the linked span.",
+                    "format": "uint64",
+                    "type": "string"
+                },
                 "type": {
-                    "description": "The type of the link.",
+                    "description": "The relationship of the current span relative to the linked span.",
                     "enum": [
                         "TYPE_UNSPECIFIED",
                         "CHILD",
                         "PARENT"
                     ],
                     "enumDescriptions": [
-                        "The relation of current span and linked span is unknown.",
-                        "Current span is child of the linked span.",
-                        "Current span is parent of the linked span."
+                        "The relationship of the two spans is unknown.",
+                        "The current span is a child of the linked span.",
+                        "The current span is the parent of the linked span."
                     ],
                     "type": "string"
-                },
-                "traceId": {
-                    "description": "The trace identifier of the linked span.",
-                    "type": "string"
-                },
-                "spanId": {
-                    "description": "The span identifier of the linked span.",
-                    "format": "uint64",
-                    "type": "string"
                 }
             },
             "type": "object"
         },
         "Annotation": {
             "description": "Text annotation with a set of attributes.",
             "id": "Annotation",
             "properties": {
                 "description": {
                     "description": "A user-supplied message describing the event.",
                     "type": "string"
                 },
                 "attributes": {
                     "additionalProperties": {
                         "$ref": "AttributeValue"
                     },
                     "description": "A set of attributes on the annotation.",
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "Trace": {
-            "description": "A trace describes how long it takes for an application to perform some\noperations. It consists of a set of spans, each of which contains details\nabout an operation with time information and operation details.",
+            "description": "A trace describes how long it takes for an application to perform some\noperations. It consists of a set of spans, each representing\nan operation and including time information and operation details.",
             "id": "Trace",
             "properties": {
                 "name": {
-                    "description": "ID of the trace which is \"projects/<project_id>/traces/<trace_id>\".\ntrace_id is globally unique identifier for the trace. Common to all the\nspans. It is conceptually a 128-bit hex-encoded value.",
+                    "description": "A globally unique identifier for the trace in the format\n`projects/PROJECT_NUMBER/traces/TRACE_ID`. `TRACE_ID` is a base16-encoded\nstring of a 128-bit number and is required to be 32 char long.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Module": {
             "description": "Binary module.",
             "id": "Module",
             "properties": {
+                "buildId": {
+                    "description": "Build_id is a unique identifier for the module,\nusually a hash of its contents",
+                    "type": "string"
+                },
                 "module": {
                     "description": "E.g. main binary, kernel modules, and dynamic libraries\nsuch as libc.so, sharedlib.so",
                     "type": "string"
-                },
-                "buildId": {
-                    "description": "Build_id is a unique identifier for the module,\nusually a hash of its contents",
-                    "type": "string"
                 }
             },
             "type": "object"
         },
         "Status": {
             "description": "The `Status` type defines a logical error model that is suitable for different\nprogramming environments, including REST APIs and RPC APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is designed to be:\n\n- Simple to use and understand for most users\n- Flexible enough to meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pieces of data: error code, error message,\nand error details. The error code should be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes if needed.  The\nerror message should be a developer-facing English message that helps\ndevelopers *understand* and *resolve* the error. If a localized user-facing\nerror message is needed, put the localized message in the error details or\nlocalize it in the client. The optional error details may contain arbitrary\ninformation about the error. There is a predefined set of error detail types\nin the package `google.rpc` which can be used for common error conditions.\n\n# Language mapping\n\nThe `Status` message is the logical representation of the error model, but it\nis not necessarily the actual wire format. When the `Status` message is\nexposed in different client libraries and different wire protocols, it can be\nmapped differently. For example, it will likely be mapped to some exceptions\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n\nThe error model and the `Status` message can be used in a variety of\nenvironments, either with or without APIs, to provide a\nconsistent developer experience across different environments.\n\nExample uses of this error model include:\n\n- Partial errors. If a service needs to return partial errors to the client,\n    it may embed the `Status` in the normal response to indicate the partial\n    errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step may\n    have a `Status` message for error reporting purpose.\n\n- Batch operations. If a client uses batch request and batch response, the\n    `Status` message should be used directly inside batch response, one for\n    each error sub-response.\n\n- Asynchronous operations. If an API call embeds asynchronous operation\n    results in its response, the status of those operations should be\n    represented directly using the `Status` message.\n\n- Logging. If some API errors are stored in logs, the message `Status` could\n    be used directly after any stripping needed for security/privacy reasons.",
             "id": "Status",
             "properties": {
-                "code": {
-                    "description": "The status code, which should be an enum value of google.rpc.Code.",
-                    "format": "int32",
-                    "type": "integer"
-                },
                 "message": {
                     "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.",
                     "type": "string"
                 },
                 "details": {
                     "description": "A list of messages that carry the error details.  There will be a\ncommon set of message types for APIs to use.",
                     "items": {
                         "additionalProperties": {
                             "description": "Properties of the object. Contains field @type with type URL.",
                             "type": "any"
                         },
                         "type": "object"
                     },
                     "type": "array"
+                },
+                "code": {
+                    "description": "The status code, which should be an enum value of google.rpc.Code.",
+                    "format": "int32",
+                    "type": "integer"
                 }
             },
             "type": "object"
         },
         "ListTracesResponse": {
             "description": "The response message for the `ListTraces` method.",
             "id": "ListTracesResponse",
             "properties": {
                 "traces": {
                     "description": "List of trace records returned.",
                     "items": {
                         "$ref": "Trace"
                     },
                     "type": "array"
                 },
                 "nextPageToken": {
                     "description": "If defined, indicates that there are more traces that match the request\nand that this value should be passed to the next request to continue\nretrieving additional traces.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Span": {
-            "description": "A span represents a single operation within a trace. Spans can be nested\nand form a trace tree. Often, a trace contains a root span that describes the\nend-to-end latency and, optionally, one or more subspans for\nits sub-operations. Spans do not need to be contiguous. There may be gaps\nbetween spans in a trace.",
+            "description": "A span represents a single operation within a trace. Spans can be nested\nto form a trace tree. Often, a trace contains a root span that\ndescribes the end-to-end latency and, optionally, one or more subspans for\nits sub-operations. (A trace could alternatively contain multiple root spans,\nor none at all.) Spans do not need to be contiguous. There may be gaps\nand/or overlaps between spans in a trace.",
             "id": "Span",
             "properties": {
+                "name": {
+                    "description": "Name of the span. The span name is sanitized and displayed in the\nStackdriver Trace tool in the {% dynamic print site_values.console_name %}.\nThe name may be a method name or some other per-call site name.\nFor the same executable and the same call point, a best practice is\nto use a consistent name, which makes it easier to correlate\ncross-trace spans.",
+                    "type": "string"
+                },
                 "stackTrace": {
                     "$ref": "StackTrace",
-                    "description": "Stack trace captured at the start of the span. This is optional."
+                    "description": "Stack trace captured at the start of the span."
                 },
                 "links": {
-                    "description": "A collection of links.",
+                    "description": "A collection of links, which are references from this span to another span\nin a different trace.",
                     "items": {
                         "$ref": "Link"
                     },
                     "type": "array"
                 },
                 "attributes": {
                     "additionalProperties": {
                         "$ref": "AttributeValue"
                     },
-                    "description": "Properties of a span. Attributes at the span level.\nE.g.\n\"/instance_id\": \"my-instance\"\n\"/zone\": \"us-central1-a\"\n\"/grpc/peer_address\": \"ip:port\" (dns, etc.)\n\"/grpc/deadline\": \"Duration\"\n\"/http/user_agent\"\n\"/http/request_bytes\": 300\n\"/http/response_bytes\": 1200\n\"/http/url\": google.com/apis\n\"/pid\"\n\"abc.com/myattribute\": \"my attribute value\"\n\nMaximum length for attribute key is 128 characters, for string attribute\nvalue is 2K characters.",
+                    "description": "Properties of a span in key:value format. The maximum length for the\nkey is 128 characters. The value can be a string (up to 2000 characters),\nint, or boolean.\n\nSome common pair examples:\n\n    \"/instance_id\": \"my-instance\"\n    \"/zone\": \"us-central1-a\"\n    \"/grpc/peer_address\": \"ip:port\" (dns, etc.)\n    \"/grpc/deadline\": \"Duration\"\n    \"/http/user_agent\"\n    \"/http/request_bytes\": 300\n    \"/http/response_bytes\": 1200\n    \"/http/url\": google.com/apis\n    \"abc.com/myattribute\": true",
                     "type": "object"
                 },
                 "id": {
                     "description": "Identifier for the span. Must be a 64-bit integer other than 0 and\nunique within a trace.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "localStartTime": {
-                    "description": "Local machine clock time from the UNIX epoch,\nat which span execution started.\nOn the server side these are the times when the server application\nhandler starts running.",
+                    "description": "Start time of the span.\nOn the client side, this is the local machine clock time at which the span\nexecution was started; on the server\nside, this is the time at which the server application handler started\nrunning.",
                     "format": "google-datetime",
                     "type": "string"
                 },
                 "hasRemoteParent": {
-                    "description": "True if this Span has a remote parent (is an RPC server Span).",
+                    "description": "True if this span has a remote parent (is an RPC server span).",
                     "type": "boolean"
                 },
-                "localEndTime": {
-                    "description": "Local machine clock time from the UNIX epoch,\nat which span execution ended.\nOn the server side these are the times when the server application\nhandler finishes running.",
-                    "format": "google-datetime",
-                    "type": "string"
-                },
-                "parentId": {
-                    "description": "ID of parent span. 0 or missing if this is a root span.",
-                    "format": "uint64",
-                    "type": "string"
-                },
                 "timeEvents": {
-                    "description": "A collection of time-stamped events.",
+                    "description": "A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation\non the span, consisting of either user-supplied key:value pairs, or\ndetails of an RPC message sent/received on the network.",
                     "items": {
                         "$ref": "TimeEvent"
                     },
                     "type": "array"
                 },
+                "localEndTime": {
+                    "description": "End time of the span.\nOn the client side, this is the local machine clock time at which the span\nexecution was ended; on the server\nside, this is the time at which the server application handler stopped\nrunning.",
+                    "format": "google-datetime",
+                    "type": "string"
+                },
+                "parentId": {
+                    "description": "ID of the parent span. If this is a root span, the value must be `0` or\nempty.",
+                    "format": "uint64",
+                    "type": "string"
+                },
                 "status": {
                     "$ref": "Status",
-                    "description": "The final status of the Span. This is optional."
-                },
-                "name": {
-                    "description": "Name of the span. The span name is sanitized and displayed in the\nStackdriver Trace tool in the {% dynamic print site_values.console_name %}.\nThe name may be a method name or some other per-call site name.\nFor the same executable and the same call point, a best practice is\nto use a consistent name, which makes it easier to correlate\ncross-trace spans.",
-                    "type": "string"
+                    "description": "An optional final status for this span."
                 }
             },
             "type": "object"
         },
         "Empty": {
             "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n    service Foo {\n      rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n    }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
             "id": "Empty",
             "properties": {},
             "type": "object"
         },
         "AttributeValue": {
-            "description": "Allowed attribute values.",
+            "description": "The allowed types for the value side of an attribute key:value pair.",
             "id": "AttributeValue",
             "properties": {
+                "intValue": {
+                    "description": "An integer value.",
+                    "format": "int64",
+                    "type": "string"
+                },
                 "stringValue": {
                     "description": "A string value.",
                     "type": "string"
                 },
                 "boolValue": {
                     "description": "A boolean value.",
                     "type": "boolean"
-                },
-                "intValue": {
-                    "description": "An integer value.",
-                    "format": "int64",
-                    "type": "string"
                 }
             },
             "type": "object"
         },
         "BatchUpdateSpansRequest": {
             "description": "The request message for the `BatchUpdateSpans` method.",
             "id": "BatchUpdateSpansRequest",
             "properties": {
                 "spanUpdates": {
                     "additionalProperties": {
                         "$ref": "SpanUpdates"
                     },
                     "description": "A map from trace name to spans to be stored or updated.",
                     "type": "object"
                 }
             },
             "type": "object"
-        },
-        "StackTrace": {
-            "description": "StackTrace collected in a trace.",
-            "id": "StackTrace",
-            "properties": {
-                "stackFrame": {
-                    "description": "Stack frames of this stack trace.",
-                    "items": {
-                        "$ref": "StackFrame"
-                    },
-                    "type": "array"
-                },
-                "stackTraceHashId": {
-                    "description": "User can choose to use their own hash function to hash large attributes to\nsave network bandwidth and storage.\nTypical usage is to pass both stack_frame and stack_trace_hash_id initially\nto inform the storage of the mapping. And in subsequent calls, pass in\nstack_trace_hash_id only. User shall verify the hash value is\nsuccessfully stored.",
-                    "format": "uint64",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
-        "TimeEvent": {
-            "description": "A time-stamped annotation in the Span.",
-            "id": "TimeEvent",
-            "properties": {
-                "networkEvent": {
-                    "$ref": "NetworkEvent",
-                    "description": "Optional field that can be used only for network events."
-                },
-                "annotation": {
-                    "$ref": "Annotation",
-                    "description": "Optional field for user supplied <string, AttributeValue> map"
-                },
-                "localTime": {
-                    "description": "The local machine absolute timestamp when this event happened.",
-                    "format": "google-datetime",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
-        "NetworkEvent": {
-            "description": "An event describing an RPC message sent/received on the network.",
-            "id": "NetworkEvent",
-            "properties": {
-                "messageSize": {
-                    "description": "Number of bytes send/receive.",
-                    "format": "uint64",
-                    "type": "string"
-                },
-                "kernelTime": {
-                    "description": "If available, this is the kernel time:\nFor sent messages, this is the time at which the first bit was sent.\nFor received messages, this is the time at which the last bit was\nreceived.",
-                    "format": "google-datetime",
-                    "type": "string"
-                },
-                "type": {
-                    "description": "Type of a NetworkEvent.",
-                    "enum": [
-                        "TYPE_UNSPECIFIED",
-                        "SENT",
-                        "RECV"
-                    ],
-                    "enumDescriptions": [
-                        "Unknown event.",
-                        "Event type for sending RPC message.",
-                        "Event type for receiving RPC message."
-                    ],
-                    "type": "string"
-                },
-                "messageId": {
-                    "description": "Every message has an identifier, which must be different from all the\nnetwork messages in this span.\nThis is especially important when the request/response are streamed.",
-                    "format": "uint64",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
-        "ListSpansResponse": {
-            "description": "The response message for the 'ListSpans' method.",
-            "id": "ListSpansResponse",
-            "properties": {
-                "spans": {
-                    "description": "The requested spans if they are any in the specified trace.",
-                    "items": {
-                        "$ref": "Span"
-                    },
-                    "type": "array"
-                },
-                "nextPageToken": {
-                    "description": "If defined, indicates that there are more spans that match the request\nand that this value should be passed to the next request to continue\nretrieving additional spans.",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
-        "SpanUpdates": {
-            "description": "Collection of spans to update.",
-            "id": "SpanUpdates",
-            "properties": {
-                "spans": {
-                    "description": "A collection of spans.",
-                    "items": {
-                        "$ref": "Span"
-                    },
-                    "type": "array"
-                }
-            },
-            "type": "object"
-        },
-        "StackFrame": {
-            "description": "Presents a single stack frame in a stack trace.",
-            "id": "StackFrame",
-            "properties": {
-                "originalFunctionName": {
-                    "description": "Used when function name is ‘mangled’. Not guaranteed to be fully\nqualified but usually it is.",
-                    "type": "string"
-                },
-                "functionName": {
-                    "description": "Fully qualified names which uniquely identify function/method/etc.",
-                    "type": "string"
-                },
-                "lineNumber": {
-                    "description": "Line number of the frame.",
-                    "format": "int64",
-                    "type": "string"
-                },
-                "loadModule": {
-                    "$ref": "Module",
-                    "description": "Binary module the code is loaded from."
-                },
-                "columnNumber": {
-                    "description": "Column number is important in JavaScript(anonymous functions),\nMight not be available in some languages.",
-                    "format": "int64",
-                    "type": "string"
-                },
-                "fileName": {
-                    "description": "File name of the frame.",
-                    "type": "string"
-                },
-                "sourceVersion": {
-                    "description": "source_version is deployment specific. It might be\nbetter to be stored in deployment metadata.",
-                    "type": "string"
-                }
-            },
-            "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Tracing API",
     "version": "v1"
 }