API для формирования отчетов DV360 Exchange предоставляет сторонним партнерам по обмену данными (3PE) программный доступ к отчетам о производительности Display & Video 360.
API DV360 Exchange Reporting предоставляется через Google Cloud API на основе списков разрешенных пользователей, использующий OAuth. Процесс добавления в списки разрешенных пользователей обрабатывается командой разработчиков API DV360 Exchange Reporting.
Процедура
Ниже описаны шаги по подключению к API отчетов DV360 Exchange:
Зарегистрируйте учетную запись Google в консоли Google Cloud .
Обратите внимание, что эта учетная запись предназначена для управления токенами доступа для вашего рабочего клиента, поэтому не используйте свою личную учетную запись Gmail.
Обратитесь в Google DV360, предоставив информацию об учетной записи, чтобы ее добавили в список разрешенных.
После получения уведомления о включении в список разрешенных пользователей, запросите проверку подлинности OAuth , чтобы предоставить вашему приложению доступ к области действия
doubleclickbidmanager.Войдите в консоль Google Cloud .
Перейдите в раздел API и сервисы > Библиотека > Частные . Вы должны увидеть API DV360 Exchange Reporting в списке доступных вам API. Включите API DV360 Exchange Reporting.
Перейдите в раздел «Учетные данные» > «Создать учетные данные» > «Ключ учетной записи службы» . Следуйте инструкциям для создания учетной записи службы .
Служебный аккаунт
Сервисный аккаунт позволяет вашему коду отправлять учетные данные приложения непосредственно в API. Сервисный аккаунт, как и пользовательский, представлен адресом электронной почты. Однако, в отличие от пользовательского аккаунта, сервисный аккаунт принадлежит только приложению и может использоваться только для доступа к тому API, для которого он был создан.
Вот шаги по созданию учетных данных сервисной учетной записи с помощью консоли Google Cloud:
На странице «Менеджер API > Учетные данные» выберите «Создать учетные данные» → «Ключ учетной записи службы» .
Выберите «Новая учетная запись службы» в раскрывающемся списке « Учетные записи служб» .
Введите имя для этой учетной записи службы. Это имя будет использоваться в качестве имени по умолчанию для вашего идентификатора учетной записи службы , слева от символа
@в сгенерированном адресе идентификатора учетной записи службы.В поле «Тип ключа » рекомендуется оставить значение
JSON. Нажмите «Создать» , чтобы сгенерировать ключ JSON в виде текстового файла.json. Когда появится запрос, загрузите файл на свой компьютер, и отобразится диалоговое окно «Создана учетная запись службы» .
Вот пример ключа JSON:
{ "type": "service_account", "project_id": "project-id", "private_key_id": "some_number", "private_key": "-----BEGIN PRIVATE KEY-----\n.... =\n-----END PRIVATE KEY-----\n", "client_email": "<api-name>api@project-id.iam.gserviceaccount.com", "client_id": "...", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com" }Надежно храните свой JSON-файл, поскольку он содержит ваш закрытый ключ, и этот файл является единственной копией этого ключа. Учетные данные из этого файла необходимы, когда ваш код будет обращаться к API.
Свяжитесь с DV360, предоставив информацию о созданном вами сервисном аккаунте , а именно адрес электронной почты этого аккаунта. Это часть процесса добавления в список разрешенных пользователей для доступа к API.
токен доступа
После того, как ваша учетная запись службы будет авторизована для выполнения вызовов к API, вы можете перейти к примерам в руководствах по API. Для получения токена доступа вручную вы можете использовать такой инструмент, как oauth2l ; или использовать одну из наших клиентских библиотек для программной аутентификации.