Google Analytics Data API — properties

naftiko: 1.0.0-alpha2
info:
  label: Google Analytics Data API — properties
  description: 'Google Analytics Data API — properties. 10 operations. Lead operation: properties. Self-contained Naftiko
    capability covering one Google Analytics business surface.'
  tags:
  - Google Analytics
  - properties
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GOOGLE_ANALYTICS_API_KEY: GOOGLE_ANALYTICS_API_KEY
capability:
  consumes:
  - type: http
    namespace: data-properties
    baseUri: https://analyticsdata.googleapis.com
    description: Google Analytics Data API — properties business capability. Self-contained, no shared references.
    resources:
    - name: v1beta-name
      path: /v1beta/{name}
      operations:
      - name: analyticsdatapropertiesaudienceexportsget
        method: GET
        description: Gets configuration metadata about a specific audience export. This method can be used to understand an
          audience export after it has been created. See [Creating an Audience Export](https://developers.google.com/analytics/devguides/reporting/
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: 'Required. The audience export resource name. Format: `properties/{property}/audienceExports/{audience_export}`'
          required: true
    - name: v1beta-name}:query
      path: /v1beta/{name}:query
      operations:
      - name: analyticsdatapropertiesaudienceexportsquery
        method: POST
        description: Retrieves an audience export of users. After creating an audience, the users are not immediately available
          for exporting. First, a request to `CreateAudienceExport` is necessary to create an audience export of users, and
          then second, this m
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: 'Required. The name of the audience export to retrieve users from. Format: `properties/{property}/audienceExports/{audience_export}`'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1beta-parent-audienceExports
      path: /v1beta/{parent}/audienceExports
      operations:
      - name: analyticsdatapropertiesaudienceexportslist
        method: GET
        description: Lists all audience exports for a property. This method can be used for you to find and reuse existing
          audience exports rather than creating unnecessary new audience exports. The same audience can have multiple audience
          exports that represen
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: parent
          in: path
          type: string
          description: 'Required. All audience exports for this property will be listed in the response. Format: `properties/{property}`'
          required: true
        - name: pageSize
          in: query
          type: integer
          description: Optional. The maximum number of audience exports to return. The service may return fewer than this
            value. If unspecified, at most 200 audience exports will be r
        - name: pageToken
          in: query
          type: string
          description: Optional. A page token, received from a previous `ListAudienceExports` call. Provide this to retrieve
            the subsequent page. When paginating, all other parameters
      - name: analyticsdatapropertiesaudienceexportscreate
        method: POST
        description: Creates an audience export for later retrieval. This method quickly returns the audience export's resource
          name and initiates a long running asynchronous request to form an audience export. To export the users in an audience
          export, first c
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: parent
          in: path
          type: string
          description: 'Required. The parent resource where this audience export will be created. Format: `properties/{property}`'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1beta-property}:batchRunPivotReports
      path: /v1beta/{property}:batchRunPivotReports
      operations:
      - name: analyticsdatapropertiesbatchrunpivotreports
        method: POST
        description: Returns multiple pivot reports in a batch. All reports must be for the same GA4 Property.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: property
          in: path
          type: string
          description: A Google Analytics GA4 property identifier whose events are tracked. Specified in the URL path and
            not the body. To learn more, see [where to find your Property
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1beta-property}:batchRunReports
      path: /v1beta/{property}:batchRunReports
      operations:
      - name: analyticsdatapropertiesbatchrunreports
        method: POST
        description: Returns multiple reports in a batch. All reports must be for the same GA4 Property.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: property
          in: path
          type: string
          description: A Google Analytics GA4 property identifier whose events are tracked. Specified in the URL path and
            not the body. To learn more, see [where to find your Property
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1beta-property}:checkCompatibility
      path: /v1beta/{property}:checkCompatibility
      operations:
      - name: analyticsdatapropertiescheckcompatibility
        method: POST
        description: This compatibility method lists dimensions and metrics that can be added to a report request and maintain
          compatibility. This method fails if the request's dimensions and metrics are incompatible. In Google Analytics,
          reports fail if they r
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: property
          in: path
          type: string
          description: A Google Analytics GA4 property identifier whose events are tracked. To learn more, see [where to find
            your Property ID](https://developers.google.com/analytics
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1beta-property}:runPivotReport
      path: /v1beta/{property}:runPivotReport
      operations:
      - name: analyticsdatapropertiesrunpivotreport
        method: POST
        description: Returns a customized pivot report of your Google Analytics event data. Pivot reports are more advanced
          and expressive formats than regular reports. In a pivot report, dimensions are only visible if they are included
          in a pivot. Multiple piv
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: property
          in: path
          type: string
          description: A Google Analytics GA4 property identifier whose events are tracked. Specified in the URL path and
            not the body. To learn more, see [where to find your Property
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1beta-property}:runRealtimeReport
      path: /v1beta/{property}:runRealtimeReport
      operations:
      - name: analyticsdatapropertiesrunrealtimereport
        method: POST
        description: Returns a customized report of realtime event data for your property. Events appear in realtime reports
          seconds after they have been sent to the Google Analytics. Realtime reports show events and usage data for the periods
          of time ranging f
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: property
          in: path
          type: string
          description: A Google Analytics GA4 property identifier whose events are tracked. Specified in the URL path and
            not the body. To learn more, see [where to find your Property
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1beta-property}:runReport
      path: /v1beta/{property}:runReport
      operations:
      - name: analyticsdatapropertiesrunreport
        method: POST
        description: Returns a customized report of your Google Analytics event data. Reports contain statistics derived from
          data collected by the Google Analytics tracking code. The data returned from the API is as a table with columns
          for the requested dimen
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: property
          in: path
          type: string
          description: A Google Analytics GA4 property identifier whose events are tracked. Specified in the URL path and
            not the body. To learn more, see [where to find your Property
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: bearer
      token: '{{env.GOOGLE_ANALYTICS_API_KEY}}'
  exposes:
  - type: rest
    namespace: data-properties-rest
    port: 8080
    description: REST adapter for Google Analytics Data API — properties. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1beta/{name}
      name: v1beta-name
      description: REST surface for v1beta-name.
      operations:
      - method: GET
        name: analyticsdatapropertiesaudienceexportsget
        description: Gets configuration metadata about a specific audience export. This method can be used to understand an
          audience export after it has been created. See [Creating an Audience Export](https://developers.google.com/analytics/devguides/reporting/
        call: data-properties.analyticsdatapropertiesaudienceexportsget
        with:
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1beta/name-query
      name: v1beta-name-query
      description: REST surface for v1beta-name}:query.
      operations:
      - method: POST
        name: analyticsdatapropertiesaudienceexportsquery
        description: Retrieves an audience export of users. After creating an audience, the users are not immediately available
          for exporting. First, a request to `CreateAudienceExport` is necessary to create an audience export of users, and
          then second, this m
        call: data-properties.analyticsdatapropertiesaudienceexportsquery
        with:
          name: rest.name
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1beta/{parent}/audienceexports
      name: v1beta-parent-audienceexports
      description: REST surface for v1beta-parent-audienceExports.
      operations:
      - method: GET
        name: analyticsdatapropertiesaudienceexportslist
        description: Lists all audience exports for a property. This method can be used for you to find and reuse existing
          audience exports rather than creating unnecessary new audience exports. The same audience can have multiple audience
          exports that represen
        call: data-properties.analyticsdatapropertiesaudienceexportslist
        with:
          parent: rest.parent
          pageSize: rest.pageSize
          pageToken: rest.pageToken
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: analyticsdatapropertiesaudienceexportscreate
        description: Creates an audience export for later retrieval. This method quickly returns the audience export's resource
          name and initiates a long running asynchronous request to form an audience export. To export the users in an audience
          export, first c
        call: data-properties.analyticsdatapropertiesaudienceexportscreate
        with:
          parent: rest.parent
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1beta/property-batchrunpivotreports
      name: v1beta-property-batchrunpivotreports
      description: REST surface for v1beta-property}:batchRunPivotReports.
      operations:
      - method: POST
        name: analyticsdatapropertiesbatchrunpivotreports
        description: Returns multiple pivot reports in a batch. All reports must be for the same GA4 Property.
        call: data-properties.analyticsdatapropertiesbatchrunpivotreports
        with:
          property: rest.property
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1beta/property-batchrunreports
      name: v1beta-property-batchrunreports
      description: REST surface for v1beta-property}:batchRunReports.
      operations:
      - method: POST
        name: analyticsdatapropertiesbatchrunreports
        description: Returns multiple reports in a batch. All reports must be for the same GA4 Property.
        call: data-properties.analyticsdatapropertiesbatchrunreports
        with:
          property: rest.property
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1beta/property-checkcompatibility
      name: v1beta-property-checkcompatibility
      description: REST surface for v1beta-property}:checkCompatibility.
      operations:
      - method: POST
        name: analyticsdatapropertiescheckcompatibility
        description: This compatibility method lists dimensions and metrics that can be added to a report request and maintain
          compatibility. This method fails if the request's dimensions and metrics are incompatible. In Google Analytics,
          reports fail if they r
        call: data-properties.analyticsdatapropertiescheckcompatibility
        with:
          property: rest.property
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1beta/property-runpivotreport
      name: v1beta-property-runpivotreport
      description: REST surface for v1beta-property}:runPivotReport.
      operations:
      - method: POST
        name: analyticsdatapropertiesrunpivotreport
        description: Returns a customized pivot report of your Google Analytics event data. Pivot reports are more advanced
          and expressive formats than regular reports. In a pivot report, dimensions are only visible if they are included
          in a pivot. Multiple piv
        call: data-properties.analyticsdatapropertiesrunpivotreport
        with:
          property: rest.property
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1beta/property-runrealtimereport
      name: v1beta-property-runrealtimereport
      description: REST surface for v1beta-property}:runRealtimeReport.
      operations:
      - method: POST
        name: analyticsdatapropertiesrunrealtimereport
        description: Returns a customized report of realtime event data for your property. Events appear in realtime reports
          seconds after they have been sent to the Google Analytics. Realtime reports show events and usage data for the periods
          of time ranging f
        call: data-properties.analyticsdatapropertiesrunrealtimereport
        with:
          property: rest.property
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1beta/property-runreport
      name: v1beta-property-runreport
      description: REST surface for v1beta-property}:runReport.
      operations:
      - method: POST
        name: analyticsdatapropertiesrunreport
        description: Returns a customized report of your Google Analytics event data. Reports contain statistics derived from
          data collected by the Google Analytics tracking code. The data returned from the API is as a table with columns
          for the requested dimen
        call: data-properties.analyticsdatapropertiesrunreport
        with:
          property: rest.property
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: data-properties-mcp
    port: 9090
    transport: http
    description: MCP adapter for Google Analytics Data API — properties. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: gets-configuration-metadata-about-specific
      description: Gets configuration metadata about a specific audience export. This method can be used to understand an
        audience export after it has been created. See [Creating an Audience Export](https://developers.google.com/analytics/devguides/reporting/
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-properties.analyticsdatapropertiesaudienceexportsget
      with:
        name: tools.name
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieves-audience-export-users-after
      description: Retrieves an audience export of users. After creating an audience, the users are not immediately available
        for exporting. First, a request to `CreateAudienceExport` is necessary to create an audience export of users, and
        then second, this m
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: data-properties.analyticsdatapropertiesaudienceexportsquery
      with:
        name: tools.name
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: lists-all-audience-exports-property
      description: Lists all audience exports for a property. This method can be used for you to find and reuse existing audience
        exports rather than creating unnecessary new audience exports. The same audience can have multiple audience exports
        that represen
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-properties.analyticsdatapropertiesaudienceexportslist
      with:
        parent: tools.parent
        pageSize: tools.pageSize
        pageToken: tools.pageToken
      outputParameters:
      - type: object
        mapping: $.
    - name: creates-audience-export-later-retrieval
      description: Creates an audience export for later retrieval. This method quickly returns the audience export's resource
        name and initiates a long running asynchronous request to form an audience export. To export the users in an audience
        export, first c
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-properties.analyticsdatapropertiesaudienceexportscreate
      with:
        parent: tools.parent
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-multiple-pivot-reports-batch
      description: Returns multiple pivot reports in a batch. All reports must be for the same GA4 Property.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-properties.analyticsdatapropertiesbatchrunpivotreports
      with:
        property: tools.property
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-multiple-reports-batch-all
      description: Returns multiple reports in a batch. All reports must be for the same GA4 Property.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-properties.analyticsdatapropertiesbatchrunreports
      with:
        property: tools.property
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: this-compatibility-method-lists-dimensions
      description: This compatibility method lists dimensions and metrics that can be added to a report request and maintain
        compatibility. This method fails if the request's dimensions and metrics are incompatible. In Google Analytics, reports
        fail if they r
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-properties.analyticsdatapropertiescheckcompatibility
      with:
        property: tools.property
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-customized-pivot-report-your
      description: Returns a customized pivot report of your Google Analytics event data. Pivot reports are more advanced
        and expressive formats than regular reports. In a pivot report, dimensions are only visible if they are included in
        a pivot. Multiple piv
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-properties.analyticsdatapropertiesrunpivotreport
      with:
        property: tools.property
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-customized-report-realtime-event
      description: Returns a customized report of realtime event data for your property. Events appear in realtime reports
        seconds after they have been sent to the Google Analytics. Realtime reports show events and usage data for the periods
        of time ranging f
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-properties.analyticsdatapropertiesrunrealtimereport
      with:
        property: tools.property
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-customized-report-your-google
      description: Returns a customized report of your Google Analytics event data. Reports contain statistics derived from
        data collected by the Google Analytics tracking code. The data returned from the API is as a table with columns for
        the requested dimen
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-properties.analyticsdatapropertiesrunreport
      with:
        property: tools.property
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.