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

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

Версия 2

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

03.04.2024

Вопросы политики

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

2023-06-19

Платежи

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

2023-06-13

Отчеты

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

2023-03-30

Отчеты

2022-09-21

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

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

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

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

Счета

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

2022-08-25

Отчеты

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

03.05.2022

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

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

Отчеты

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

URL-каналы

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

2022-03-31

Счет

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

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 данные отчетов AdSense Management API теперь соответствуют пользовательскому интерфейсу 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 – это логическое значение, которое показывает, включены ли автоматические объявления на определенном сайте.

Версия 1.4

В этой версии представлены следующие функциональные возможности:

  • Теперь вы можете указать платежи по своему аккаунту AdSense в соответствующей валюте.
  • Теперь вы можете закрыть оповещение, вызвав метод delete , который скроет оповещение в API и веб-интерфейсе AdSense.
  • Ответ на отчет теперь включает даты начала и окончания. Это важно, если вы используете относительные даты при создании отчетов (например, today , yesterday , firstDayOfMonth-1m ), ответ теперь включает запрошенный вами диапазон дат.

Известные вопросы

Поле currency в отчетах не поддерживается в этой версии.

Версия 1.3

В этой версии представлены следующие функциональные возможности:

  • Возможность получения оповещений.
  • Возможность получения метаданных метрик и измерений.
  • Возможность запуска отчетов в местном часовом поясе учетной записи.

Известные вопросы

Поле currency в отчетах не поддерживается в этой версии.

Версия 1.2

В этой версии представлены следующие функциональные возможности:

  • Возможность получения стилей объявлений.
  • Возможность получать и выполнять сохраненные отчеты, определенные во внешнем интерфейсе.

Известные вопросы

Поле currency в отчетах не поддерживается в этой версии.

Версия 1.1

В этой версии представлены следующие функциональные возможности:

Кроме того, теперь вы можете получить доступ к данным либо под своей учетной записью по умолчанию, либо под определенной учетной записью.

Известные вопросы

Поле currency в отчетах не поддерживается в этой версии.

Версия 1

Это первая версия API. Он включает поддержку получения рекламных клиентов, рекламных блоков, пользовательских каналов, URL-каналов, а также создания отчетов.

Известные вопросы

Поле currency в отчетах не поддерживается в этой версии.