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에 일괄적으로 새 전환을 삽입합니다.
|
|
업데이트
|
PUT /conversion
|
DoubleClick Search에서 전환을 일괄 업데이트합니다.
|
|
updateAvailability
|
POST /conversion/updateAvailability
|
DoubleClick Search에서 일괄 플러드라이트 활동의 사용 가능 여부를 업데이트합니다.
|
보고서
| 메서드 |
HTTP 요청 |
설명 |
| 별도로 명시하지 않는 한, URI는 https://www.googleapis.com/doubleclicksearch/v2를 기준으로 합니다. |
|
getIdMappingFile
|
GET /agency/agencyId/advertiser/advertiserId/idmapping
|
이전 Search Ads 360과 새 Search Ads 360 간의 ID 매핑이 포함된 CSV 파일 (UTF-8로 인코딩됨)을 다운로드합니다. 요청된 광고주의 경우 이 파일에는 이전 Search Ads 360과 새 Search Ads 360에 모두 있는 모든 하위 항목 (예: 엔진 계정, 캠페인, 광고 그룹 등)이 포함됩니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(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. |"]]
