Recomendamos usar las bibliotecas cliente de la API de Google con la API de Bid Manager, por lo que no tienes que procesar manualmente las solicitudes y respuestas HTTP. La API de Google las bibliotecas cliente pueden proporcionar una mejor integración de lenguajes, una mayor seguridad y para realizar llamadas que requieran la autorización del usuario.
La API de Bid Manager se basa en HTTP y JSON. Si prefieres procesar las solicitudes y las respuestas, puedes usar cualquier cliente HTTP estándar.
Instala una biblioteca cliente
Ofrecemos bibliotecas cliente que admiten la API de Bid Manager en una variedad de lenguajes de programación. Para obtener una lista completa de las bibliotecas cliente, consulta la documentación de Muestra y la pestaña Bibliotecas.
Las guías para desarrolladores de la API de Bid Manager proporcionan fragmentos de código para las siguientes tres funciones: idiomas:
Para ver ejemplos de integración completa en estos idiomas, consulte nuestros ejemplos de la API de Bid Manager. Repositorio de GitHub.
Configura tu cliente
Con credenciales de OAuth 2.0 y un cliente instalado de Google Cloud, ya puedes usar la API de Bid Manager. Aquí te indicamos cómo autorizar y configurar tu cliente:
Java
Importa las bibliotecas necesarias.
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;
Carga el archivo de secretos del cliente y genera credenciales de autorización.
La primera vez que realices este paso, se te pedirá que aceptes una autorización en el navegador. Antes de aceptar, asegúrate de acceder con una Cuenta de Google con acceso a Display & Video en 360° Se autorizará tu app para acceder a los datos en nombre de cualquier cuenta con la que se haya accedido.
// 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 cliente de API autorizado.
// Create authorized API client. DoubleClickBidManager service = new DoubleClickBidManager.Builder(credential.getTransport(), credential.getJsonFactory(), credential) .setApplicationName("bidmanager-java-installed-app-sample") .build();
Python
Importa las bibliotecas necesarias.
from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient import discovery
Carga el archivo de secretos del cliente y genera credenciales de autorización.
La primera vez que realices este paso, se te pedirá que aceptes una autorización en el navegador. Antes de aceptar, asegúrate de acceder con una Cuenta de Google con acceso a Display & Video en 360° Se autorizará tu app para acceder a los datos en nombre de cualquier cuenta con la que se haya accedido.
# 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 cliente de API autorizado.
# 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
En este ejemplo, se supone que ejecutas PHP con un servidor web integrado y
Configuraste tus credenciales para redireccionar a los usuarios a la página web correspondiente. Para
Por ejemplo, este código, en un archivo index.php, se puede ejecutar con el siguiente comando:
comando y credenciales configurados para redireccionar a http://localhost:8000 después
autenticación:
php -S localhost:8000 -t ./Descarga e instala el cliente PHP de la API de Google.
El método preferido es a través de Composer:
composer require google/apiclient:^2.12.1Una vez instalado, asegúrate de incluir el cargador automático
require_once '/path/to/your-project/vendor/autoload.php';Crea un objeto Google_Client.
$client = new Google_Client();Configurar el cliente, redireccionar a la URL de autenticación si es necesario y recuperar un token de acceso
La primera vez que realices este paso, se te pedirá que aceptes una autorización en el navegador. Antes de aceptar, asegúrate de acceder con una Cuenta de Google que tiene acceso a Display & Video en 360° Se autorizará tu app para acceder a los datos en nombre de cualquier cuenta con la que se haya accedido.
// 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);
Cree un cliente para la campaña de Display y Servicio de la API de Video 360.
$service = new Google_Service_DoubleClickBidManager($client);