Предыдущий Search Ads 360 Reporting API выведен из эксплуатации. Теперь вы можете создавать свои отчеты с помощью нового Search Ads 360 Reporting API .
Обратите внимание, что методы get и getByCustomerId в Search Ads 360 Conversion API устарели в третьем квартале 2025 года. Чтобы продолжить доступ к данным о конверсиях, необходимо создать отчет с использованием ресурса конверсии с помощью нового Search Ads 360 Reporting API. Подробнее см. здесь.
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Получает список конверсий из учетной записи поисковой системы DoubleClick. Попробуйте сейчас .
Запрос
HTTP-запрос
GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion
Параметры
Имя параметра
Ценить
Описание
Параметры пути
advertiserId
long
Числовой идентификатор рекламодателя.
agencyId
long
Числовой идентификатор агентства.
engineAccountId
long
Числовой идентификатор учетной записи системы.
Обязательные параметры запроса
endDate
integer
Последняя дата (включительно), по которой можно получить данные о конверсиях. Формат: ггггммдд. Допустимые значения: 20091101 до 99991231 включительно.
rowCount
integer
Количество возвращаемых конверсий за звонок. Допустимые значения: от 1 до 1000 включительно.
startDate
integer
Первая дата (включительно), по которой необходимо получить данные о конверсиях. Формат: ггггммдд. Допустимые значения: 20091101 до 99991231 включительно.
startRow
unsigned integer
Начальный индекс, отсчитываемый от 0, для получения результатов конверсий.
Необязательные параметры запроса
adGroupId
long
Числовой идентификатор группы объявлений.
adId
long
Числовой идентификатор объявления.
campaignId
long
Числовой идентификатор кампании.
criterionId
long
Числовой идентификатор критерия.
Авторизация
Этот запрос требует авторизации со следующей областью действия:
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2024-11-08 UTC."],[[["\u003cp\u003eRetrieves a list of conversions from a specified DoubleClick Search engine account within a given date range.\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 the agency, advertiser, engine account, date range, and result pagination.\u003c/p\u003e\n"],["\u003cp\u003eOptionally filter conversions by ad group, ad, campaign, or criterion IDs.\u003c/p\u003e\n"],["\u003cp\u003eResponse provides a Conversion resource containing details about the retrieved conversions.\u003c/p\u003e\n"]]],["This method retrieves conversions from a DoubleClick Search engine account. It requires authorization and uses a GET request with specific path and query parameters. Mandatory parameters include `agencyId`, `advertiserId`, `engineAccountId`, `endDate`, `rowCount`, `startDate`, and `startRow`. Optional parameters include `adGroupId`, `adId`, `campaignId`, and `criterionId`. The successful response contains a list of conversion resources. No request body is needed.\n"],null,["# Conversion: get\n\n| **Note:** Requires [authorization](#auth).\n\nRetrieves a list of conversions from a DoubleClick Search engine account.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|-------------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `advertiserId` | `long` | Numeric ID of the advertiser. |\n| `agencyId` | `long` | Numeric ID of the agency. |\n| `engineAccountId` | `long` | Numeric ID of the engine 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.get)."]]
