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

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

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

Версия 2

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

19.06.2023

Платежи

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

2023-06-13

Отчеты

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

2023-03-30

Отчеты

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

2022-09-21

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

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

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

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

Счета

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

2022-08-25

Отчеты

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

03.05.2022

Рекламный клиент

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

Отчеты

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

URL-каналы

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

2022-03-31

Счет

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

Рекламный клиент

Как и в случае с изменениями в учетной записи, описанными выше, API теперь возвращает неактивные рекламные клиенты с полем state , указывающим состояние рекламного клиента .

2022-02-24

Оплата

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

2021-06-30

Отчет

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

19 апреля 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 .

Рекламный клиент

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

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

Поле 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 (например, «1235 иен», «1234,57 доллара США», «87,65 фунтов стерлингов»).

Отчет

В версии 2 данные отчетов API управления AdSense теперь соответствуют пользовательскому интерфейсу AdSense. Это означает, что ресурсы AdMob и YouTube больше не поддерживаются. Кроме того, API будет поддерживать данные отчетов только за три года.
Ресурсы 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 . Примечание. В результате ключевые слова с относительными датами (например, «сегодня-6д») больше не поддерживаются.
- Логическое поле 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 был удален, поскольку он уже был удален из пользовательского интерфейса AdSense.

Сайт

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