Consigliamo di utilizzare le librerie client dell'API di Google con l'API di Bid Manager, in modo da poter non devono elaborare manualmente richieste e risposte HTTP. L'API di Google librerie client possono fornire una migliore integrazione del linguaggio, una maggiore sicurezza e per effettuare chiamate che richiedono l'autorizzazione dell'utente.
L'API di Bid Manager si basa su HTTP e JSON. Se preferisci elaborare le richieste manualmente, puoi usare qualsiasi client HTTP standard.
Installa una libreria client
Sono disponibili librerie client che supportano l'API di Bid Manager in diversi linguaggi di programmazione. Per un elenco completo delle librerie client, consulta la sezione Esempi e Libreria.
Le guide per gli sviluppatori dell'API Bid Manager forniscono snippet di codice per i tre seguenti elementi: lingue:
Per esempi di integrazione completi in queste lingue, consulta gli esempi di API Bid Manager GitHub di ASL.
Configura il client
Con credenziali OAuth 2.0 e un client installato. , puoi iniziare a utilizzare l'API Bid Manager. Di seguito viene spiegato 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 dei client secret e genera le credenziali di autorizzazione.
La prima volta che esegui questo passaggio ti viene chiesto di accettare un'autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google con accesso a Display e Video a 360°. La tua app sarà autorizzata per accedere ai dati per conto dell'account con cui è stato effettuato l'accesso.
// 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 dei client secret e genera le credenziali di autorizzazione.
La prima volta che esegui questo passaggio ti viene chiesto di accettare un'autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google con accesso a Display e Video a 360°. La tua app sarà autorizzata per accedere ai dati per conto dell'account con cui è stato effettuato l'accesso.
# 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 il PHP con un server web integrato
aver configurato le tue credenziali in modo che reindirizzino alla pagina web pertinente. Per
Ad esempio, questo codice in un file index.php può essere eseguito utilizzando:
il comando e le credenziali configurati per il reindirizzamento a http://localhost:8000 dopo
autenticazione:
php -S localhost:8000 -t ./Scarica e installa il client PHP dell'API di Google.
Il metodo preferito è tramite Composer:
composer require google/apiclient:^2.12.1Una volta installato, assicurati di includere il caricatore automatico
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 un'autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google con accesso a Display e Video a 360°. La tua app sarà autorizzata per accedere ai dati per conto dell'account con cui è stato effettuato l'accesso.
// 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);
Costruire un client per Display & Servizio API Video 360.
$service = new Google_Service_DoubleClickBidManager($client);