naftiko: 1.0.0-alpha2
info:
  label: Google Data Studio Looker Studio Linking API — Reports
  description: 'Google Data Studio Looker Studio Linking API — Reports. 1 operations. Lead operation: Google Data Studio Create
    a pre-configured Looker Studio report. Self-contained Naftiko capability covering one Google Data Studio business surface.'
  tags:
  - Google Data Studio
  - Reports
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GOOGLE_DATA_STUDIO_API_KEY: GOOGLE_DATA_STUDIO_API_KEY
capability:
  consumes:
  - type: http
    namespace: linking-reports
    baseUri: https://lookerstudio.google.com
    description: Google Data Studio Looker Studio Linking API — Reports business capability. Self-contained, no shared references.
    resources:
    - name: reporting-create
      path: /reporting/create
      operations:
      - name: createreport
        method: GET
        description: Google Data Studio Create a pre-configured Looker Studio report
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: c.reportId
          in: query
          type: string
          description: The template report ID. If omitted, a blank report is created.
        - name: c.pageId
          in: query
          type: string
          description: Specifies the initial page to load in the report.
        - name: c.mode
          in: query
          type: string
          description: Sets the initial mode of the report on load. Accepts "view" or "edit".
        - name: c.explain
          in: query
          type: boolean
          description: Enables the debug/info dialog for troubleshooting. Set to true to display debug information.
        - name: r.reportName
          in: query
          type: string
          description: Overrides the template report name with the specified value.
        - name: r.measurementId
          in: query
          type: string
          description: Sets Google Analytics Measurement IDs for the report.
        - name: r.keepMeasurementId
          in: query
          type: boolean
          description: When true, preserves the template's measurement IDs instead of replacing them.
        - name: ds.ds0.datasourceName
          in: query
          type: string
          description: Sets the display name of the data source. The alias (e.g., ds0) identifies which data source in the
            template to configure.
        - name: ds.ds0.connector
          in: query
          type: string
          description: Specifies the connector type for the data source. When set, the data source configuration is completely
            replaced (all required parameters must be provided). Whe
        - name: ds.ds0.refreshFields
          in: query
          type: boolean
          description: Controls field refresh behavior. Set to true to refresh fields when the data source configuration changes.
        - name: ds.ds0.projectId
          in: query
          type: string
          description: Google Cloud project ID. Used with BigQuery and Cloud Spanner connectors.
        - name: ds.ds0.datasetId
          in: query
          type: string
          description: BigQuery dataset ID. Used with the BigQuery TABLE type.
        - name: ds.ds0.tableId
          in: query
          type: string
          description: BigQuery table ID. Used with the BigQuery TABLE type.
        - name: ds.ds0.type
          in: query
          type: string
          description: BigQuery query type. Accepts TABLE or CUSTOM_QUERY.
        - name: ds.ds0.sql
          in: query
          type: string
          description: SQL query string for BigQuery CUSTOM_QUERY type or Cloud Spanner connector.
        - name: ds.ds0.spreadsheetId
          in: query
          type: string
          description: Google Sheets spreadsheet ID.
        - name: ds.ds0.worksheetId
          in: query
          type: string
          description: Google Sheets worksheet ID.
        - name: ds.ds0.hasHeader
          in: query
          type: boolean
          description: Whether the Google Sheet has a header row. Defaults to true.
        - name: ds.ds0.range
          in: query
          type: string
          description: Cell range to use from the Google Sheet (e.g., A1:D100).
        - name: ds.ds0.accountId
          in: query
          type: string
          description: Google Analytics account ID.
        - name: ds.ds0.propertyId
          in: query
          type: string
          description: Google Analytics property ID.
        - name: ds.ds0.viewId
          in: query
          type: string
          description: Google Analytics view ID. Required for Universal Analytics only.
        - name: ds.ds0.instanceId
          in: query
          type: string
          description: Cloud Spanner instance ID.
        - name: ds.ds0.databaseId
          in: query
          type: string
          description: Cloud Spanner database ID.
        - name: ds.ds0.instanceUrl
          in: query
          type: string
          description: Looker instance URL.
        - name: ds.ds0.model
          in: query
          type: string
          description: Looker model name.
        - name: ds.ds0.explore
          in: query
          type: string
          description: Looker explore name.
        - name: ds.ds0.siteUrl
          in: query
          type: string
          description: Google Search Console site URL.
        - name: ds.ds0.tableType
          in: query
          type: string
          description: Search Console table type.
        - name: ds.ds0.searchType
          in: query
          type: string
          description: Search Console search type.
        - name: ds.ds0.pathType
          in: query
          type: string
          description: Google Cloud Storage path type. Accepts FILE or FOLDER.
        - name: ds.ds0.path
          in: query
          type: string
          description: Google Cloud Storage file or folder path.
        - name: ds.ds0.connectorId
          in: query
          type: string
          description: Community connector ID. Used to specify a community-built connector along with any connector-specific
            parameters.
  exposes:
  - type: rest
    namespace: linking-reports-rest
    port: 8080
    description: REST adapter for Google Data Studio Looker Studio Linking API — Reports. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/reporting/create
      name: reporting-create
      description: REST surface for reporting-create.
      operations:
      - method: GET
        name: createreport
        description: Google Data Studio Create a pre-configured Looker Studio report
        call: linking-reports.createreport
        with:
          c.reportId: rest.c.reportId
          c.pageId: rest.c.pageId
          c.mode: rest.c.mode
          c.explain: rest.c.explain
          r.reportName: rest.r.reportName
          r.measurementId: rest.r.measurementId
          r.keepMeasurementId: rest.r.keepMeasurementId
          ds.ds0.datasourceName: rest.ds.ds0.datasourceName
          ds.ds0.connector: rest.ds.ds0.connector
          ds.ds0.refreshFields: rest.ds.ds0.refreshFields
          ds.ds0.projectId: rest.ds.ds0.projectId
          ds.ds0.datasetId: rest.ds.ds0.datasetId
          ds.ds0.tableId: rest.ds.ds0.tableId
          ds.ds0.type: rest.ds.ds0.type
          ds.ds0.sql: rest.ds.ds0.sql
          ds.ds0.spreadsheetId: rest.ds.ds0.spreadsheetId
          ds.ds0.worksheetId: rest.ds.ds0.worksheetId
          ds.ds0.hasHeader: rest.ds.ds0.hasHeader
          ds.ds0.range: rest.ds.ds0.range
          ds.ds0.accountId: rest.ds.ds0.accountId
          ds.ds0.propertyId: rest.ds.ds0.propertyId
          ds.ds0.viewId: rest.ds.ds0.viewId
          ds.ds0.instanceId: rest.ds.ds0.instanceId
          ds.ds0.databaseId: rest.ds.ds0.databaseId
          ds.ds0.instanceUrl: rest.ds.ds0.instanceUrl
          ds.ds0.model: rest.ds.ds0.model
          ds.ds0.explore: rest.ds.ds0.explore
          ds.ds0.siteUrl: rest.ds.ds0.siteUrl
          ds.ds0.tableType: rest.ds.ds0.tableType
          ds.ds0.searchType: rest.ds.ds0.searchType
          ds.ds0.pathType: rest.ds.ds0.pathType
          ds.ds0.path: rest.ds.ds0.path
          ds.ds0.connectorId: rest.ds.ds0.connectorId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: linking-reports-mcp
    port: 9090
    transport: http
    description: MCP adapter for Google Data Studio Looker Studio Linking API — Reports. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: google-data-studio-create-pre
      description: Google Data Studio Create a pre-configured Looker Studio report
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: linking-reports.createreport
      with:
        c.reportId: tools.c.reportId
        c.pageId: tools.c.pageId
        c.mode: tools.c.mode
        c.explain: tools.c.explain
        r.reportName: tools.r.reportName
        r.measurementId: tools.r.measurementId
        r.keepMeasurementId: tools.r.keepMeasurementId
        ds.ds0.datasourceName: tools.ds.ds0.datasourceName
        ds.ds0.connector: tools.ds.ds0.connector
        ds.ds0.refreshFields: tools.ds.ds0.refreshFields
        ds.ds0.projectId: tools.ds.ds0.projectId
        ds.ds0.datasetId: tools.ds.ds0.datasetId
        ds.ds0.tableId: tools.ds.ds0.tableId
        ds.ds0.type: tools.ds.ds0.type
        ds.ds0.sql: tools.ds.ds0.sql
        ds.ds0.spreadsheetId: tools.ds.ds0.spreadsheetId
        ds.ds0.worksheetId: tools.ds.ds0.worksheetId
        ds.ds0.hasHeader: tools.ds.ds0.hasHeader
        ds.ds0.range: tools.ds.ds0.range
        ds.ds0.accountId: tools.ds.ds0.accountId
        ds.ds0.propertyId: tools.ds.ds0.propertyId
        ds.ds0.viewId: tools.ds.ds0.viewId
        ds.ds0.instanceId: tools.ds.ds0.instanceId
        ds.ds0.databaseId: tools.ds.ds0.databaseId
        ds.ds0.instanceUrl: tools.ds.ds0.instanceUrl
        ds.ds0.model: tools.ds.ds0.model
        ds.ds0.explore: tools.ds.ds0.explore
        ds.ds0.siteUrl: tools.ds.ds0.siteUrl
        ds.ds0.tableType: tools.ds.ds0.tableType
        ds.ds0.searchType: tools.ds.ds0.searchType
        ds.ds0.pathType: tools.ds.ds0.pathType
        ds.ds0.path: tools.ds.ds0.path
        ds.ds0.connectorId: tools.ds.ds0.connectorId
      outputParameters:
      - type: object
        mapping: $.