Conversion: getByCustomerId
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
使用新版 Search Ads 360 客戶 ID，從 DoubleClick Search 引擎帳戶擷取轉換清單。
立即試用。
要求
HTTP 要求
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
參數
| 參數名稱 |
值 |
說明 |
| 路徑參數 |
customerId |
string |
新版 Search Ads 360 客戶 ID 字串。必須是客戶帳戶。
|
| 必要的查詢參數 |
endDate |
integer |
擷取轉換的結束日期 (含此日期)。格式為 yyyymmdd。
可接受的值為 20091101 到 99991231 (含頭尾)。
|
rowCount |
integer |
每次來電要傳回的轉換次數。
可接受的值為 1 到 1000 (含頭尾)。
|
startDate |
integer |
擷取轉換的開始日期 (含此日期)。格式為 yyyymmdd。
可接受的值為 20091101 到 99991231 (含頭尾)。
|
startRow |
unsigned integer |
以 0 為基準的起始索引，用於擷取轉換結果。
|
| 選用的查詢參數 |
adGroupId |
long |
廣告群組的數字 ID，
|
adId |
long |
廣告的數字 ID，
|
campaignId |
long |
廣告活動的數字 ID，
|
criterionId |
long |
條件的數字 ID，
|
授權
此要求需要具有下列範圍的授權：
| 範圍 |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
詳情請參閱「驗證與授權」網頁。
要求主體
請勿使用這個方法提供請求主體。
回應
成功的話，這個方法會在回應主體中傳回轉換資源。
試試看！
使用下方的 APIs Explorer，針對即時資料呼叫這個方法，看看會有什麼結果。
您也可以改用
獨立式
Explorer。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2024-08-20 (世界標準時間)。
[null,null,["上次更新時間：2024-08-20 (世界標準時間)。"],[[["\u003cp\u003eRetrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID.\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\u003eRequest parameters include specifying date ranges, result limits, and filtering by ad group, ad, campaign, or criterion IDs.\u003c/p\u003e\n"],["\u003cp\u003eThe response, if successful, returns a Conversion resource.\u003c/p\u003e\n"],["\u003cp\u003eYou can try this method using the provided APIs Explorer or standalone Explorer.\u003c/p\u003e\n"]]],["This outlines how to retrieve conversion data from a Search Ads 360 account. A `GET` request to a specific URL is required, using the customer ID, start and end dates, number of rows, and a start row. Optional parameters allow filtering by ad group, ad, campaign, or criterion IDs. The request needs authorization using a specified scope. A successful request returns a conversion resource, with the response having no request body.\n"],null,["# Conversion: getByCustomerId\n\n| **Note:** Requires [authorization](#auth).\n\nRetrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `customerId` | `string` | New search Ads 360 Customer ID String. Must be a client account. |\n| **Required query parameters** |||\n| `endDate` | `integer` | Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `rowCount` | `integer` | The number of conversions to return per call. Acceptable values are `1` to `1000`, inclusive. |\n| `startDate` | `integer` | First date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `startRow` | `unsigned integer` | The 0-based starting index for retrieving conversions results. |\n| **Optional query parameters** |||\n| `adGroupId` | `long` | Numeric ID of the ad group. |\n| `adId` | `long` | Numeric ID of the ad. |\n| `campaignId` | `long` | Numeric ID of the campaign. |\n| `criterionId` | `long` | Numeric ID of the criterion. |\n\n### Authorization\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\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a [Conversion resource](/search-ads/v2/reference/conversion#resource) in the response body.\n\nTry it!\n-------\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.conversion.getByCustomerId)."]]
