Google Search Ads 360 Reporting

Google Search Ads 360 Reporting Conversion API

The Conversion API from Google Search Ads 360 Reporting — 4 operation(s) for conversion.

GitHub OpenAPI

Operations 5

POST /doubleclicksearch/v2/conversion/updateAvailability Update availability conversion #
POST /doubleclicksearch/v2/conversion Insert conversion #
PUT /doubleclicksearch/v2/conversion Update conversion #
GET /doubleclicksearch/v2/agency/{agencyId}/advertiser/{advertiserId}/engine/{engineAccountId}/conversion Get conversion #
GET /doubleclicksearch/v2/customer/{customerId}/conversion Get by customer id conversion #

Documentation

📖
Documentation
https://developers.google.com/search-ads/reporting/api/reference/rpc
📖
Authentication
https://developers.google.com/search-ads/reporting/quickstart/quickstart-guide
📖
GettingStarted
https://developers.google.com/search-ads/reporting/quickstart/quickstart-guide

Specifications

⚙
OpenAPI
https://artifacts.apis.io/google-search-ads-360/openapi/google-search-ads-360-conversion-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/google-search-ads-360/json-schema/json-schema.yml

Other Resources

🔗
JSONLD
https://artifacts.apis.io/google-search-ads-360/json-ld/json-ld.yml

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-search-ads-360:google-search-ads-360-conversion-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.

GitHub Google LinkedIn

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

OpenAPI Specification

google-search-ads-360-conversion-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Search Ads 360 Conversion API
  version: v2
  description: Generated from Google's published Discovery document for Search Ads 360 API (doubleclicksearch v2, revision 20261110). 5 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://doubleclicksearch.googleapis.com
tags:
- name: Conversion
paths:
  /doubleclicksearch/v2/conversion/updateAvailability:
    post:
      operationId: doubleclicksearch.conversion.updateAvailability
      summary: Update availability conversion
      description: Updates the availabilities of a batch of floodlight activities in DoubleClick Search.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAvailabilityRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateAvailabilityResponse'
        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/doubleclicksearch
      - apiKey: []
      tags:
      - Conversion
  /doubleclicksearch/v2/conversion:
    post:
      operationId: doubleclicksearch.conversion.insert
      summary: Insert conversion
      description: Inserts a batch of new conversions into DoubleClick Search.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConversionList'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionList'
        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/doubleclicksearch
      - apiKey: []
      tags:
      - Conversion
    put:
      operationId: doubleclicksearch.conversion.update
      summary: Update conversion
      description: Updates a batch of conversions in DoubleClick Search.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConversionList'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionList'
        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/doubleclicksearch
      - apiKey: []
      tags:
      - Conversion
  /doubleclicksearch/v2/agency/{agencyId}/advertiser/{advertiserId}/engine/{engineAccountId}/conversion:
    get:
      operationId: doubleclicksearch.conversion.get
      summary: Get conversion
      description: Retrieves a list of conversions from a DoubleClick Search engine account.
      parameters:
      - name: agencyId
        in: path
        required: true
        description: Numeric ID of the agency.
        schema:
          type: string
          format: int64
      - name: advertiserId
        in: path
        required: true
        description: Numeric ID of the advertiser.
        schema:
          format: int64
          type: string
      - name: engineAccountId
        in: path
        required: true
        description: Numeric ID of the engine account.
        schema:
          format: int64
          type: string
      - name: adGroupId
        in: query
        required: false
        description: Numeric ID of the ad group.
        schema:
          type: string
          format: int64
      - name: adId
        in: query
        required: false
        description: Numeric ID of the ad.
        schema:
          type: string
          format: int64
      - name: campaignId
        in: query
        required: false
        description: Numeric ID of the campaign.
        schema:
          type: string
          format: int64
      - name: criterionId
        in: query
        required: false
        description: Numeric ID of the criterion.
        schema:
          format: int64
          type: string
      - name: customerId
        in: query
        required: false
        description: Customer ID of a client account in the new Search Ads 360 experience.
        schema:
          type: string
      - name: endDate
        in: query
        required: true
        description: Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd.
        schema:
          maximum: 99991231
          format: int32
          type: integer
          minimum: 20091101
      - name: rowCount
        in: query
        required: true
        description: The number of conversions to return per call.
        schema:
          type: integer
          format: int32
          maximum: 1000
          minimum: 1
      - name: startDate
        in: query
        required: true
        description: First date (inclusive) on which to retrieve conversions. Format is yyyymmdd.
        schema:
          type: integer
          minimum: 20091101
          maximum: 99991231
          format: int32
      - name: startRow
        in: query
        required: true
        description: The 0-based starting index for retrieving conversions results.
        schema:
          format: uint32
          type: integer
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionList'
        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/doubleclicksearch
      - apiKey: []
      tags:
      - Conversion
  /doubleclicksearch/v2/customer/{customerId}/conversion:
    get:
      operationId: doubleclicksearch.conversion.getByCustomerId
      summary: Get by customer id conversion
      description: Retrieves a list of conversions from a DoubleClick Search engine account.
      parameters:
      - name: customerId
        in: path
        required: true
        description: Customer ID of a client account in the new Search Ads 360 experience.
        schema:
          type: string
      - name: adGroupId
        in: query
        required: false
        description: Numeric ID of the ad group.
        schema:
          format: int64
          type: string
      - name: adId
        in: query
        required: false
        description: Numeric ID of the ad.
        schema:
          type: string
          format: int64
      - name: advertiserId
        in: query
        required: false
        description: Numeric ID of the advertiser.
        schema:
          format: int64
          type: string
      - name: agencyId
        in: query
        required: false
        description: Numeric ID of the agency.
        schema:
          format: int64
          type: string
      - name: campaignId
        in: query
        required: false
        description: Numeric ID of the campaign.
        schema:
          format: int64
          type: string
      - name: criterionId
        in: query
        required: false
        description: Numeric ID of the criterion.
        schema:
          type: string
          format: int64
      - name: endDate
        in: query
        required: true
        description: Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd.
        schema:
          maximum: 99991231
          minimum: 20091101
          format: int32
          type: integer
      - name: engineAccountId
        in: query
        required: false
        description: Numeric ID of the engine account.
        schema:
          format: int64
          type: string
      - name: rowCount
        in: query
        required: true
        description: The number of conversions to return per call.
        schema:
          format: int32
          minimum: 1
          maximum: 1000
          type: integer
      - name: startDate
        in: query
        required: true
        description: First date (inclusive) on which to retrieve conversions. Format is yyyymmdd.
        schema:
          format: int32
          minimum: 20091101
          type: integer
          maximum: 99991231
      - name: startRow
        in: query
        required: true
        description: The 0-based starting index for retrieving conversions results.
        schema:
          type: integer
          format: uint32
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionList'
        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/doubleclicksearch
      - apiKey: []
      tags:
      - Conversion
