Utilizza l'API Google Ad Manager (beta) per leggere i dati di Ad Manager ed eseguire report.
Per effettuare la prima richiesta API, completa i seguenti passaggi:
Ottenere l'accesso a una rete Ad Manager
Se non ne hai già uno, registrati per creare un account Ad Manager.
Abilita l'API Ad Manager
Attiva l'API Ad Manager nel tuo progetto della console API di Google.
Autentica
Tutte le richieste API devono essere autenticate utilizzando OAuth2.
Le librerie client dell'API Ad Manager leggono le credenziali dalle Credenziali predefinite dell'applicazione. Puoi impostarli utilizzando le variabili di ambiente o gcloud.
Service account
Linux o macOS
export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Windows
set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Credenziali utente
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
Per saperne di più sulla scelta dei tipi di credenziali e sulla creazione delle credenziali, consulta la guida all'autenticazione.
Configurare la libreria client
Java
Per Maven:
<!-- pom.xml -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>ad-manager</artifactId>
<version>0.1.0</version>
</dependency>
Per Gradle:
implementation 'com.google.api-ads:ad-manager:0.1.0'
Python
Installa la libreria client da PyPi.
pip install google-ads-admanager
.NET
Installa la libreria client da NuGet.
Dalla CLI di .NET:
dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01
Come riferimento del pacchetto:
<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />
PHP
Installa la libreria client da Composer.
composer require googleads/ad-manager
Ruby
Installa la libreria client da RubyGems.
Gemfile:
gem 'google-ads-ad_manager', '~> 0.2.0'
Installa:
gem install google-ads-ad_manager
Node.js
Installa la libreria client da npm.
Dalla riga di comando:
npm install @google-ads/admanager
Come riferimento del pacchetto:
// package.json
"dependencies": {
"@google-ads/admanager": "^0.1.0"
}
Effettuare la prima richiesta
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);
}
}
}
Altri esempi sono disponibili su GitHub. Per ulteriori informazioni sulla libreria client, consulta la guida 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)
Altri esempi sono disponibili su GitHub. Per ulteriori informazioni sulla libreria client, consulta la guida di 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);
}
}
Altri esempi sono disponibili su GitHub. Per ulteriori informazioni sulla libreria client, consulta la guida.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);
}
Altri esempi sono disponibili su 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
Altri esempi sono disponibili su 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();
Altri esempi sono disponibili su GitHub.
cURL
curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://admanager.googleapis.com/v1/networks/NETWORK_CODE