Troubleshooting

If you run into problems while using the DoubleClick Search API, take a look through this troubleshooting section.

If there's a problem that you can't solve after reading the resources on this site, send a message to ds-support@google.com with the following information:

  • DoubleClick Search Agency ID and Advertiser ID you are trying to access

  • Project Number from Google API Console

  • The username of the Google Account that you’re using to access the API.
    This is the account that has been given permission to access DoubleClick Search, which is the same account you use to set up authorization.

  • Code snippet of your request

  • JSON response
    If the response is an error, be sure to include the error message, not just the numeric error code.

This email list is monitored by Google employees during regular business hours in the United States. For coverage after hours, contact DoubleClick support.

Authorization errors

Here are some commonly encountered authorization errors:

Message Description

Access Not Configured. Please use Google API Console to activate the API for your project.

This error occurs if you haven't enabled the DoubleClick Search API for your account. Make sure you've done the following:

  1. Go to the Google API Console.

  2. Select your project. If you haven't created a project yet, see Create a project for your client.

  3. In the sidebar on the left, expand APIs & auth. Next, click APIs. In the list of APIs, make sure the status is ON for the DoubleClick Search API.

Invalid grant

This error occurs when your refresh token isn't valid. You can obtain a refresh token by invoking the DoubleClick Search utility script as follows:

dsApi.py --login

Learn more about the recommended workflow for authorization.

Invalid client
no application name

This error occurs if you haven't specified a product name when setting up your project in the Google API Console. To fix this error, enter the name of your product on the Consent screen of the Google API Console.

Other types of authorization errors

Make sure to use a Google Account that has been granted access to DoubleClick Search when you sign in to the Google API Console to retrieve your client ID and client secret, and when you obtain a refresh token.

Conversion upload errors

The following table lists the errors you may encounter when uploading conversions. Note that the hexadecimal error codes are immutable, so you can use them in your own scripts to identify errors.

Error code Message Description
0x00000101

Click ID '{ID}' is not found

The click id you specified in an update request is not valid. Make sure you've done the following:

0x0000010E Floodlight activity name '{name}' is not found

The name of the Floodlight activity specified in the segmentationName column is incorrect or not yet available. If you see this error, check for the following common problems:

  • Names are case-sensitive, so make sure your request matched the case exactly.
  • Make sure you didn't include any unprintable Unicode character or double spaces in the Floodlight activity name.
  • Make sure you specified the name of a Floodlight activity, not a Floodlight column.
  • Check that the Floodlight activity exists for the advertiser you specified in the advertiserId column. (It's possible you specified the wrong advertiser.)
  • After you create or edit a Floodlight activity, wait a couple of hours before uploading conversions for the activity.
0x00000115 Custom dimension '{name}' is not found

Make sure the custom Floodlight variable you specified has been set up as a dimension (not a metric) for the advertiser associated with the clickId, criterionId, or productGroupId you're attributing for the conversion.

0x00000116 Custom metric '{name}' is not found

Make sure the custom Floodlight variable you specified has been set up as a metric (not a dimension) for the advertiser associated with the clickId, criterionId, or productGroupId you're attributing for the conversion.

0x0000011A The advertiser conversion ID is already specified for a conversion with DS conversion ID {ID}

Someone has already uploaded a conversion for the same scope and advertiser conversion ID specified in the conversionId column.

The "advertiser conversion ID" is an ID you generate. DS requires this ID to be unique for a given scope. The DS conversion ID is generated by DS and is guaranteed to be unique.

0x0000011B Advertiser conversion ID '{ID}' is not found

Your update request tried to update an advertiser conversion ID that doesn't exist. Make sure you specified the right ID.

0x0000011D User does not have permission to view advertiser {advertiser ID}

The Google Account your client is using doesn't have permission to view the advertiser specified in the request.

When you sign in to the Google API Console to retrieve your client ID and client secret, and when you obtain a refresh token, make sure to use a Google Account that has been granted access to the advertiser you specified.

0x0000011F Advertiser conversion ID is already specified in this request

Two or more conversions in the request specify the same scope and advertiser conversion ID.

The advertiser conversion ID is an ID you generate and specify in the conversionId column. DS requires this ID to be unique for a given scope.

Report response codes and error messages

If you request a report and the response is an error message, see Response Codes in the DoubleClick Search API and Standard Error Responses for more information about the error.

The data in the DoubleClick Search UI doesn't match a report returned by the API

The data in the DoubleClick Search UI should match the data returned by the API by default. If you set includeRemovedEntities to true in a report request, make sure that the Show removed checkbox is also selected in the UI.

Send feedback about...

DoubleClick Search API