components:
  schemas:
    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
    Conversion:
      properties:
        customerId:
          type: string
          description: Customer ID of a client account in the new Search Ads 360 experience.
        type:
          description: The type of the conversion, that is, either `ACTION` or `TRANSACTION`. An `ACTION` conversion is an action by the user that has no monetarily quantifiable value, while a `TRANSACTION` conversion is an action that does have a monetarily quantifiable value. Examples are email list signups (`ACTION`) versus ecommerce purchases (`TRANSACTION`).
          type: string
        countMillis:
          type: string
          description: Available to advertisers only after contacting DoubleClick Search customer support.
          format: int64
        attributionModel:
          description: Available to advertisers only after contacting DoubleClick Search customer support.
          type: string
        segmentationName:
          type: string
          description: The friendly segmentation identifier (for example, DoubleClick Search Floodlight activity name).
        productId:
          description: The product ID (SKU).
          type: string
        segmentationType:
          description: The segmentation type of this conversion (for example, `FLOODLIGHT`).
          type: string
        dsConversionId:
          type: string
          description: ID that DoubleClick Search generates for each conversion.
          format: int64
        conversionTimestamp:
          description: The time at which the conversion took place, in epoch millis UTC.
          type: string
        engineAccountId:
          type: string
          format: int64
          description: DS engine account ID.
        customDimension:
          type: array
          items:
            $ref: '#/components/schemas/CustomDimension'
          description: Custom dimensions for the conversion, which can be used to filter data in a report.
        clickId:
          description: DS click ID for the conversion.
          type: string
        floodlightOrderId:
          type: string
          description: The Floodlight order ID provided by the advertiser for the conversion.
        customMetric:
          items:
            $ref: '#/components/schemas/CustomMetric'
          description: Custom metrics for the conversion.
          type: array
        segmentationId:
          description: The numeric segmentation identifier (for example, DoubleClick Search Floodlight activity ID).
          format: int64
          type: string
        revenueMicros:
          type: string
          description: The revenue amount of this `TRANSACTION` conversion, in micros (value multiplied by 1000000, no decimal). For example, to specify a revenue value of "10" enter "10000000" (10 million) in your request.
        campaignId:
          type: string
          format: int64
          description: DS campaign ID.
        conversionId:
          description: For offline conversions, advertisers provide this ID. Advertisers can specify any ID that is meaningful to them. Each conversion in a request must specify a unique ID, and the combination of ID and timestamp must be unique amongst all conversions within the advertiser. For online conversions, DS copies the `dsConversionId` or `floodlightOrderId` into this property depending on the advertiser's Floodlight instructions.
          type: string
        currencyCode:
          type: string
          description: The currency code for the conversion's revenue. Should be in ISO 4217 alphabetic (3-char) format.
        quantityMillis:
          description: The quantity of this conversion, in millis.
          type: string
          format: int64
        productLanguage:
          description: The language registered for the Merchant Center feed that contains the product. Use an ISO 639 code to specify a language.
          type: string
        adId:
          type: string
          description: DS ad ID.
          format: int64
        adGroupId:
          format: int64
          type: string
          description: DS ad group ID.
        storeId:
          type: string
          description: The ID of the local store for which the product was advertised. Applicable only when the channel is "`local`".
        adUserDataConsent:
          enum:
          - UNKNOWN
          - GRANTED
          - DENIED
          description: 'Represents consent for core platform services (CPS) preferences in settings. No default value. Acceptable values are: GRANTED: The desired consent status is to grant. Read the CPS preferences from GTE settings. DENIED: The desired consent status is to deny; CPS list is empty.'
          type: string
        productGroupId:
          type: string
          description: DS product group ID.
          format: int64
        conversionModifiedTimestamp:
          format: int64
          description: The time at which the conversion was last modified, in epoch millis UTC.
          type: string
        channel:
          type: string
          description: 'Sales channel for the product. Acceptable values are: - "`local`": a physical store - "`online`": an online store '
        productCountry:
          type: string
          description: The country registered for the Merchant Center feed that contains the product. Use an ISO 3166 code to specify a country.
        deviceType:
          description: The type of device on which the conversion occurred.
          type: string
        state:
          type: string
          description: 'The state of the conversion, that is, either `ACTIVE` or `REMOVED`. Note: state DELETED is deprecated.'
        criterionId:
          description: DS criterion (keyword) ID.
          format: int64
          type: string
        agencyId:
          format: int64
          description: DS agency ID.
          type: string
        inventoryAccountId:
          description: ID that DS generates and uses to uniquely identify the inventory account that contains the product.
          type: string
          format: int64
        advertiserId:
          format: int64
          type: string
          description: DS advertiser ID.
      type: object
      description: 'A conversion containing data relevant to DoubleClick Search. Common DS3 API conversion fields: Id Range [1 - 2800]. Next Id to use: 33'
    UpdateAvailabilityResponse:
      properties:
        availabilities:
          type: array
          items:
            $ref: '#/components/schemas/Availability'
          description: The availabilities being returned.
      type: object
      description: The response to a update availability request.
    ConversionList:
      properties:
        kind:
          type: string
          description: 'Identifies this as a ConversionList resource. Value: the fixed string doubleclicksearch#conversionList.'
        conversion:
          items:
            $ref: '#/components/schemas/Conversion'
          type: array
          description: The conversions being requested.
      description: A list of conversions.
      type: object
    CustomDimension:
      properties:
        name:
          type: string
          description: Custom dimension name.
        value:
          type: string
          description: Custom dimension value.
      type: object
      description: A message containing the custom dimension.
    Availability:
      type: object
      properties:
        segmentationType:
          description: The segmentation type that this availability is for (its default value is `FLOODLIGHT`).
          type: string
        segmentationId:
          description: The numeric segmentation identifier (for example, DoubleClick Search Floodlight activity ID).
          format: int64
          type: string
        availabilityTimestamp:
          type: string
          description: The time by which all conversions have been uploaded, in epoch millis UTC.
          format: int64
        agencyId:
          description: DS agency ID.
          format: int64
          type: string
        advertiserId:
          description: DS advertiser ID.
          format: int64
          type: string
        segmentationName:
          description: The friendly segmentation identifier (for example, DoubleClick Search Floodlight activity name).
          type: string
        customerId:
          type: string
          description: Customer ID of a client account in the new Search Ads 360 experience.
      description: A message containing availability data relevant to DoubleClick Search.
    CustomMetric:
      properties:
        name:
          description: Custom metric name.
          type: string
        value:
          format: double
          description: Custom metric numeric value.
          type: number
      type: object
      description: A message containing the custom metric.
    UpdateAvailabilityRequest:
      type: object
      properties:
        availabilities:
          items:
            $ref: '#/components/schemas/Availability'
          type: array
          description: The availabilities being requested.
      description: The request to update availability.
  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/doubleclicksearch: View and manage your advertising data in DoubleClick Search
externalDocs:
  url: https://developers.google.com/search-ads
x-provenance:
  method: harvested
  publisher: Google
  source: https://doubleclicksearch.googleapis.com/$discovery/rest?version=v2
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261110)