The previous Search Ads 360 Reporting API is decommissioned. You can now create your reports using the new Search Ads 360 Reporting API.

Note that the get and getByCustomerId methods in the Search Ads 360 Conversion API are being deprecated in Q3 2025. To continue accessing conversion data, you must create a report using the conversion resource using the new Search Ads 360 Reporting API. See more details here.

The remaining Search Ads 360 Conversion API functions will continue to be supported.

Reports: getIdMappingFile

AI-generated Key Takeaways

Downloads a CSV file containing ID mappings between the previous and new Search Ads 360 for a specified advertiser and its child entities.
The file includes IDs for entities existing in both the previous and new Search Ads 360, encoded in UTF-8.
Requires authorization with the https://www.googleapis.com/auth/doubleclicksearch scope.
The request is made using an HTTP GET method to a specific URL with agency and advertiser IDs as path parameters.
A successful response has an empty body, indicating the initiation of the CSV file download.

Downloads a CSV file (encoded in UTF-8) that contains ID mappings between the previous Search Ads 360 and the new Search Ads 360. For the requested advertiser, the file includes all children entities (e.g. engine accounts, campaigns, ad groups, etc.) that exist in both the previous Search Ads 360 and the new Search Ads 360. Try it now.

Request

HTTP request

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping

Parameters

Parameter name	Value	Description
Path parameters
`advertiserId`	`long`	DS ID of the advertiser.
`agencyId`	`long`	DS ID of the agency.

Authorization

This request requires authorization with the following scope:

Scope
`https://www.googleapis.com/auth/doubleclicksearch`

For more information, see the authentication and authorization page.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns an empty response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.