Google Cloud Trace API — Projects

naftiko: 1.0.0-alpha2
info:
  label: Google Cloud Trace API — Projects
  description: 'Google Cloud Trace API — Projects. 5 operations. Lead operation: Google Cloud Trace List Traces. Self-contained
    Naftiko capability covering one Google Cloud Trace business surface.'
  tags:
  - Google Cloud Trace
  - Projects
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GOOGLE_CLOUD_TRACE_API_KEY: GOOGLE_CLOUD_TRACE_API_KEY
capability:
  consumes:
  - type: http
    namespace: openapi-projects
    baseUri: https://cloudtrace.googleapis.com
    description: Google Cloud Trace API — Projects business capability. Self-contained, no shared references.
    resources:
    - name: v1-projects-projectId-traces
      path: /v1/projects/{projectId}/traces
      operations:
      - name: listtraces
        method: GET
        description: Google Cloud Trace List Traces
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectId
          in: path
          type: string
          required: true
        - name: filter
          in: query
          type: string
          description: Optional filter for the traces.
        - name: startTime
          in: query
          type: string
        - name: endTime
          in: query
          type: string
        - name: pageSize
          in: query
          type: integer
        - name: pageToken
          in: query
          type: string
      - name: patchtraces
        method: PATCH
        description: Google Cloud Trace Patch Traces
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-projects-projectId-traces-traceId
      path: /v1/projects/{projectId}/traces/{traceId}
      operations:
      - name: gettrace
        method: GET
        description: Google Cloud Trace Get Trace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectId
          in: path
          type: string
          required: true
        - name: traceId
          in: path
          type: string
          required: true
    - name: v2-projects-projectId-traces-traceId-spans
      path: /v2/projects/{projectId}/traces/{traceId}/spans
      operations:
      - name: createspan
        method: POST
        description: Google Cloud Trace Create Span
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectId
          in: path
          type: string
          required: true
        - name: traceId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-projects-projectId-traces:batchWrite
      path: /v2/projects/{projectId}/traces:batchWrite
      operations:
      - name: batchwritespans
        method: POST
        description: Google Cloud Trace Batch Write Spans
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  exposes:
  - type: rest
    namespace: openapi-projects-rest
    port: 8080
    description: REST adapter for Google Cloud Trace API — Projects. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1/projects/{projectid}/traces
      name: v1-projects-projectid-traces
      description: REST surface for v1-projects-projectId-traces.
      operations:
      - method: GET
        name: listtraces
        description: Google Cloud Trace List Traces
        call: openapi-projects.listtraces
        with:
          projectId: rest.projectId
          filter: rest.filter
          startTime: rest.startTime
          endTime: rest.endTime
          pageSize: rest.pageSize
          pageToken: rest.pageToken
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: patchtraces
        description: Google Cloud Trace Patch Traces
        call: openapi-projects.patchtraces
        with:
          projectId: rest.projectId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/projects/{projectid}/traces/{traceid}
      name: v1-projects-projectid-traces-traceid
      description: REST surface for v1-projects-projectId-traces-traceId.
      operations:
      - method: GET
        name: gettrace
        description: Google Cloud Trace Get Trace
        call: openapi-projects.gettrace
        with:
          projectId: rest.projectId
          traceId: rest.traceId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/projects/{projectid}/traces/{traceid}/spans
      name: v2-projects-projectid-traces-traceid-spans
      description: REST surface for v2-projects-projectId-traces-traceId-spans.
      operations:
      - method: POST
        name: createspan
        description: Google Cloud Trace Create Span
        call: openapi-projects.createspan
        with:
          projectId: rest.projectId
          traceId: rest.traceId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/projects/{projectid}/traces-batchwrite
      name: v2-projects-projectid-traces-batchwrite
      description: REST surface for v2-projects-projectId-traces:batchWrite.
      operations:
      - method: POST
        name: batchwritespans
        description: Google Cloud Trace Batch Write Spans
        call: openapi-projects.batchwritespans
        with:
          projectId: rest.projectId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: openapi-projects-mcp
    port: 9090
    transport: http
    description: MCP adapter for Google Cloud Trace API — Projects. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: google-cloud-trace-list-traces
      description: Google Cloud Trace List Traces
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: openapi-projects.listtraces
      with:
        projectId: tools.projectId
        filter: tools.filter
        startTime: tools.startTime
        endTime: tools.endTime
        pageSize: tools.pageSize
        pageToken: tools.pageToken
      outputParameters:
      - type: object
        mapping: $.
    - name: google-cloud-trace-patch-traces
      description: Google Cloud Trace Patch Traces
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: openapi-projects.patchtraces
      with:
        projectId: tools.projectId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: google-cloud-trace-get-trace
      description: Google Cloud Trace Get Trace
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: openapi-projects.gettrace
      with:
        projectId: tools.projectId
        traceId: tools.traceId
      outputParameters:
      - type: object
        mapping: $.
    - name: google-cloud-trace-create-span
      description: Google Cloud Trace Create Span
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: openapi-projects.createspan
      with:
        projectId: tools.projectId
        traceId: tools.traceId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: google-cloud-trace-batch-write
      description: Google Cloud Trace Batch Write Spans
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: openapi-projects.batchwritespans
      with:
        projectId: tools.projectId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.