Ваше первое приложение: предварительные условия

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

Создайте аккаунт Google и получите разрешения Search Ads 360

Чтобы использовать API Поисковой рекламы 360, вам потребуется учетная запись Google и соответствующие разрешения, предоставленные этой учетной записи из Поисковой рекламы 360:

  1. Если у вас еще нет учетной записи Google, создайте ее .

  2. Попросите менеджера агентства Search Ads 360 создать пользователя Search Ads 360 для вашего аккаунта Google.

    Чтобы скачать отчеты, вам потребуется разрешение на просмотр для рекламодателей, с которыми вы будете работать.

    Чтобы добавить или изменить конверсии, вам потребуется разрешение на редактирование для рекламодателей, с которыми вы будете работать. В общей конфигурации Floodlight вам необходимо разрешение на редактирование для каждого дочернего рекламодателя, которому вы хотите загружать данные о конверсиях. Вам не нужен доступ ни к родительскому рекламодателю, ни к дочерним рекламодателям, которым вы не загружаете конверсии. Если вы используете идентификаторы кликов для связывания конверсий с посещениями , убедитесь, что у вас есть доступ для редактирования к рекламодателю, сгенерировавшему идентификатор клика. Если вы укажете идентификатор клика от рекламодателя, к которому у вас нет прав на редактирование, запрос не будет выполнен.

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

Активировать службу преобразования API

Если вы хотите загружать данные о конверсиях, пользователь Поисковой рекламы 360 с правами менеджера агентства должен войти в пользовательский интерфейс Поисковой рекламы 360 и активировать службу конверсии API . Инструкции см. в Справочном центре Поисковой рекламы 360 .

Создайте проект Google API Console и учетные данные OAuth для своего клиента.

  1. Запустите инструмент настройки Google API Console.
    Инструмент настройки поможет вам создать проект (или использовать существующий проект), включить API Search Ads 360 и создать учетные данные OAuth 2.0.
  2. На странице Регистрация приложения выберите существующий проект или выберите Создать проект . Затем нажмите «Продолжить» .
  3. После того как Google API Console активирует API Search Ads 360, нажмите кнопку Перейти к учетным данным .
  4. На странице Создать учетные данные введите следующую информацию:
    • Какой API вы используете? : API Поисковой рекламы 360
    • К каким данным вы будете иметь доступ? : Данные пользователя
  5. Нажмите кнопку «Далее» .

    Инструмент установки теперь предлагает помощь в создании идентификатора клиента OAuth 2.0 .

  6. Выполните остальные шаги в средстве настройки.

Установите sa360Api.py

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

Чтобы установить скрипт:

  1. Установите Python 2.7.
    Скрипт не работает с Python 3.x.
  2. Установите кУРЛ .
  3. Загрузите sa360Api.zip .
  4. Извлеките sa360Api.py из sa360Api.zip .
  5. Сделайте исполняемый файл sa360Api.py .

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

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

Если вы решите не использовать клиентские библиотеки, вам необходимо понять основы 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 .