Требования

Прежде чем приступить к написанию своего первого клиентского приложения, вам необходимо сделать несколько вещей, если вы этого еще не сделали.

Зарегистрируйте аккаунт Google

Для создания проекта в Google API Console вам понадобится учётная запись Google . Если у вас уже есть учётная запись, всё готово.

Вам также может понадобиться отдельная учетная запись Google для тестирования.

Попробуйте отчет Google Ad Experience Report

В этой документации по API предполагается, что вы использовали Google Ad Experience Report и знакомы с концепциями веб-программирования и форматами веб-данных.

Если вы еще не использовали Google Ad Experience Report, попробуйте пользовательский интерфейс, прежде чем приступать к кодированию.

Создайте проект для вашего клиента

Прежде чем отправлять запросы в Google Ad Experience Report, необходимо сообщить Google о вашем клиенте и активировать доступ к API. Для этого необходимо создать проект (имеющий набор настроек и информации о доступе к API) в Google API Console и зарегистрировать приложение.

Изучите основы REST

Существует два способа вызова API:

Если вы решите не использовать клиентские библиотеки, вам необходимо понять основы REST.

REST — это стиль архитектуры программного обеспечения, который обеспечивает удобный и последовательный подход к запросу и изменению данных.

Термин REST — это сокращение от « Representational State Transfer» (передача репрезентативного состояния ). В контексте API Google он означает использование HTTP-команд для извлечения и изменения представлений данных, хранящихся в Google.

В системе RESTful ресурсы хранятся в хранилище данных; клиент отправляет запрос серверу на выполнение определенного действия (например, создание, извлечение, обновление или удаление ресурса), а сервер выполняет действие и отправляет ответ, часто в форме представления указанного ресурса.

В RESTful API Google клиент задаёт действие с помощью HTTP-команды, например POST , GET , PUT или DELETE . Ресурс задаётся глобально уникальным URI следующего вида:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Поскольку все ресурсы API имеют уникальные URI, доступные по HTTP, REST обеспечивает кэширование данных и оптимизирован для работы с распределенной инфраструктурой Интернета.

Определения методов в документации по стандартам HTTP 1.1 могут оказаться вам полезными; они включают спецификации для GET , POST , PUT и DELETE .

REST в API отчетов по опыту использования рекламы Google

Операции API отчета об эффективности рекламы Google напрямую соответствуют HTTP-глаголам REST.

Конкретные форматы URI API отчетов по опыту использования рекламы Google:

https://adexperiencereport.googleapis.com/v1/resourcePath?parameters

Полный набор URI, используемых для каждой поддерживаемой операции в API, обобщен в справочном документе API Google Ad Experience Report .

Изучите основы JSON

API отчетов по опыту использования рекламы Google возвращает данные в формате JSON.

JSON (JavaScript Object Notation) — распространённый, независимый от языка формат данных, обеспечивающий простое текстовое представление произвольных структур данных. Подробнее см. на сайте json.org .