Conversion: update
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
在 DoubleClick Search 中更新整批轉換。
立即試用。
要求
HTTP 要求
PUT https://www.googleapis.com/doubleclicksearch/v2/conversion
授權
此要求需要具有下列範圍的授權：
| 範圍 |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
詳情請參閱「驗證與授權」網頁。
要求主體
在要求主體中，提供含有下列屬性的轉換資源：
| 屬性名稱 |
值 |
說明 |
附註 |
| 選用屬性 |
conversion[].currencyCode |
string |
轉換收益的貨幣代碼。格式應為 ISO 4217 字母 (3 個字元) |
可寫入
|
conversion[].quantityMillis |
long |
此轉換的數量 (以千分之一為單位)。 |
可寫入
|
conversion[].revenueMicros |
long |
此 TRANSACTION 轉換的收益金額，以微量為單位 (值乘以 1000000，無小數)。舉例來說，如要將收益值指定為「10」輸入「10000000」(1,000 萬)。 |
可寫入
|
conversion[].state |
string |
轉換狀態，即 ACTIVE 或 REMOVED。注意：DELETED 狀態已淘汰。
可接受的值為：
- 「
ACTIVE」
- "
DELETED": (已淘汰)
- 「
REMOVED」
|
可寫入
|
回應
成功的話，這個方法會在回應主體中傳回轉換資源。
試試看！
使用下方的 APIs Explorer，針對即時資料呼叫這個方法，看看會有什麼結果。
您也可以改用
獨立式
Explorer。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2024-08-20 (世界標準時間)。
[null,null,["上次更新時間：2024-08-20 (世界標準時間)。"],[[["\u003cp\u003eUpdates a batch of conversions in DoubleClick Search using the \u003ccode\u003ePUT\u003c/code\u003e method.\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 body should contain a Conversion resource with properties like \u003ccode\u003ecurrencyCode\u003c/code\u003e, \u003ccode\u003equantityMillis\u003c/code\u003e, \u003ccode\u003erevenueMicros\u003c/code\u003e, and \u003ccode\u003estate\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return a Conversion resource in the response body.\u003c/p\u003e\n"]]],["This outlines how to update conversions in DoubleClick Search via a PUT request to `https://www.googleapis.com/doubleclicksearch/v2/conversion`, requiring `https://www.googleapis.com/auth/doubleclicksearch` authorization. The request body should include a Conversion resource with optional properties like `currencyCode`, `quantityMillis`, `revenueMicros`, and `state` (either `ACTIVE` or `REMOVED`). Successful requests return a Conversion resource.\n"],null,["# Conversion: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates a batch of conversions in DoubleClick Search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/doubleclicksearch/v2/conversion\n```\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\nIn the request body, supply a [Conversion resource](/search-ads/v2/reference/conversion#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|-------------------------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| **Optional Properties** ||||\n| conversion[].`currencyCode` | `string` | The currency code for the conversion's revenue. Should be in ISO 4217 alphabetic (3-char) format. | writable |\n| conversion[].`quantityMillis` | `long` | The quantity of this conversion, in millis. | writable |\n| conversion[].`revenueMicros` | `long` | The revenue amount of this `TRANSACTION` conversion, in micros (value multiplied by 1000000, no decimal). For example, to specify a revenue value of \"10\" enter \"10000000\" (10 million) in your request. | writable |\n| conversion[].`state` | `string` | The state of the conversion, that is, either `ACTIVE` or `REMOVED`. Note: state DELETED is deprecated. \u003cbr /\u003e Acceptable values are: - \"`ACTIVE`\" - \"`DELETED`\": (Deprecated) - \"`REMOVED`\" | writable |\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.update)."]]
