The previous Search Ads 360 Reporting API is decommissioned. You can now create your reports using thenew Search Ads 360 Reporting API.
Note that thegetandgetByCustomerIdmethods in the Search Ads 360 Conversion API are being deprecated in Q3 2025. To continue accessing conversion data, you must create a report using theconversion resourceusing the new Search Ads 360 Reporting API. See more detailshere.
GET /agency/agencyId/advertiser/advertiserId/idmapping
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-12-05 UTC."],[[["\u003cp\u003eThis API reference is organized by resource type, with each type having one or more data representations and methods.\u003c/p\u003e\n"],["\u003cp\u003eThe available resource types are Conversion, Reports, and SavedColumns.\u003c/p\u003e\n"],["\u003cp\u003eConversion resource allows you to retrieve, insert, update, and manage the availability of conversions in DoubleClick Search.\u003c/p\u003e\n"],["\u003cp\u003eReports resource provides functionality to download a CSV file containing ID mappings between previous and new Search Ads 360 for a given advertiser.\u003c/p\u003e\n"]]],["This API reference outlines three resource types: Conversion, Reports, and SavedColumns. The Conversion resource supports methods to `get`, `getByCustomerId`, `insert`, `update`, and `updateAvailability` conversions. These methods manage lists and batches of conversions. The Reports resource includes the `getIdMappingFile` method, which downloads a CSV file of ID mappings between old and new Search Ads 360 systems, encompassing all child entities. Each method has specific HTTP request paths.\n"],null,["# API Reference\n\nThis API reference is organized by resource type. Each resource type has one or more data representations and one or more methods.\n\nResource types\n--------------\n\n1. [Conversion](#Conversion)\n2. [Reports](#Reports)\n3. [SavedColumns](#SavedColumns)\n\nConversion\n----------\n\nFor Conversion Resource details, see the [resource representation](/search-ads/v2/reference/conversion#resource) page.\n\n| Method | HTTP request | Description |\n|------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| URIs relative to https://www.googleapis.com/doubleclicksearch/v2, unless otherwise noted |||\n| [get](/search-ads/v2/reference/conversion/get) | `GET /agency/`\u003cvar class=\"apiparam\" translate=\"no\"\u003eagencyId\u003c/var\u003e`/advertiser/`\u003cvar class=\"apiparam\" translate=\"no\"\u003eadvertiserId\u003c/var\u003e`/engine/`\u003cvar class=\"apiparam\" translate=\"no\"\u003eengineAccountId\u003c/var\u003e`/conversion` | Retrieves a list of conversions from a DoubleClick Search engine account. \u003cbr /\u003e **Required query parameters:** `endDate`, `rowCount`, `startDate`, `startRow` |\n| [getByCustomerId](/search-ads/v2/reference/conversion/getByCustomerId) | `GET /customer/`\u003cvar class=\"apiparam\" translate=\"no\"\u003ecustomerId\u003c/var\u003e`/conversion` | Retrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID. \u003cbr /\u003e **Required query parameters:** `endDate`, `rowCount`, `startDate`, `startRow` |\n| [insert](/search-ads/v2/reference/conversion/insert) | `POST /conversion` | Inserts a batch of new conversions into DoubleClick Search. |\n| [update](/search-ads/v2/reference/conversion/update) | `PUT /conversion` | Updates a batch of conversions in DoubleClick Search. |\n| [updateAvailability](/search-ads/v2/reference/conversion/updateAvailability) | `POST /conversion/updateAvailability` | Updates the availabilities of a batch of floodlight activities in DoubleClick Search. |\n\nReports\n-------\n\n| Method | HTTP request | Description |\n|-----------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| URIs relative to https://www.googleapis.com/doubleclicksearch/v2, unless otherwise noted |||\n| [getIdMappingFile](/search-ads/v2/reference/reports/getIdMappingFile) | `GET /agency/`\u003cvar class=\"apiparam\" translate=\"no\"\u003eagencyId\u003c/var\u003e`/advertiser/`\u003cvar class=\"apiparam\" translate=\"no\"\u003eadvertiserId\u003c/var\u003e`/idmapping` | 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. |"]]
