Эта страница переведена с помощью Cloud Translation API.

Примечания к выпуску

На этой странице представлены примечания к выпуску API управления AdSense.

Версия 2

В этой версии внесены следующие изменения с целью удаления устаревших функций и приведения API управления AdSense в соответствие с текущими стандартами Google API . В соответствии со схемой версионирования Google API , эта версия будет обновляться со временем, чтобы включать дополнительные (обратно совместимые) функции, а не выпускать новые функции в отдельных минорных версиях.

2026-02-05

Отчеты

Добавлены параметры OS_TYPE , BROWSER_TYPE и WEBVIEW_TYPE , позволяющие детализировать метрики по операционной системе, браузеру и приложению хостинга (веб-просмотру). Для получения дополнительной информации см. статьи справочного центра « Детализация по операционной системе» , «Детализация по браузеру » и «Детализация по приложению хостинга ».

2025-10-02

Отчеты

Добавлен параметр TRAFFIC_SOURCE , позволяющий детализировать метрики по источникам трафика (например, «Google», «Bing», «Facebook», «Другие»). Для получения дополнительной информации см. «Детализация источников трафика ».

2025-05-06

Политические вопросы

Устаревшее поле policyTopics[].must_fix (см. предыдущее обновление) теперь всегда будет иметь значение false .

2025-02-24

Политические вопросы

Добавлено поле policyTopics[].type для определения того, представляет ли тема политики политическую проблему, нормативную проблему или предпочтения рекламодателя . Оно заменяет поле policyTopics[].must_fix , которое теперь помечено как устаревшее.

2024-04-03

Политические вопросы

Добавлена новая функция для сбора информации о текущих нарушениях правил и предупреждениях, имеющихся в учетной записи.

2023-06-19

Платежи

Теперь payments.list возвращает подробную информацию о платежах для премиум-издателей.

2023-06-13

Отчеты

Добавлены метрики FUNNEL_REQUESTS , FUNNEL_IMPRESSIONS , FUNNEL_CLICKS и FUNNEL_RPM , которые предоставляют информацию о производительности нерекламных блоков (например, блоков, связанных с поиском).

2023-03-30

Отчеты

Добавлен параметр PAGE_URL , позволяющий детализировать метрики по URL-адресам страниц (с некоторыми оговорками, см. Детализация по URL-адресам страниц ).

21.09.2022

Рекламные блоки

Добавлены методы создания и внесения изменений. Обратите внимание, что эти методы могут использоваться только проектами, поддерживающими продукт AdSense for Platforms .

CustomChannels

Добавлены методы создания, внесения изменений и обновления. Обратите внимание, что эти методы могут использоваться только проектами, поддерживающими продукт AdSense for Platforms .
Добавлено активное поле к ресурсу.

Счета

Добавлен метод getAdBlockingRecoveryTag.

2022-08-25

Отчеты

Добавлен параметр HOSTED_AD_CLIENT_ID , который позволяет издателям хостов и платформ детализировать метрики по своим учетным записям (издателям хостов) и по суб-учетным записям (издателям платформ).

2022-05-03

AdClient

Добавлен метод get.

Отчеты

Добавлен метод getSaved.

UrlChannels

Добавлен метод get.

2022-03-31

Счет

Теперь API возвращает информацию о неактивных учетных записях, при этом поле state указывает состояние учетной записи .

AdClient

Аналогично изменениям в разделе «Аккаунты», API теперь возвращает информацию о неактивных рекламных клиентах, при этом поле state указывает на состояние рекламного клиента .

2022-02-24

Оплата

Формат имен ресурсов был расширен для поддержки отдельных ресурсов для заработка на YouTube. Это изменение вносится перед поэтапным внедрением улучшенного функционала AdSense для создателей контента на YouTube , в рамках которого заработок на YouTube будет выделен в отдельный платежный аккаунт. Информация о платежах YouTube также будет возвращаться из списка платежей после того, как у вас появится отдельный платежный аккаунт для заработка на YouTube . Заработок на YouTube будет иметь следующий формат имен ресурсов:
- accounts/{account}/payments/youtube-unpaid — информация о невыплаченных (текущих) доходах от YouTube.
- accounts/{account}/payments/youtube-yyyy-MM-dd — для заработка на платных каналах YouTube.
Примечание: Названия ресурсов, приносящих доход от AdSense, остаются без изменений:
- accounts/{account}/payments/unpaid — неоплаченные (текущие) доходы от AdSense.
- accounts/{account}/payments/yyyy-MM-dd для получения дохода от платной рекламы AdSense.

2021-06-30

Отчет

Добавлены параметры AD_FORMAT_NAME и AD_FORMAT_CODE , указывающие способ показа рекламы пользователям на вашем сайте (на странице, в виньетке и т. д.). Обратите внимание, что в версии 1.4 были (устаревшие) параметры с теми же названиями, но другими элементами; два параметра, добавленные в версии 2, отличаются от тех, которые присутствовали в версии 1.4.

19.04.2021 (Первый релиз)

Общий

Все устаревшие методы из версии 1.4 были удалены. Это включает в себя методы ресурсов, которые не требовали accountId . В версии 2 accountId указывается в поле parent .
В соответствии со стандартами Google API, ресурсы теперь идентифицируются по полю name . Например, имя AdClient будет выглядеть так: accounts/{accountId}/adclients/{adClientId} . Кроме того, в версии 1.4 идентификатор ресурса использовался в качестве параметра отчетности, но в версии 2 это значение теперь доступно через поле reporting_dimension_id для нескольких ресурсов.
Поле kind удалено из всех ресурсов.

