Utilizza l'API Google Ad Manager (beta) per leggere i dati di Ad Manager ed eseguire report.
Per effettuare la tua prima richiesta API, completa i seguenti passaggi:
Accedere 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 progetto della console API di Google.
Autentica
Tutte le richieste all'API devono essere autenticate utilizzando OAuth 2.
Le librerie client dell'API Ad Manager leggono le credenziali dalle Credenziali predefinite dell'applicazione. Puoi impostarle utilizzando le variabili di ambiente o gcloud.
Account di servizio
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 ulteriori informazioni sulla scelta e sulla creazione dei tipi di 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.
Dall'interfaccia a riga di comando .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"
}
Effettua la tua 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);
}
}
}
Puoi trovare altri esempi su GitHub. Per ulteriori informazioni sulle librerie 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)
Puoi trovare altri esempi su GitHub. Per ulteriori informazioni sulle librerie 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);
}
}
Puoi trovare altri esempi su GitHub. Per ulteriori informazioni sulle librerie 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);
}
Puoi trovare altri esempi 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
Puoi trovare altri esempi 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();
Puoi trovare altri esempi su GitHub.
cURL
curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://admanager.googleapis.com/v1/networks/NETWORK_CODE