Changelog
Source:NEWS.md
rgoogleads 0.9.1
CRAN release: 2023-03-30
- Исправленна ссылка в документации функции
gads_get_accessible_customers()
.
rgoogleads 0.8.1
CRAN release: 2023-01-18
- Из виньеток удалены битые ссылки на устаревший раздел документации по миграции с Google AdWords API на Google Ads API.
rgoogleads 0.8.0
CRAN release: 2022-08-12
- Пакет переведён на работу с Google Ads API 11.0
- В связи с тем, что HTML документация в R 4.2.0 переведена на использование HTML5 по требованиям CRAN была заново сгенерирована вся документация пакета.
rgoogleads 0.7.1
CRAN release: 2022-05-31
- Исправил ссылки на документацию к Google Ads API, с v8 на v10.
rgoogleads 0.7.0
- Пакет переведён на работу с Google Ads API v10.
- В блок
gads_utils.R
добавлена функцияgads_make_request()
, теперь это основная функция генерации HTTP запроса, она используется в остальных функциях для отправки запросов. - Исправил логическую ошибку в функции
gads_get_report()
, ранее функция формировала запрос, и только потом осуществляла проверку, может ли указанный ресурс запрашиваться с сегментами времени. - Полностью переписана функция
gads_customer()
, ранее она была написана на основе метода get, который в 10 версии API был упразднён, теперь функция использует методSearchStream
. Это обновление так же затронуло функциюgads_get_accessible_customers()
, т.к. в неё использоваласьgads_customer()
.
rgoogleads 0.6.0
CRAN release: 2022-04-19
- В функцию
gads_get_report()
добавлен аргумент gaql_query, который позволяет передать функции готовый текст запроса, скопированный из QueryBuilder. - Новая функция
gads_get_keywords()
для запроса списка ключевых слов.
rgoogleads 0.4.1
CRAN release: 2021-11-24
Дата релиза: 2021-11-24
Процесс проверки совместимости запрашиваемого ресурса с сегментами даты вынесен на более высокий уровень, из функции gads_get_report_helper() в функцию gads_get_report().
Кеш функции
gads_get_fields_cached()
теперь сохраняется в памяти, а не на жестком диске. И действует только в ходе текщей R сессии. Связано с тем, что присохранении на диск, после установки из CRAN пакет не мог получить доступ к кешу. Т.е. связано с ошибкойAttempted to use cache which has been destroyed
.
rgoogleads 0.4.0
CRAN release: 2021-11-16
- Дата релиза: 2021-11-16
Прочее
- Пакет переведён на работу с Google Ads API v9.
- В пакет добавлена поддержка переменной среды GADS_EMAIL, которая устанавливает дефолтный email для работы с Google Ads API при подключении пакета.
- В основную функцию запроса данных
gads_get_report_helper()
добавлена проверка, можно ли запрашивать с указанным ресурсом поля даты, если нет, то функция аннулирует значения аргументовdate_from
,date_to
иduring
. - В зависимости
rgoogleads
добавлены следующие пакеты:memoise
,cachem
,rappdirs
. Эти пакеты обеспечивают кеширование данных, получаемых функциейgads_get_fields()
, которая используется внутриgads_get_report_helper()
для проверки совместимости запрашиваемого ресурса с полями даты.
rgoogleads 0.3.0
CRAN release: 2021-09-03
- Дата релиза: 2021-09-02
rgoogleads 0.2.0
CRAN release: 2021-08-02
- Дата релиза: 2021-08-02
Новые функции:
- Добавлена функция
gads_get_fields()
, которая позволяет получить подробную информацию по любому ресурсу, полю ресурса, сегмету или метрике. - Добавлена функция
gads_get_geo_targets()
, которая загружает наиболее актуальный справочник гео таргетинга из https://developers.google.com/google-ads/api/reference/data/geotargets?hl=en. - Добавлена функция
gads_get_metadata()
, которая позволяет получить список всех объектов вместе с их метаданными, т.е. ресурсов, сегментов, метрик и атриутов. - Добавлена функция
gads_keyword_plan_historical_metrics()
, с помощью которой вы можете запрашивать данные по сохраннным планам ключевых слов. - Добавлена функция
gads_keyword_plan_forecast_timeseries()
, которая позволяет запросить прогноз в виде временного ряда для плана ключевых слов на следующие 52 недели. - Добавлена функция
gads_keyword_plan_forecast_metrics()
, которая возвращает запрошенные прогнозы плана ключевых слов. - Добавлена функция
gads_open_auth_cache_folder()
, с помощью которой можно открыть папаку, в которой хранятся учётные данные.
Документация:
- Доработана основная страница документации пакета
- Расширена документация функции
gads_get_report()
- Расширена документация функции
gads_auth()
- В документацию к функциям загрузки объектов добавлены примеры кода:
gads_get_ad_group_criterions()
,gads_get_ad_groups()
,gads_get_ads()
,gads_get_campaigns()
.
Прочие доработки:
- OAuth клиент вшитый в пакет прошел верификацию Google, теперь любой пользователь пакета может использовать вшитый в
rgoogleads
OAuth клиент для авторизации. - Вшитый в пакет токен разработчика получил стандартный уровень доступа к API.
- Добавлена опция
gads.column.name.case.fun
, с помощью которой можно передать любую функцию для приведения названий столбцов в полученном от API результате в указанный регистр, по умолчанию передаётся функцияto_snake_case()
из пакетаsnakecase
. - Доработана функция проверки ответа от API на ошибки.
- В функцию
gads_auth_configure()
добавлен аргумент developer_token. - В DESCRIPTION изменил версии некоторых пакетов.
- Все функций пакета, отправляющие POST и GET запросы к API переведены с глаголов из
httr
на глаголыgargle
:request_build()
,request_retry()
,response_process()
. В качестве эксперемента пока, что переведена вспомогательная функцияgads_customer_id()
. - Новый логотип пакета.
- В функцию
gads_get_report()
добавлен аргумент during, который позволяет задавать относительный период отчёта, например ‘LAST_BUSINESS_WEEK’. - Исправил ошибку в функции
gads_get_report()
, когда поле в названии которого содержится date нельзя перевести в дату. - Создал сайт пакета с помощью
pkgdown
, сайт доступен по ссылке.