Nous vous recommandons d'utiliser les bibliothèques clientes de l'API Google avec l'API Bid Manager afin de sans avoir à traiter manuellement les requêtes et les réponses HTTP. L'API Google les bibliothèques clientes peuvent offrir une meilleure intégration des langages, une sécurité renforcée la prise en charge des appels qui nécessitent l'autorisation de l'utilisateur.
L'API Bid Manager repose sur HTTP et JSON. Si vous préférez traiter les demandes et les réponses manuellement, vous pouvez utiliser n'importe quel client HTTP standard.
Installer une bibliothèque cliente
Nous proposons des bibliothèques clientes compatibles avec l'API Bid Manager dans différents les langages de programmation. Pour obtenir la liste complète des bibliothèques clientes, consultez la section Exemples et l'onglet "Bibliothèques".
Les guides du développeur de l'API Bid Manager fournissent des extraits de code pour les trois langues:
Pour obtenir des exemples d'intégration complets dans ces langages, consultez les exemples de l'API Bid Manager. dépôt GitHub.
Configurer votre client
Avec des identifiants OAuth 2.0 et un client installé , vous êtes prêt à utiliser l'API Bid Manager. Voici comment procéder : autoriser et configurer votre client:
Java
Importez les bibliothèques nécessaires.
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;
Chargez le fichier de codes secrets du client et générez des identifiants d'autorisation.
La première fois que vous effectuez cette étape, vous êtes invité à accepter une autorisation dans votre navigateur. Avant d'accepter, vérifiez que vous êtes connecté avec un Compte Google ayant accès à Display & Video 360. Votre application sera autorisée pour accéder aux données au nom du compte actuellement connecté.
// 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");
Créez un client API autorisé.
// Create authorized API client. DoubleClickBidManager service = new DoubleClickBidManager.Builder(credential.getTransport(), credential.getJsonFactory(), credential) .setApplicationName("bidmanager-java-installed-app-sample") .build();
Python
Importez les bibliothèques nécessaires.
from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient import discovery
Chargez le fichier de codes secrets du client et générez des identifiants d'autorisation.
La première fois que vous effectuez cette étape, vous êtes invité à accepter une autorisation dans votre navigateur. Avant d'accepter, vérifiez que vous êtes connecté avec un Compte Google ayant accès à Display & Video 360. Votre application sera autorisée pour accéder aux données au nom du compte actuellement connecté.
# 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()
Créez un client API autorisé.
# 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
Cet exemple suppose que vous exécutez PHP avec un serveur Web intégré et
avez configuré vos identifiants pour vous rediriger vers la page Web appropriée. Pour
Dans cet exemple, ce code dans un fichier index.php
peut être exécuté à l'aide du code suivant :
et les identifiants configurés pour rediriger vers http://localhost:8000
après
authentification:
php -S localhost:8000 -t ./
Téléchargez et installez le client PHP Google API.
La méthode privilégiée consiste à utiliser Composer:
composer require google/apiclient:^2.12.1
Une fois l'installation effectuée, n'oubliez pas d'inclure le chargeur automatique.
require_once '/path/to/your-project/vendor/autoload.php';
Créez un objet Google_Client.
$client = new Google_Client();
Configurez le client, redirigez vers l'URL d'authentification si nécessaire et récupérez un jeton d'accès.
La première fois que vous effectuez cette étape, vous êtes invité à accepter une autorisation dans votre navigateur. Avant d'accepter, vérifiez que vous êtes connecté avec un Compte Google ayant accès à Display & Video 360. Votre application sera autorisée pour accéder aux données au nom du compte actuellement connecté.
// 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);
Créer un client pour le réseau Display & Service d'API Video 360
$service = new Google_Service_DoubleClickBidManager($client);