Предыдущий Search Ads 360 Reporting API выведен из эксплуатации. Теперь вы можете создавать свои отчеты с помощью нового Search Ads 360 Reporting API .
Обратите внимание, что методы get и getByCustomerId в Search Ads 360 Conversion API устарели в третьем квартале 2025 года. Чтобы продолжить доступ к данным о конверсиях, необходимо создать отчет с использованием ресурса конверсии с помощью нового Search Ads 360 Reporting API. Подробнее см. здесь.
Остальные функции API конверсий Search Ads 360 будут по-прежнему поддерживаться.
Conversion: update
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Обновляет пакет конверсий в DoubleClick Search. Попробуйте сейчас .
Запрос
HTTP-запрос
PUT https://www.googleapis.com/doubleclicksearch/v2/conversion
Авторизация
Для этого запроса требуется авторизация со следующей областью действия:
| Объем |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
Дополнительную информацию см. на странице аутентификации и авторизации .
Тело запроса
В теле запроса укажите ресурс Conversion со следующими свойствами:
| Имя свойства | Ценить | Описание | Примечания |
|---|
| Дополнительные свойства |
conversion[]. currencyCode | string | Код валюты дохода от конвертации. Должен быть в алфавитном (3-символьном) формате ISO 4217. | записываемый |
conversion[]. quantityMillis | long | Величина этого преобразования в миллисах. | записываемый |
conversion[]. revenueMicros | long | Сумма дохода от этой конверсии TRANSACTION в микронах (значение, умноженное на 1000000, без десятичной дроби). Например, чтобы указать значение дохода «10», введите в запросе «10000000» (10 миллионов). | записываемый |
conversion[]. state | string | Состояние преобразования: ACTIVE или REMOVED . Примечание: состояние DELETED устарело.
Приемлемые значения:- «
ACTIVE » - «
DELETED »: (Устарело) - "
REMOVED "
| записываемый |
Попробуйте!
Используйте API-интерфейс ниже, чтобы вызвать этот метод для реальных данных и просмотреть ответ. Альтернативно попробуйте автономный Проводник .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-08 UTC.
[null,null,["Последнее обновление: 2024-11-08 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)."]]
