Предыдущий 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 будут по-прежнему поддерживаться.
Тип отчета: негативноеCampaignKeyword
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Атрибуты конфигурации для минус-слов, созданных на уровне кампании.
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод Reports.request() ).
Запросить выдержку
Отправьте обычное тело запроса Reports.request() , но укажите "reportType": "negativeCampaignKeyword"
.
{
...
"reportType": "negativeCampaignKeyword",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
Для каждого столбца, который вы хотите вернуть или отфильтровать в отчете, укажите columnName
, указанное в таблице ниже. Вы также можете дополнительно указать headerText , startDate и endDate . Обратите внимание, что некоторые столбцы нельзя фильтровать; см. раздел «Фильтрируемый» в таблице ниже.
columnName | Описание | Поведение | Тип | Фильтруемый |
---|
status | Статус минус-слова: Active или Removed . Обратите внимание, что кампании, группы объявлений, ключевые слова и объявления имеют свой собственный статус. Смотрите статус . | атрибут | Status | Да |
engineStatus | Дополнительный статус минус-слова кампании во внешнем аккаунте системы. | атрибут | String | Да |
creationTimestamp | Временная метка создания минус-слова в формате ISO 8601. | атрибут | Timestamp | Да |
lastModifiedTimestamp | Временная метка последней модификации минус-слова в формате ISO 8601. | атрибут | Timestamp | Да |
agency | Название агентства. | атрибут | String | Да |
agencyId | Идентификатор агентства DS. | атрибут | ID | Да |
advertiser | Имя рекламодателя. | атрибут | String | Да |
advertiserId | Идентификатор рекламодателя DS. | атрибут | ID | Да |
account | Имя учетной записи системы. | атрибут | String | Да |
accountId | Идентификатор учетной записи ядра DS. | атрибут | ID | Да |
accountEngineId | Идентификатор учетной записи во внешней учетной записи системы. | атрибут | String | Да |
accountType | Тип учетной записи системы: Google AdWords , Bing Ads , Yahoo Japan Listing Ads , Yahoo Search Marketing , Yahoo Gemini , Baidu или Comparison Shopping . | атрибут | Engine type | Да |
campaign | Название кампании. | атрибут | String | Да |
campaignId | Идентификатор кампании DS. | атрибут | ID | Да |
campaignStatus | Статус кампании, содержащей этот элемент. | атрибут | Status | Да |
negativeCampaignKeywordId | Идентификатор минус-слова кампании DS. | атрибут | ID | Да |
negativeCampaignKeywordText | Текст ключевого слова. | атрибут | String | Да |
negativeCampaignKeywordMatchType | Тип соответствия минус-слова: Broad , Exact , Phrase или Content . В настоящее время только для аккаунтов Google Рекламы. | атрибут | Match type | Да |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\u003cp\u003eThis report provides configuration attributes for negative keywords specifically created at the campaign level.\u003c/p\u003e\n"],["\u003cp\u003eThe report is accessible only through an asynchronous request using the \u003ccode\u003eReports.request()\u003c/code\u003e method with \u003ccode\u003e"reportType": "negativeCampaignKeyword"\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIt includes details such as status, match type, keyword text, and timestamps, along with identifiers for agency, advertiser, account, and campaign.\u003c/p\u003e\n"],["\u003cp\u003eUsers can filter and retrieve specific data by specifying column names like \u003ccode\u003estatus\u003c/code\u003e, \u003ccode\u003eengineStatus\u003c/code\u003e, \u003ccode\u003ecreationTimestamp\u003c/code\u003e, etc., in the request body.\u003c/p\u003e\n"]]],["To retrieve data on campaign-level negative keywords, use the `Reports.request()` method with `\"reportType\": \"negativeCampaignKeyword\"`. Specify desired columns in the request body using `columnName`, and optionally `headerText`, `startDate`, and `endDate`. You can filter the output with columns. Available columns include keyword status (`Active`, `Removed`), timestamps, agency/advertiser/account details, campaign information, keyword text, and match type (for Google Ads accounts). The columns available are `filterable`.\n"],null,["# Report Type: negativeCampaignKeyword\n\nConfiguration attributes for negative keywords that have been created at the campaign level.\n\n\nThis report can only be returned by an asynchronous request (that is, via the\n[Reports.request()](/search-ads/v2/reference/reports/request) method).\n\n### Request excerpt\n\n\nSend a regular\n[Reports.request()](/search-ads/v2/reference/reports/request)\nrequest body, but specify `\"reportType\": \"negativeCampaignKeyword\"`.\n\n```text\n{\n...\n \"reportType\": \"negativeCampaignKeyword\",\n \"columns\": [\n {\n \"columnName\": string,\n \"headerText\": string,\n \"startDate\": string,\n \"endDate\": string\n }\n ],\n \"filters\": [\n {\n \"column\": {\n \"columnName\": string,\n },\n ...\n },\n ...\n ],\n...\n}\n```\n\n\nFor each column that you want returned or filtered in the report,\nspecify the `columnName` listed in the table below.\nYou can also optionally specify\n[headerText](/search-ads/v2/reference/reports#request.columns.headerText),\n[startDate](/search-ads/v2/reference/reports#request.columns.startDate),\nand [endDate](/search-ads/v2/reference/reports#request.columns.endDate).\nNote that some columns cannot be filtered; refer to \"Filterable\" in the table below.\n\n| `columnName` | Description | Behavior | Type | Filterable |\n|------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|---------------|------------|\n| `status` | The status of the negative keyword: `Active` or `Removed`. Note that campaigns, ad groups, keywords, and ads each have their own status. See [status](https://support.google.com/searchads/answer/2405081). | attribute | `Status` | Yes |\n| `engineStatus` | Additional status of the negative campaign keyword in the external engine account. | attribute | `String` | Yes |\n| `creationTimestamp` | Timestamp of the negative keyword's creation, formatted in ISO 8601. | attribute | `Timestamp` | Yes |\n| `lastModifiedTimestamp` | Timestamp of the negative keyword's most recent modification, formatted in ISO 8601. | attribute | `Timestamp` | Yes |\n| `agency` | Agency name. | attribute | `String` | Yes |\n| `agencyId` | DS agency ID. | attribute | `ID` | Yes |\n| `advertiser` | Advertiser name. | attribute | `String` | Yes |\n| `advertiserId` | DS advertiser ID. | attribute | `ID` | Yes |\n| `account` | Engine account name. | attribute | `String` | Yes |\n| `accountId` | DS engine account ID. | attribute | `ID` | Yes |\n| `accountEngineId` | ID of the account in the external engine account. | attribute | `String` | Yes |\n| `accountType` | Engine account type: `Google AdWords`, `Bing Ads`, `Yahoo Japan Listing Ads`, `Yahoo Search Marketing`, `Yahoo Gemini`, `Baidu`, or `Comparison Shopping`. | attribute | `Engine type` | Yes |\n| `campaign` | Campaign name. | attribute | `String` | Yes |\n| `campaignId` | DS campaign ID. | attribute | `ID` | Yes |\n| `campaignStatus` | The status of the campaign that contains this item. | attribute | `Status` | Yes |\n| `negativeCampaignKeywordId` | DS negative campaign keyword ID. | attribute | `ID` | Yes |\n| `negativeCampaignKeywordText` | The keyword text. | attribute | `String` | Yes |\n| `negativeCampaignKeywordMatchType` | Match type of the negative keyword: `Broad`, `Exact`, `Phrase`, or `Content`. Currently only for Google Ads accounts. | attribute | `Match type` | Yes |"]]