API Reference
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
此 API 参考资料按资源类型编排整理。每种资源类型都有一种或多种数据表示形式以及一个或多个方法。
资源类型
-
转化
-
报告
-
SavedColumns
转化
如需详细了解转化资源，请参阅资源表示形式页面。
| 方法 |
HTTP 请求 |
说明 |
| 除非另有说明，否则 URI 均为 https://www.googleapis.com/doubleclicksearch/v2 的相对地址 |
|
get
|
GET /agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion
|
从 DoubleClick Search 引擎账号检索转化列表。
必需的查询参数：endDate、rowCount、startDate、startRow |
|
getByCustomerId
|
GET /customer/customerId/conversion
|
使用新的 Search Ads 360 客户 ID 从 DoubleClick Search 引擎账号检索转化列表。
必需的查询参数：endDate、rowCount、startDate、startRow |
|
insert
|
POST /conversion
|
将一批新转化插入 DoubleClick Search。
|
|
update
|
PUT /conversion
|
在 DoubleClick Search 中更新一批转化。
|
|
updateAvailability
|
POST /conversion/updateAvailability
|
更新 DoubleClick Search 中一批 Floodlight 活动的播出信息。
|
Reports
| 方法 |
HTTP 请求 |
说明 |
| 除非另有说明，否则 URI 均为 https://www.googleapis.com/doubleclicksearch/v2 的相对地址 |
|
getIdMappingFile
|
GET /agency/agencyId/advertiser/advertiserId/idmapping
|
下载一个 CSV 文件（编码为 UTF-8），其中包含旧版 Search Ads 360 与新版 Search Ads 360 之间的 ID 映射。对于请求的广告客户，该文件包含旧版 Search Ads 360 和新版 Search Ads 360 中都存在的所有子级实体（例如引擎账号、广告系列、广告组等）。
|
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-25。
[null,null,["最后更新时间 (UTC)：2025-07-25。"],[[["\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. |"]]
