Mit der Google Ad Manager API (Beta) können Sie Ihre Ad Manager-Daten lesen und Berichte erstellen.
So senden Sie Ihre erste API-Anfrage:
Zugriff auf ein Ad Manager-Netzwerk erhalten
Falls noch nicht geschehen, registrieren Sie sich für ein Ad Manager-Konto.
Ad Manager API aktivieren
Aktivieren Sie die Ad Manager API in Ihrem Google API Console-Projekt.
Authentifizieren
Alle API-Anfragen müssen mit OAuth2 authentifiziert werden.
Die Ad Manager API-Clientbibliotheken lesen Anmeldedaten aus Standardanmeldedaten für Anwendungen. Sie können diese mit Umgebungsvariablen oder gcloud festlegen.
Dienstkonto
Linux oder macOS
export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Windows
set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Nutzeranmeldedaten
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
Weitere Informationen zum Auswählen von Anmeldedatentypen und zum Erstellen von Anmeldedaten finden Sie im Authentifizierungsleitfaden.
Clientbibliothek einrichten
Java
Für Maven:
<!-- pom.xml -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>ad-manager</artifactId>
<version>0.1.0</version>
</dependency>
Für Gradle:
implementation 'com.google.api-ads:ad-manager:0.1.0'
Python
Installieren Sie die Clientbibliothek über PyPI.
pip install google-ads-admanager
.NET
Installieren Sie die Clientbibliothek über NuGet.
Über die .NET-Befehlszeile:
dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01
Als Paketreferenz:
<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />
PHP
Installieren Sie die Clientbibliothek über Composer.
composer require googleads/ad-manager
Ruby
Installieren Sie die Clientbibliothek über RubyGems.
Gemfile:
gem 'google-ads-ad_manager', '~> 0.2.0'
Installieren:
gem install google-ads-ad_manager
Node.js
Installieren Sie die Clientbibliothek über npm.
Führen Sie über die Befehlszeile folgenden Befehl aus:
npm install @google-ads/admanager
Als Paketreferenz:
// package.json
"dependencies": {
"@google-ads/admanager": "^0.1.0"
}
Erste Anfrage senden
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);
}
}
}
Weitere Beispiele finden Sie auf GitHub. Weitere Informationen zu Clientbibliotheken finden Sie im Java-Leitfaden.
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)
Weitere Beispiele finden Sie auf GitHub. Weitere Informationen zu Clientbibliotheken finden Sie im Python-Leitfaden.
.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);
}
}
Weitere Beispiele finden Sie auf GitHub. Weitere Informationen zu Clientbibliotheken finden Sie im .NET-Leitfaden.
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);
}
Weitere Beispiele finden Sie auf 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
Weitere Beispiele finden Sie auf 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();
Weitere Beispiele finden Sie auf GitHub.
cURL
curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://admanager.googleapis.com/v1/networks/NETWORK_CODE