Utiliza la API de Google Ad Manager (beta) para leer tus datos de Ad Manager y ejecutar informes.
Para realizar tu primera solicitud a la API, completa los siguientes pasos:
Cómo obtener acceso a una red de Ad Manager
Si aún no tienes una, regístrate para obtener una cuenta de Ad Manager.
Habilita la API de Ad Manager
Habilita la API de Ad Manager en tu proyecto de la Consola de APIs de Google.
Autenticar
Todas las solicitudes a la API deben autenticarse con OAuth2.
Las bibliotecas cliente de la API de Ad Manager leen credenciales de las credenciales predeterminadas de la aplicación. Puedes establecerlos con variables de entorno o gcloud.
Cuenta de servicio
Linux o macOS
export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Windows
set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Credenciales de usuario
gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
# End user credentials must specify the cloud project where the API is enabled.
gcloud auth application-default set-quota-project PROJECT_ID
Para obtener más información sobre cómo elegir y crear tipos de credenciales, consulta la guía de autenticación.
Configura tu biblioteca cliente
Java
Para Maven:
<!-- pom.xml -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>ad-manager</artifactId>
<version>0.1.0</version>
</dependency>
Para Gradle:
implementation 'com.google.api-ads:ad-manager:0.1.0'
Python
Instala la biblioteca cliente desde PyPi.
pip install google-ads-admanager
.NET
Instala la biblioteca cliente desde NuGet.
Desde la CLI de .NET:
dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01
Como referencia del paquete:
<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />
PHP
Instala la biblioteca cliente desde Composer.
composer require googleads/ad-manager
Ruby
Instala la biblioteca cliente desde RubyGems.
Gemfile:
gem 'google-ads-ad_manager', '~> 0.2.0'
Instala:
gem install google-ads-ad_manager
Node.js
Instala la biblioteca cliente desde npm.
Desde la línea de comandos:
npm install @google-ads/admanager
Como referencia del paquete:
// package.json
"dependencies": {
"@google-ads/admanager": "^0.1.0"
}
Realiza tu primera solicitud
Java
import com.google.ads.admanager.v1.GetNetworkRequest;
import com.google.ads.admanager.v1.Network;
import com.google.ads.admanager.v1.NetworkName;
import com.google.ads.admanager.v1.NetworkServiceClient;
public class SyncGetNetwork {
public static void main(String[] args) throws Exception {
syncGetNetwork();
}
public static void syncGetNetwork() throws Exception {
try (NetworkServiceClient networkServiceClient = NetworkServiceClient.create()) {
GetNetworkRequest request =
GetNetworkRequest.newBuilder()
.setName(NetworkName.of("NETWORK_CODE").toString())
.build();
Network response = networkServiceClient.getNetwork(request);
}
}
}
Puedes encontrar más ejemplos en GitHub. Para obtener más información sobre las bibliotecas cliente, consulta la guía de Java.
Python
from google.ads import admanager_v1
def sample_get_network():
# Create a client
client = admanager_v1.NetworkServiceClient()
# Initialize request argument(s)
request = admanager_v1.GetNetworkRequest(
name="networks/NETWORK_CODE",
)
# Make the request
response = client.get_network(request=request)
# Handle the response
print(response)
Puedes encontrar más ejemplos en GitHub. Para obtener más información sobre la biblioteca cliente, consulta la guía de Python.
.NET
using Google.Ads.AdManager.V1;
public sealed partial class GeneratedNetworkServiceClientSnippets
{
public void GetNetwork()
{
// Create client
NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
// Initialize request argument(s)
string name = "networks/NETWORK_CODE";
// Make the request
Network response = networkServiceClient.GetNetwork(name);
}
}
Puedes encontrar más ejemplos en GitHub. Para obtener más información sobre las bibliotecas cliente, consulta la guía de.NET.
PHP
<?php
use Google\Ads\AdManager\V1\Client\NetworkServiceClient;
use Google\Ads\AdManager\V1\GetNetworkRequest;
use Google\Ads\AdManager\V1\Network;
use Google\ApiCore\ApiException;
/**
* API to retrieve a Network object.
*
* @param string $formattedName Resource name of Network.
* Format: networks/{network_code}
* Please see {@see NetworkServiceClient::networkName()} for help formatting this field.
*/
function get_network_sample(string $formattedName): void
{
// Create a client.
$networkServiceClient = new NetworkServiceClient();
// Prepare the request message.
$request = (new GetNetworkRequest())
->setName($formattedName);
// Call the API and handle any network failures.
try {
/** @var Network $response */
$response = $networkServiceClient->getNetwork($request);
printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
} catch (ApiException $ex) {
printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
}
}
/**
* Helper to execute the sample.
*
*/
function callSample(): void
{
$formattedName = NetworkServiceClient::networkName('NETWORK_CODE');
get_network_sample($formattedName);
}
Puedes encontrar más ejemplos en GitHub.
Ruby
require "google/ads/ad_manager/v1"
def get_network
# Create a client object. The client can be reused for multiple calls.
client = Google::Ads::AdManager::V1::NetworkService::Rest::Client.new
# Create a request. To set request fields, pass in keyword arguments.
request = Google::Ads::AdManager::V1::GetNetworkRequest.new(:name => 'networks/NETWORK_CODE)'
# Call the get_network method.
result = client.get_network request
# The returned object is of type Google::Ads::AdManager::V1::Network.
p result
end
Puedes encontrar más ejemplos en GitHub.
Node.js
// Resource name of the Network
const name = 'networks/NETWORK_CODE'
// Imports the Admanager library
const {NetworkServiceClient} = require('@google-ads/admanager').v1;
// Instantiates a client
const admanagerClient = new NetworkServiceClient();
async function callGetNetwork() {
// Construct request
const request = {
name,
};
// Run request
const response = await admanagerClient.getNetwork(request);
console.log(response);
}
callGetNetwork();
Puedes encontrar más ejemplos en GitHub.
cURL
curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://admanager.googleapis.com/v1/networks/NETWORK_CODE