The previous Search Ads 360 Reporting API is going away and will be decommissioned on June 30, 2024. Note that the Search Ads 360 Conversion API is not affected and will continue to be supported. All new reporting development should use the new Search Ads 360 Reporting API.

Starting April 2024, an unsupportedApiVersion error will be returned when requesting a report. See details here.

We also strongly recommend that you migrate any existing Search Ads 360 implementations to the new API. See the new Search Ads 360 Reporting API Getting Started and Migration Guide for more information.

Troubleshooting

If you run into problems while using the Search Ads 360 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, contact support and have the following information ready:

Search Ads 360 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 Search Ads 360, 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.

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 Search Ads 360 API for your account. Make sure you've done the following: Go to the Google API Console. Select your project. If you haven't created a project yet, see Create a project for your client. 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 Search Ads 360 API.
`Invalid grant`	This error occurs when your refresh token isn't valid. You can obtain a refresh token by invoking the Search Ads 360 utility script as follows: `sa360Api.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 Search Ads 360 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. Reupload conversions after you've done the following: Verified that the click ID was generated 4 hours before conversions were uploaded. Activated the API conversion service. If you're attributing conversions to specific visits, wait at least 30 minutes after the visit before you upload the conversion. Search Ads 360 might not recognize the visit's clickID if you upload sooner than 30 minutes after the visit. In rare instances, you might need to wait up to 4 hours before Search Ads 360 could recognize the clickId. Confirmed that the click is from a valid source as indicated by the `gclsrc` parameter. Confirmed that you've specified the correct advertiser in the advertiserId column. Verified your click ID was generated within the last 90 days.
`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 Search Ads 360 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. Search Ads 360 requires this ID to be unique for a given scope. The Search Ads 360 conversion ID is generated by Search Ads 360 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. Search Ads 360 requires this ID to be unique for a given scope.
`0x0000011E`	`The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)`	The Floodlight activity ID or name that you've provided doesn't match the conversion type you've specified.

Report response codes and error messages

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

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

The data in the Search Ads 360 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.