Прежде чем вы сможете приступить к кодированию своего первого клиентского приложения, вам нужно сделать несколько вещей, если вы еще этого не сделали.
Создайте аккаунт Google и получите разрешения Search Ads 360
Чтобы использовать API Поисковой рекламы 360, вам потребуется учетная запись Google и соответствующие разрешения, предоставленные этой учетной записи из Поисковой рекламы 360:
Если у вас еще нет учетной записи Google, создайте ее .
Попросите менеджера агентства Search Ads 360 создать пользователя Search Ads 360 для вашего аккаунта Google.
Чтобы скачать отчеты, вам потребуется разрешение на просмотр для рекламодателей, с которыми вы будете работать.
Чтобы добавить или изменить конверсии, вам потребуется разрешение на редактирование для рекламодателей, с которыми вы будете работать. В общей конфигурации Floodlight вам необходимо разрешение на редактирование для каждого дочернего рекламодателя, которому вы хотите загружать данные о конверсиях. Вам не нужен доступ ни к родительскому рекламодателю, ни к дочерним рекламодателям, которым вы не загружаете конверсии. Если вы используете идентификаторы кликов для связывания конверсий с посещениями , убедитесь, что у вас есть доступ для редактирования к рекламодателю, сгенерировавшему идентификатор клика. Если вы укажете идентификатор клика от рекламодателя, к которому у вас нет прав на редактирование, запрос не будет выполнен.
Менеджер агентства может настроить вашу учетную запись как пользователя рекламодателя с доступом к определенным рекламодателям или настроить вашу учетную запись с более высоким уровнем доступа, например, как пользователя агентства с доступом ко всем рекламодателям в агентстве.
Активировать службу преобразования API
Если вы хотите загружать данные о конверсиях, пользователь Поисковой рекламы 360 с правами менеджера агентства должен войти в пользовательский интерфейс Поисковой рекламы 360 и активировать службу конверсии API . Инструкции см. в Справочном центре Поисковой рекламы 360 .
Создайте проект Google API Console и учетные данные OAuth для своего клиента.
- Запустите инструмент настройки Google API Console.
Инструмент настройки поможет вам создать проект (или использовать существующий проект), включить API Search Ads 360 и создать учетные данные OAuth 2.0. - На странице Регистрация приложения выберите существующий проект или выберите Создать проект . Затем нажмите «Продолжить» .
- После того как Google API Console активирует API Search Ads 360, нажмите кнопку Перейти к учетным данным .
- На странице Создать учетные данные введите следующую информацию:
- Какой API вы используете? : API Поисковой рекламы 360
- К каким данным вы будете иметь доступ? : Данные пользователя
- Нажмите кнопку «Далее» .
Инструмент установки теперь предлагает помощь в создании идентификатора клиента OAuth 2.0 .
- Выполните остальные шаги в средстве настройки.
Установите sa360Api.py
Поисковая реклама 360 предоставляет служебный скрипт, облегчающий процесс настройки авторизации. Вы также можете использовать этот сценарий для отправки и получения данных в формате JSON, если вы хотите попробовать отправить и получить данные, прежде чем разрабатывать и писать полноценное приложение. Вы можете скопировать многие примеры JSON с этого сайта документации и ввести их непосредственно в сценарий.
Чтобы установить скрипт:
- Установите Python 2.7.
Скрипт не работает с Python 3.x. - Установите кУРЛ .
- Загрузите sa360Api.zip .
- Извлеките
sa360Api.pyизsa360Api.zip. - Сделайте исполняемый файл
sa360Api.py.
Изучите основы 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 в API Search Ads 360
Операции API Search Ads 360 напрямую сопоставляются с HTTP-командами REST.
Конкретный формат для URI API Search Ads 360:
https://www.googleapis.com/doubleclicksearch/v2/resourcePath?parameters
Полный набор URI, используемых для каждой поддерживаемой операции в API, приведен в Справочнике по API .
Изучите основы JSON
Если вы используете REST, вам нужно будет использовать формат JSON для тела запроса. Вы можете указать, что ответы должны быть в формате JSON или CSV.
JSON (нотация объектов JavaScript) — это распространенный независимый от языка формат данных, обеспечивающий простое текстовое представление произвольных структур данных. Для получения дополнительной информации см. json.org .