openapi: 3.1.0
info:
  title: Google Data Studio Assets Reports API
  description: The Looker Studio API (formerly Google Data Studio API) enables programmatic management of Looker Studio assets, including searching for assets and managing permissions within Google Workspace or Cloud Identity organizations. The API is only available to users that belong to an organization with Google Workspace or Cloud Identity.
  version: v1
  contact:
    name: Google
    url: https://developers.google.com/looker-studio/integrate/api
  license:
    name: Google APIs Terms of Service
    url: https://developers.google.com/terms
  x-date: '2026-03-04'
servers:
- url: https://datastudio.googleapis.com/v1
  description: Looker Studio API v1 production server
security:
- oauth2: []
tags:
- name: Reports
  description: Operations for creating and configuring pre-built Looker Studio reports
paths:
  /reporting/create:
    get:
      operationId: createReport
      summary: Google Data Studio Create a pre-configured Looker Studio report
      description: Forwards the user to a pre-configured Looker Studio report using URL parameters. The user is presented with a report based on the specified template and data source configuration. Clicking "Edit and share" saves a personal copy to the user's account with full editing and sharing capabilities. Users need view access to the template report. When data source configuration is updated, users need view access to any reusable data sources. Embedded data sources inherit permissions from the report.
      tags:
      - Reports
      parameters:
      - name: c.reportId
        in: query
        required: false
        description: The template report ID. If omitted, a blank report is created.
        schema:
          type: string
      - name: c.pageId
        in: query
        required: false
        description: Specifies the initial page to load in the report.
        schema:
          type: string
      - name: c.mode
        in: query
        required: false
        description: Sets the initial mode of the report on load. Accepts "view" or "edit".
        schema:
          type: string
          enum:
          - view
          - edit
      - name: c.explain
        in: query
        required: false
        description: Enables the debug/info dialog for troubleshooting. Set to true to display debug information.
        schema:
          type: boolean
      - name: r.reportName
        in: query
        required: false
        description: Overrides the template report name with the specified value.
        schema:
          type: string
      - name: r.measurementId
        in: query
        required: false
        description: Sets Google Analytics Measurement IDs for the report.
        schema:
          type: string
      - name: r.keepMeasurementId
        in: query
        required: false
        description: When true, preserves the template's measurement IDs instead of replacing them.
        schema:
          type: boolean
      - name: ds.ds0.datasourceName
        in: query
        required: false
        description: Sets the display name of the data source. The alias (e.g., ds0) identifies which data source in the template to configure.
        schema:
          type: string
      - name: ds.ds0.connector
        in: query
        required: false
        description: Specifies the connector type for the data source. When set, the data source configuration is completely replaced (all required parameters must be provided). When omitted, only specified parameters are updated while others are inherited from the template. Supported connectors include bigQuery, googleSheets, googleAnalytics, cloudSpanner, looker, searchConsole, googleCloudStorage, and community connectors.
        schema:
          type: string
      - name: ds.ds0.refreshFields
        in: query
        required: false
        description: Controls field refresh behavior. Set to true to refresh fields when the data source configuration changes.
        schema:
          type: boolean
      - name: ds.ds0.projectId
        in: query
        required: false
        description: Google Cloud project ID. Used with BigQuery and Cloud Spanner connectors.
        schema:
          type: string
      - name: ds.ds0.datasetId
        in: query
        required: false
        description: BigQuery dataset ID. Used with the BigQuery TABLE type.
        schema:
          type: string
      - name: ds.ds0.tableId
        in: query
        required: false
        description: BigQuery table ID. Used with the BigQuery TABLE type.
        schema:
          type: string
      - name: ds.ds0.type
        in: query
        required: false
        description: BigQuery query type. Accepts TABLE or CUSTOM_QUERY.
        schema:
          type: string
          enum:
          - TABLE
          - CUSTOM_QUERY
      - name: ds.ds0.sql
        in: query
        required: false
        description: SQL query string for BigQuery CUSTOM_QUERY type or Cloud Spanner connector.
        schema:
          type: string
      - name: ds.ds0.spreadsheetId
        in: query
        required: false
        description: Google Sheets spreadsheet ID.
        schema:
          type: string
      - name: ds.ds0.worksheetId
        in: query
        required: false
        description: Google Sheets worksheet ID.
        schema:
          type: string
      - name: ds.ds0.hasHeader
        in: query
        required: false
        description: Whether the Google Sheet has a header row. Defaults to true.
        schema:
          type: boolean
      - name: ds.ds0.range
        in: query
        required: false
        description: Cell range to use from the Google Sheet (e.g., A1:D100).
        schema:
          type: string
      - name: ds.ds0.accountId
        in: query
        required: false
        description: Google Analytics account ID.
        schema:
          type: string
      - name: ds.ds0.propertyId
        in: query
        required: false
        description: Google Analytics property ID.
        schema:
          type: string
      - name: ds.ds0.viewId
        in: query
        required: false
        description: Google Analytics view ID. Required for Universal Analytics only.
        schema:
          type: string
      - name: ds.ds0.instanceId
        in: query
        required: false
        description: Cloud Spanner instance ID.
        schema:
          type: string
      - name: ds.ds0.databaseId
        in: query
        required: false
        description: Cloud Spanner database ID.
        schema:
          type: string
      - name: ds.ds0.instanceUrl
        in: query
        required: false
        description: Looker instance URL.
        schema:
          type: string
          format: uri
      - name: ds.ds0.model
        in: query
        required: false
        description: Looker model name.
        schema:
          type: string
      - name: ds.ds0.explore
        in: query
        required: false
        description: Looker explore name.
        schema:
          type: string
      - name: ds.ds0.siteUrl
        in: query
        required: false
        description: Google Search Console site URL.
        schema:
          type: string
          format: uri
      - name: ds.ds0.tableType
        in: query
        required: false
        description: Search Console table type.
        schema:
          type: string
      - name: ds.ds0.searchType
        in: query
        required: false
        description: Search Console search type.
        schema:
          type: string
      - name: ds.ds0.pathType
        in: query
        required: false
        description: Google Cloud Storage path type. Accepts FILE or FOLDER.
        schema:
          type: string
          enum:
          - FILE
          - FOLDER
      - name: ds.ds0.path
        in: query
        required: false
        description: Google Cloud Storage file or folder path.
        schema:
          type: string
      - name: ds.ds0.connectorId
        in: query
        required: false
        description: Community connector ID. Used to specify a community-built connector along with any connector-specific parameters.
        schema:
          type: string
      responses:
        '302':
          description: Redirects the user to the pre-configured Looker Studio report.
          headers:
            Location:
              description: The URL of the configured Looker Studio report.
              schema:
                type: string
                format: uri
        '400':
          description: Invalid URL parameters. An automatic error dialog is displayed when URL parsing fails.
components:
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.0 authentication. Requires domain-wide delegation configured by a Google Workspace administrator.
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/datastudio: Full read and write access to Looker Studio assets and permissions.
            https://www.googleapis.com/auth/datastudio.readonly: Read-only access to Looker Studio assets and permissions.
            https://www.googleapis.com/auth/userinfo.profile: Access to user profile information.
externalDocs:
  description: Looker Studio API Documentation
  url: https://developers.google.com/looker-studio/integrate/api