Прежде чем вы сможете приступить к кодированию своего первого клиентского приложения, вам нужно сделать несколько вещей, если вы еще этого не сделали.
Получите учетную запись Google
Вам нужна учетная запись Google , чтобы создать проект в Google API Console. Если у вас уже есть учетная запись, то все готово.
Вам также может понадобиться отдельная учетная запись Google для целей тестирования.
Попробуйте отчет Google Ad Experience Report
В этой документации по API предполагается, что вы использовали отчет Google Ad Experience Report и знакомы с концепциями веб-программирования и форматами веб-данных.
Если вы еще не использовали отчет Google Ad Experience Report, попробуйте пользовательский интерфейс, прежде чем приступать к написанию кода.
Создайте проект для вашего клиента
Прежде чем вы сможете отправлять запросы в Google Ad Experience Report, вам необходимо сообщить Google о своем клиенте и активировать доступ к API. Вы делаете это, используя Google API Console для создания проекта , который представляет собой именованный набор настроек и информации о доступе к API, и регистрируете свое приложение.
Изучите основы REST
Существует два способа вызова API:
- Отправка HTTP-запросов и анализ ответов.
- Использование клиентских библиотек .
Если вы решите не использовать клиентские библиотеки, вам необходимо понять основы REST.
REST — это стиль архитектуры программного обеспечения, обеспечивающий удобный и последовательный подход к запросу и изменению данных.
Термин REST является сокращением от « Передача репрезентативного состояния ». В контексте API Google это относится к использованию глаголов HTTP для извлечения и изменения представлений данных, хранящихся в Google.
В системе RESTful ресурсы хранятся в хранилище данных; клиент отправляет запрос серверу на выполнение определенного действия (например, создание, извлечение, обновление или удаление ресурса), а сервер выполняет действие и отправляет ответ, часто в форме представления указанного ресурса.
В RESTful API Google клиент указывает действие с помощью команды HTTP, такой как POST , GET , PUT или DELETE . Он определяет ресурс с помощью глобально уникального URI следующего вида:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Поскольку все ресурсы API имеют уникальные доступные по HTTP URI, REST обеспечивает кэширование данных и оптимизирован для работы с распределенной сетевой инфраструктурой.
Вы можете найти полезными определения методов в документации по стандартам HTTP 1.1; они включают спецификации для GET , POST , PUT и DELETE .
REST в Google Ad Experience Report API
Операции Google Ad Experience Report API напрямую сопоставляются с HTTP-командами REST.
Конкретные форматы для URI Google Ad Experience Report API:
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
Полный набор URI, используемых для каждой поддерживаемой операции в API, приведен в документе Справочник по API Google Ad Experience Report .
Изучите основы JSON
Google Ad Experience Report API возвращает данные в формате JSON.
JSON (нотация объектов JavaScript) — это распространенный независимый от языка формат данных, обеспечивающий простое текстовое представление произвольных структур данных. Для получения дополнительной информации см. json.org .