Счет

Поле name изменено на display_name .
Поле timezone было изменено со строкового типа на google.type.TimeZone .
Поле creation_time (тип int64) было изменено на create_time (тип google.protobuf.Timestamp ).
Добавлено поле pending_tasks , представляющее собой список незавершенных задач, которые необходимо выполнить в процессе регистрации новой учетной записи. Например, задачи могут быть связаны с вашим платежным профилем или подтверждением номера телефона.
Поле sub_accounts удалено. Аналогичная функциональность может быть реализована в версии 2 с помощью пользовательского метода listChildAccounts . Полное дерево дочерних учетных записей может быть сгенерировано в версии 2 путем рекурсивного вызова метода listChildAccounts .

AdClient

Удалено поле arc_opt_in , поскольку оно уже было удалено из пользовательского интерфейса AdSense.
Поле supports_reporting заменяется полем reporting_dimension_id , которое представляет собой уникальный идентификатор рекламного клиента, используемый в параметре отчетности AD_CLIENT_ID . Если reporting_dimension_id пусто, то AdClient не поддерживает отчетность.

AdUnit

Поле status переименовано в state . Кроме того, состояние ACTIVE больше не указывает на активность данного рекламного блока за последние семь дней. В версии 2 это означает, что рекламный блок активирован пользователем и может показывать рекламу.
Поле code удалено. Это значение по-прежнему можно найти в конце поля name (после последней косой черты).
Поле contentAdsSettings.backupOption было удалено.
Поле type ограничено значениями TYPE_UNSPECIFIED , DISPLAY , FEED , ARTICLE , MATCHED_CONTENT и LINK .
Удаляются и другие поля, которые уже были удалены из пользовательского интерфейса AdSense: custom_style , saved_style_id , mobile_content_ads_settings , feed_ads_settings .

Тревога

Метод delete удален.
Поле is_dismissible удалено.
Поле locale переименовано в language_code .

Пользовательский канал

Поле code удалено. Это значение по-прежнему можно найти в конце поля name (после последней косой черты).
Поле targeting_info было удалено, поскольку оно уже было удалено из пользовательского интерфейса AdSense.

Оплата

Поле payment_date было переименовано в date и изменено с типа string на тип google.type.Date .
Поле payment_amount и поле payment_amount_currency_code объединены в одно поле payment (например, "¥1,235 JPY", "$1,234.57", "£87.65").

Отчет

В версии 2 данные отчетов API управления AdSense теперь соответствуют пользовательскому интерфейсу AdSense. Это означает, что ресурсы AdMob и YouTube больше не поддерживаются. Кроме того, API будет поддерживать данные отчетов только за последние 3 года.
Ресурсы Metadata.dimensions и Metadata.metrics были удалены.
Добавлены новые методы для генерации CSV-версии отчета, заменяющие параметры запроса в версии 1.4. Примечание: для сжатия по-прежнему можно использовать HTTP-заголовок "Accept-Encoding: gzip".
В процессе создания внеплановых отчетов были внесены изменения в некоторые поля.
- Поле account_id переименовано в account .
- Поле dimension переименовано в dimensions .
- Поле metric переименовано в metrics .
- Поле filter переименовано в filters .
- Поле sort переименовано в order_by .
- Поле locale переименовано в language_code .
- Поле currency переименовано в currency_code .
- Теперь вы можете указать несколько распространенных диапазонов с помощью date_range (например, TODAY , YESTERDAY , MONTH_TO_DATE , YEAR_TO_DATE , LAST_7_DAYS и LAST_30_DAYS ), или же указать start_date и end_date , установив параметр date_range в CUSTOM .
- Типы полей start_date и end_date изменены с string на google.type.Date . Примечание: в результате этого ключевые слова для относительных дат (например, "today-6d") больше не поддерживаются.
- Логическое поле use_timezone_reporting было заменено на reporting_time_zone , которое может принимать одно из двух значений: ACCOUNT_TIME_ZONE или GOOGLE_TIME_ZONE (что означает PST/PDT). Значение по умолчанию в версии 2 — ACCOUNT_TIME_ZONE , что отличается от значения по умолчанию в версии 1.4.
- Поле start_index удалено.
- Поле max_results переименовано в limit .
При сохранении отчета были внесены изменения в некоторые поля.
- Добавлены поля для ввода даты ( date_range , start_date , end_date , reporting_time_zone ).
- Добавлено поле currency_code .
- Поле locale переименовано в language_code .
- Поле start_index удалено.
- Поле max_results удалено.

SavedAdStyle

SavedAdStyle была удалена, поскольку она уже была удалена из пользовательского интерфейса AdSense.

Сайт

Добавлены Sites для получения данных о веб-сайтах, которые вы добавили в свой аккаунт AdSense.
Поле state указывает, находится ли сайт в одном из следующих состояний: REQUIRES_REVIEW , GETTING_READY , READY , NEEDS_ATTENTION .
Поле auto_ads_enabled представляет собой логическое значение, указывающее, включена ли автоматическая показ рекламы на конкретном сайте.