fix(cloudtrace): update the API

#### cloudtrace:v1

The following keys were changed:
- resources.projects.methods.patchTraces.description

#### cloudtrace:v2

The following keys were changed:
- resources.projects.resources.traces.methods.batchWrite.description
- resources.projects.resources.traces.resources.spans.methods.createSpan.description

Author: yoshi-automation

discovery/cloudtrace-v1.json

@@ -114,7 +114,7 @@
     "projects": {
       "methods": {
         "patchTraces": {
-          "description": "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.",
+          "description": "Sends trace spans to Cloud Trace. Spans cannot be updated. If the trace ID and span ID already exist, an additional copy of the span will be stored.",
           "flatPath": "v1/projects/{projectId}/traces",
           "httpMethod": "PATCH",
           "id": "cloudtrace.projects.patchTraces",
@@ -257,7 +257,7 @@
       }
     }
   },
-  "revision": "20240816",
+  "revision": "20250411",
   "rootUrl": "https://cloudtrace.googleapis.com/",
   "schemas": {
     "Empty": {

discovery/cloudtrace-v2.json

@@ -113,7 +113,7 @@
         "traces": {
           "methods": {
             "batchWrite": {
-              "description": "Batch writes new spans to new or existing traces. You cannot update existing spans.",
+              "description": "Batch writes new spans to new or existing traces. You cannot update existing spans. If a span ID already exists, an additional copy of the span will be stored.",
               "flatPath": "v2/projects/{projectsId}/traces:batchWrite",
               "httpMethod": "POST",
               "id": "cloudtrace.projects.traces.batchWrite",
@@ -146,7 +146,7 @@
             "spans": {
               "methods": {
                 "createSpan": {
-                  "description": "Creates a new span.",
+                  "description": "Creates a new span. If a span ID already exists, an additional copy of the span will be stored.",
                   "flatPath": "v2/projects/{projectsId}/traces/{tracesId}/spans/{spansId}",
                   "httpMethod": "POST",
                   "id": "cloudtrace.projects.traces.spans.createSpan",
@@ -181,7 +181,7 @@
       }
     }
   },
-  "revision": "20230608",
+  "revision": "20250411",
   "rootUrl": "https://cloudtrace.googleapis.com/",
   "schemas": {
     "Annotation": {

src/apis/cloudtrace/v1.ts

@@ -210,7 +210,7 @@ export namespace cloudtrace_v1 {
     }
 
     /**
-     * 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.
+     * Sends trace spans to Cloud Trace. Spans cannot be updated. If the trace ID and span ID already exist, an additional copy of the span will be stored.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.

src/apis/cloudtrace/v2.ts

@@ -451,7 +451,7 @@ export namespace cloudtrace_v2 {
     }
 
     /**
-     * Batch writes new spans to new or existing traces. You cannot update existing spans.
+     * Batch writes new spans to new or existing traces. You cannot update existing spans. If a span ID already exists, an additional copy of the span will be stored.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -559,7 +559,7 @@ export namespace cloudtrace_v2 {
     }
 
     /**
-     * Creates a new span.
+     * Creates a new span. If a span ID already exists, an additional copy of the span will be stored.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.