Ti consigliamo di utilizzare le librerie client delle API di Google con l'API Bid Manager, in modo da non dover elaborare manualmente le richieste e le risposte HTTP. Le librerie client delle API di Google possono fornire una migliore integrazione del linguaggio, una maggiore sicurezza e supporto per effettuare chiamate che richiedono l'autorizzazione dell'utente.
L'API Bid Manager si basa su HTTP e JSON. Se preferisci elaborare le richieste e le risposte manualmente, puoi utilizzare qualsiasi client HTTP standard.
Installare una libreria client
Offriamo librerie client che supportano l'API Bid Manager in una serie di linguaggi di programmazione. Per un elenco completo delle librerie client, consulta la scheda Esempi e librerie.
Le guide per sviluppatori dell'API Bid Manager forniscono snippet di codice per le seguenti tre lingue:
Per esempi di integrazione completi in queste lingue, consulta il nostro repository GitHub con esempi di API Bid Manager.
Configura il client
Con le credenziali OAuth 2.0 e una libreria client installata, puoi utilizzare l'API Bid Manager. Ecco come autorizzare e configurare il client:
Java
Importa le librerie necessarie.
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;
Carica il file client secret e genera le credenziali di autorizzazione.
La prima volta che esegui questo passaggio, ti viene chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso a Display & Video 360. La tua app sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso.
// 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");
Crea un client API autorizzato.
// Create authorized API client. DoubleClickBidManager service = new DoubleClickBidManager.Builder(credential.getTransport(), credential.getJsonFactory(), credential) .setApplicationName("bidmanager-java-installed-app-sample") .build();
Python
Importa le librerie necessarie.
from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient import discovery
Carica il file client secret e genera le credenziali di autorizzazione.
La prima volta che esegui questo passaggio, ti viene chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso a Display & Video 360. La tua app sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso.
# 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()
Crea un client API autorizzato.
# 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
Questo esempio presuppone che tu stia eseguendo PHP con un server web incorporato e che tu abbia configurato le tue credenziali per il reindirizzamento alla pagina web pertinente. Ad esempio, questo codice, in un file index.php, può essere eseguito utilizzando il seguente comando e le credenziali configurate per reindirizzare a http://localhost:8000 dopo l'autenticazione:
php -S localhost:8000 -t ./Scarica e installa il client PHP delle API Google.
Il metodo preferito è tramite Composer:
composer require google/apiclient:^2.12.1Una volta installato, assicurati di includere l'autoloader
require_once '/path/to/your-project/vendor/autoload.php';Crea un oggetto Google_Client.
$client = new Google_Client();Configura il client, reindirizza all'URL di autenticazione se necessario e recupera un token di accesso.
La prima volta che esegui questo passaggio, ti viene chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso a Display & Video 360. La tua app sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso.
// 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);
Crea un client per il servizio API Display & Video 360.
$service = new Google_Service_DoubleClickBidManager($client);