Reports: getIdMappingFile
Stay organized with collections
Save and categorize content based on your preferences.
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-09 UTC.
[null,null,["Last updated 2024-10-09 UTC."],[[["\u003cp\u003eDownloads a CSV file containing ID mappings between the previous and new Search Ads 360 for a specified advertiser and its child entities.\u003c/p\u003e\n"],["\u003cp\u003eThe file includes IDs for entities existing in both the previous and new Search Ads 360, encoded in UTF-8.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request is made using an HTTP GET method to a specific URL with agency and advertiser IDs as path parameters.\u003c/p\u003e\n"],["\u003cp\u003eA successful response has an empty body, indicating the initiation of the CSV file download.\u003c/p\u003e\n"]]],["This outlines a method to retrieve a CSV file containing ID mappings between old and new Search Ads 360 systems for a specific advertiser. The file encompasses all child entities. A `GET` request is made to a specified URL with `agencyId` and `advertiserId` path parameters. Authorization using the `https://www.googleapis.com/auth/doubleclicksearch` scope is mandatory. The successful response is an empty body. There is no request body needed for this method.\n"],null,["| **Note:** Requires [authorization](#auth).\n\nDownloads 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.\n[Try it now](#try-it).\n\nRequest\n\nHTTP request \n\n```\nGET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping\n```\n\nParameters\n\n| Parameter name | Value | Description |\n|----------------|--------|--------------------------|\n| **Path parameters** |||\n| `advertiserId` | `long` | DS ID of the advertiser. |\n| `agencyId` | `long` | DS ID of the agency. |\n\nAuthorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclicksearch` |\n\nFor more information, see the [authentication and authorization](/search-ads/v2/authorizing) page.\n\nRequest body\n\nDo not supply a request body with this method.\n\nResponse\n\nIf successful, this method returns an empty response body.\n\nTry it!\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/doubleclicksearch.reports.getIdMappingFile)."]]
