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

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

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

Версия 2

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

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

Платежи

payment.list теперь возвращает сведения о платежах для премиум-издателей.

2023-06-13

Отчеты

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

2023-03-30

Отчеты

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

2022-09-21

AdUnits

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

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

Добавлены методы создания, исправления и обновления. Обратите внимание, что эти методы могут использоваться только в проектах, поддерживающих продукт 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.

30 июня 2021 г.

Отчет

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

2021-04-19 (Первоначальный выпуск)

Общий

Все устаревшие методы версии 1.4 были удалены. Это включает в себя методы ресурсов, не требующие accountId . В версии 2 accountId указывается в parent поле.
Согласно стандартам API Google, ресурсы теперь идентифицируются по полю 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 — это логическое значение, которое указывает, включены ли автоматические объявления на определенном сайте.