Google Campaign Manager Dimension Values API

The DimensionValues API from Google Campaign Manager — 1 operation(s) for dimensionvalues.

GitHub OpenAPI

Operations 1

POST /dfareporting/v5/userprofiles/{profileId}/dimensionvalues/query Query dimensionValues #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/google-campaign-manager:google-campaign-manager-dimensionvalues-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

google-campaign-manager-dimensionvalues-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Campaign Manager 360 Dimension Values API
  version: v5
  description: Generated from Google's published Discovery document for Campaign Manager 360 API (dfareporting v5, revision 20261107). 1 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://dfareporting.googleapis.com
tags:
- name: DimensionValues
paths:
  /dfareporting/v5/userprofiles/{profileId}/dimensionvalues/query:
    post:
      operationId: dfareporting.dimensionValues.query
      summary: Query dimensionValues
      description: Retrieves list of report dimension values for a list of filters.
      parameters:
      - name: profileId
        in: path
        required: true
        description: The Campaign Manager 360 user profile ID.
        schema:
          type: string
          format: int64
      - name: maxResults
        in: query
        required: false
        description: Maximum number of results to return.
        schema:
          default: '100'
          format: int32
          type: integer
      - name: pageToken
        in: query
        required: false
        description: The value of the nextToken from the previous result page.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DimensionValueRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DimensionValueList'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/dfareporting
      - apiKey: []
      tags:
      - DimensionValues
components:
  schemas:
    DimensionFilter:
      description: Represents a dimension filter.
      type: object
      properties:
        kind:
          type: string
          description: The kind of resource this is, in this case dfareporting#dimensionFilter.
        value:
          type: string
          description: The value of the dimension to filter.
        dimensionName:
          type: string
          description: The name of the dimension to filter.
    DimensionValueRequest:
      type: object
      properties:
        startDate:
          type: string
          format: date
        kind:
          type: string
          description: The kind of request this is, in this case dfareporting#dimensionValueRequest .
        filters:
          description: The list of filters by which to filter values. The filters are ANDed.
          type: array
          items:
            $ref: '#/components/schemas/DimensionFilter'
        endDate:
          format: date
          type: string
        dimensionName:
          type: string
          description: The name of the dimension for which values should be requested.
      description: Represents a DimensionValuesRequest.
    DimensionValue:
      type: object
      description: Represents a DimensionValue resource.
      properties:
        id:
          type: string
          description: The ID associated with the value if available.
        value:
          type: string
          description: The value of the dimension.
        dimensionName:
          description: The name of the dimension.
          type: string
        matchType:
          type: string
          enum:
          - EXACT
          - BEGINS_WITH
          - CONTAINS
          - WILDCARD_EXPRESSION
          description: Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
        etag:
          type: string
          description: The eTag of this response for caching purposes.
        kind:
          description: The kind of resource this is, in this case dfareporting#dimensionValue.
          type: string
    DimensionValueList:
      type: object
      description: Represents the list of DimensionValue resources.
      properties:
        items:
          description: The dimension values returned in this response.
          type: array
          items:
            $ref: '#/components/schemas/DimensionValue'
        kind:
          type: string
          description: The kind of list this is, in this case dfareporting#dimensionValueList.
        nextPageToken:
          type: string
          description: Continuation token used to page through dimension values. To retrieve the next page of results, set the next request's "pageToken" to the value of this field. The page token is only valid for a limited amount of time and should not be persisted.
        etag:
          type: string
          description: The eTag of this response for caching purposes.
    GoogleRpcError:
      type: object
      description: The error envelope every Google API returns.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            status:
              type: string
            details:
              type: array
              items:
                type: object
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: API key; accepted by methods that do not need user data.
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/ddmconversions: Manage DoubleClick Digital Marketing conversions
            https://www.googleapis.com/auth/dfatrafficking: View and manage your DoubleClick Campaign Manager's (DCM) display ad campaigns
            https://www.googleapis.com/auth/dfareporting: View and manage DoubleClick for Advertisers reports
externalDocs:
  url: https://developers.google.com/doubleclick-advertisers/
x-provenance:
  method: harvested
  publisher: Google
  source: https://dfareporting.googleapis.com/$discovery/rest?version=v5
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261107)