Мы рекомендуем использовать клиентские библиотеки Google API с API Bid Manager, чтобы вам не приходилось вручную обрабатывать HTTP-запросы и ответы. Клиентские библиотеки Google API могут обеспечить лучшую языковую интеграцию, повышенную безопасность и поддержку вызовов, требующих авторизации пользователя.
API Bid Manager основан на HTTP и JSON. Если вы предпочитаете обрабатывать запросы и ответы вручную, вы можете использовать любой стандартный HTTP-клиент.
Установить клиентскую библиотеку
Мы предлагаем клиентские библиотеки, которые поддерживают API Bid Manager на различных языках программирования. Полный список клиентских библиотек смотрите на вкладке «Образцы и библиотеки» .
В руководствах для разработчиков Bid Manager API представлены фрагменты кода для следующих трех языков:
Полные примеры интеграции на этих языках можно найти в нашем репозитории GitHub с примерами Bid Manager API .
Настройте свой клиент
Имея учетные данные OAuth 2.0 и установленную клиентскую библиотеку , вы готовы использовать Bid Manager API. Вот как авторизовать и настроить ваш клиент:
Ява
Импортируйте необходимые библиотеки.
import static java.nio.charset.StandardCharsets.UTF_8; import com.google.api.client.auth.oauth2.Credential; import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp; import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver; import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow; import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets; import com.google.api.client.googleapis.util.Utils; import com.google.api.services.doubleclickbidmanager.DoubleClickBidManager; import java.io.Reader; import java.nio.file.Files; import java.nio.file.Paths;
Загрузите файл секретов клиента и сгенерируйте учетные данные для авторизации.
При первом выполнении этого шага вам будет предложено принять запрос на авторизацию в браузере. Прежде чем принять, убедитесь, что вы вошли в учетную запись Google, у которой есть доступ к Display & Video 360. Вашему приложению будет разрешен доступ к данным от имени той учетной записи, в которую в данный момент выполнен вход.
// Read client secrets file. GoogleClientSecrets clientSecrets; try (Reader reader = Files.newBufferedReader(Paths.get(path-to-client-secrets-file), UTF_8)) { clientSecrets = GoogleClientSecrets.load(Utils.getDefaultJsonFactory(), reader); } // Generate authorization credentials. // Set up the authorization code flow. GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow.Builder( Utils.getDefaultTransport(), Utils.getDefaultJsonFactory(), clientSecrets, oauth-scopes) .build(); Credential credential = new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");
Создайте авторизованный клиент API.
// Create authorized API client. DoubleClickBidManager service = new DoubleClickBidManager.Builder(credential.getTransport(), credential.getJsonFactory(), credential) .setApplicationName("bidmanager-java-installed-app-sample") .build();
Питон
Импортируйте необходимые библиотеки.
from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient import discovery
Загрузите файл секретов клиента и сгенерируйте учетные данные для авторизации.
При первом выполнении этого шага вам будет предложено принять запрос на авторизацию в браузере. Прежде чем принять, убедитесь, что вы вошли в учетную запись Google, у которой есть доступ к Display & Video 360. Вашему приложению будет разрешен доступ к данным от имени той учетной записи, в которую в данный момент выполнен вход.
# Set up a flow object to create the credentials using the # client secrets file and OAuth scopes. credentials = InstalledAppFlow.from_client_secrets_file( path-to-client-secrets-file, oauth-scopes).run_local_server()
Создайте авторизованный клиент API.
# Build the discovery document URL. discovery_url = f'https://doubleclickbidmanager.googleapis.com/$discovery/rest?version=v2' # Build the API service. service = discovery.build( 'doubleclickbidmanager', 'v2', discoveryServiceUrl=discovery_url, credentials=credentials)
PHP
В этом примере предполагается, что вы используете PHP со встроенным веб-сервером и настроили свои учетные данные для перенаправления на соответствующую веб-страницу. Например, этот код в файле index.php
можно запустить с помощью следующей команды и учетных данных, настроенных для перенаправления на http://localhost:8000
после аутентификации:
php -S localhost:8000 -t ./
Загрузите и установите PHP-клиент Google API.
Предпочтительный метод — через Composer :
composer require google/apiclient:^2.12.1
После установки обязательно включите автозагрузчик.
require_once '/path/to/your-project/vendor/autoload.php';
Создайте объект Google_Client.
$client = new Google_Client();
Настройте клиент, при необходимости перенаправьте его на URL-адрес аутентификации и получите токен доступа.
При первом выполнении этого шага вам будет предложено принять запрос на авторизацию в браузере. Прежде чем принять, убедитесь, что вы вошли в учетную запись Google, у которой есть доступ к Display & Video 360. Вашему приложению будет разрешен доступ к данным от имени той учетной записи, в которую в данный момент выполнен вход.
// Set up the client. $client->setApplicationName('DBM API PHP Samples'); $client->addScope(oauth-scope); $client->setAccessType('offline'); $client->setAuthConfigFile(path-to-client-secrets-file); // If the code is passed, authenticate. If not, redirect to authentication page. if (isset($_GET['code'])) { $client->authenticate($_GET['code']); } else { $authUrl = $client->createAuthUrl(); header('Location: ' . $authUrl); } // Exchange authorization code for an access token. $accessToken = $client->getAccessToken(); $client->setAccessToken($accessToken);
Создайте клиент для службы API Display & Video 360.
$service = new Google_Service_DoubleClickBidManager($client);