Conversion: update
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Cập nhật một loạt các lượt chuyển đổi trong DoubleClick Search.
Thử ngay.
Yêu cầu
Yêu cầu HTTP
PUT https://www.googleapis.com/doubleclicksearch/v2/conversion
Ủy quyền
Yêu cầu này cần được cho phép có phạm vi sau:
| Phạm vi |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.
Nội dung yêu cầu
Trong nội dung yêu cầu, hãy cung cấp Tài nguyên lượt chuyển đổi với các thuộc tính sau:
| Tên tài sản |
Giá trị |
Mô tả |
Ghi chú |
| Thuộc tính không bắt buộc |
conversion[].currencyCode |
string |
Mã đơn vị tiền tệ cho doanh thu của lượt chuyển đổi. Phải theo định dạng bảng chữ cái ISO 4217 (3 ký tự). |
có thể ghi
|
conversion[].quantityMillis |
long |
Số lượng lượt chuyển đổi này, tính bằng mili giây. |
có thể ghi
|
conversion[].revenueMicros |
long |
Số tiền doanh thu của lượt chuyển đổi TRANSACTION này, tính bằng phần triệu (giá trị nhân với 1000000, không có số thập phân). Ví dụ: để chỉ định giá trị doanh thu là "10" nhập "10000000" (10 triệu) yêu cầu của bạn. |
có thể ghi
|
conversion[].state |
string |
Trạng thái của lượt chuyển đổi, nghĩa là ACTIVE hoặc REMOVED. Lưu ý: trạng thái ĐÃ XÓA không được dùng nữa.
Các giá trị được chấp nhận là:
- "
ACTIVE"
- "
DELETED": (Không dùng nữa)
- "
REMOVED"
|
có thể ghi
|
Hãy dùng thử!
Hãy sử dụng APIs Explorer (Trình khám phá API) bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.
Ngoài ra, hãy thử
độc lập
Trình khám phá.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-08-20 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-08-20 UTC."],[[["\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)."]]
