Sie suchen nach einer REST API? Die Ad Manager API (Beta) ist jetzt verfügbar.

Diese Seite wurde von der Cloud Translation API übersetzt.

Mehr erfahren
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Sie können die Google Ad Manager API verwenden, um Apps zur Verwaltung von Inventar, um Aufträge zu erstellen, Berichte abzurufen und vieles mehr.

Für die Ad Manager API wird SOAP verwendet. Um Ihnen den Einstieg zu erleichtern, bieten wir Kundenunternehmen Bibliotheken für Java, .NET, Python, PHP und Ruby.

So senden Sie Ihre erste API-Anfrage:

Registrieren Sie sich für ein Ad Manager-Konto Konto. Sie können auch eine Testnetzwerk, wenn Sie die API in einem in einer separaten Umgebung. Für Testzwecke ist kein AdSense-Konto erforderlich. zu verstehen.

Notieren Sie sich Ihren Netzwerkcode. Sie finden sie in der URL, wenn Sie sich anmelden mit Ihrem Netzwerk verbunden sind. In der URL https://admanager.google.com/1234#home, 1234 ist Ihr Netzwerkcode.

Anmeldedaten für die Authentifizierung erstellen

Alle Ad Manager API-Anfragen müssen mit OAuth 2.0 authentifiziert werden. Die Schritte wie Sie auf Ihre eigenen Ad Manager-Daten zugreifen können. Weitere Informationen und weitere Optionen finden Sie unter Authentifizierung.

Öffnen Sie die Google API Console. Seite „Anmeldedaten“
Wählen Sie im Projektmenü die Option Projekt erstellen aus und geben Sie einen Namen Projekt und bearbeiten Sie optional die angegebene Projekt-ID. Klicken Sie auf Erstellen.
Wählen Sie auf der Seite „Anmeldedaten“ die Option Anmeldedaten erstellen und dann Dienstkontoschlüssel:
Wählen Sie Neuer Dienst aus. Konto und wählen Sie JSON als Schlüsseltyp aus.
Klicken Sie auf Erstellen, um eine Datei mit einem privaten Schlüssel herunterzuladen.

Ad Manager-Netzwerk konfigurieren

Melden Sie sich in Google Ads an. Administrator.
Klicken Sie in der Seitenleiste auf Verwaltung > Globale Einstellungen:
Unter Allgemeine Einstellungen > API-Zugriff stellen Sie den Schieberegler auf Aktiviert.
Klicken Sie unten auf der Seite auf Speichern.

Client einrichten

Laden Sie eine der Ad Manager-Clientbibliotheken herunter. Die Bibliotheken bieten Wrapper-Funktionen und -Funktionen, die das Apps zu entwickeln.

Auf den Tabs unten finden Sie Kurzanleitungen für das Programmieren in den Sprachen, für die gibt es eine Clientbibliothek.

Java

Hier ist ein einfaches Beispiel, das zeigt, wie Sie den Java-Client Bibliothek. Detailliertere Informationen zur Nutzung finden Sie unter die README in der Distribution der Clientbibliothek enthalten.

Anmeldedaten einrichten

Führen Sie in einer Shell den folgenden Befehl aus:

curl https://raw.githubusercontent.com/googleads/googleads-java-lib/main/examples/admanager_axis/src/main/resources/ads.properties -o ~/ads.properties

Öffnen Sie die Datei ~/ads.properties und füllen Sie die folgenden Felder aus:

[...]
api.admanager.applicationName=INSERT_APPLICATION_NAME_HERE
api.admanager.jsonKeyFilePath=INSERT_PATH_TO_JSON_KEY_FILE_HERE
api.admanager.networkCode=INSERT_NETWORK_CODE_HERE
[...]

Abhängigkeiten angeben

Bearbeiten Sie die Datei pom.xml und fügen Sie Folgendes hinzu: dependencies-Tag. Sie finden die aktuelle Versionsnummer unter . GitHub

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>ads-lib</artifactId>
  <version>RELEASE</version>
</dependency>
<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>dfp-axis</artifactId>
  <version>RELEASE</version>
</dependency>

Schreiben Sie Code und stellen Sie eine Anfrage.

import com.google.api.ads.common.lib.auth.OfflineCredentials;
import com.google.api.ads.common.lib.auth.OfflineCredentials.Api;
import com.google.api.ads.admanager.axis.factory.AdManagerServices;
import com.google.api.ads.admanager.axis.v202408.Network;
import com.google.api.ads.admanager.axis.v202408.NetworkServiceInterface;
import com.google.api.ads.admanager.lib.client.AdManagerSession;
import com.google.api.client.auth.oauth2.Credential;

public class App {
  public static void main(String[] args) throws Exception {
    Credential oAuth2Credential = new OfflineCredentials.Builder()
        .forApi(Api.AD_MANAGER)
        .fromFile()
        .build()
        .generateCredential();

    // Construct an AdManagerSession.
    AdManagerSession session = new AdManagerSession.Builder()
        .fromFile()
        .withOAuth2Credential(oAuth2Credential)
        .build();

    // Construct a Google Ad Manager service factory, which can only be used once per
    // thread, but should be reused as much as possible.
    AdManagerServices adManagerServices = new AdManagerServices();

    // Retrieve the appropriate service
    NetworkServiceInterface networkService = adManagerServices.get(session,
        NetworkServiceInterface.class);

    // Make a request
    Network network = networkService.getCurrentNetwork();

    System.out.printf("Current network has network code '%s' and display" +
        " name '%s'.%n", network.getNetworkCode(), network.getDisplayName());
  }
}

Auf GitHub ansehen

Python

Hier ist ein einfaches Beispiel, das zeigt, wie die Python-Clientbibliothek verwendet wird. Die Python-Clientbibliothek unterstützt Python ab Version 3.6. Detailliertere Informationen zur Verwendung finden Sie in der README in der Distribution der Clientbibliothek enthalten.

Installieren Sie die Bibliothek und richten Sie Ihre Anmeldedaten ein.

Führen Sie in einer Shell die folgenden Befehle aus:

pip install googleads
curl https://raw.githubusercontent.com/googleads/googleads-python-lib/main/googleads.yaml \
     -o ~/googleads.yaml

Richten Sie die Datei ~/googleads.yaml ein.

Füllen Sie die folgenden Felder aus:

ad_manager:
  application_name: INSERT_APPLICATION_NAME_HERE
  network_code: INSERT_NETWORK_CODE_HERE
  path_to_private_key_file: INSERT_PATH_TO_FILE_HERE

Führen Sie Code aus und stellen Sie eine Anfrage.

# Import the library.
from googleads import ad_manager

# Initialize a client object, by default uses the credentials in ~/googleads.yaml.
client = ad_manager.AdManagerClient.LoadFromStorage()

# Initialize a service.
network_service = client.GetService('NetworkService', version='v202408')

# Make a request.
current_network = network_service.getCurrentNetwork()

print("Current network has network code '%s' and display name '%s'." %
        (current_network['networkCode'], current_network['displayName']))

Auf GitHub ansehen

PHP

Hier ist ein einfaches Beispiel, das zeigt, wie Sie den PHP-Clientbibliothek verwenden.

Installieren Sie die Bibliothek und richten Sie Ihre Anmeldedaten ein.
Führen Sie die folgenden Befehle in einer Shell aus, um die Clientbibliothek zu installieren und die adsapi_php.ini -Datei in Ihr Basisverzeichnis:
```
composer require googleads/googleads-php-lib
curl https://raw.githubusercontent.com/googleads/googleads-php-lib/main/examples/AdManager/adsapi_php.ini -o ~/adsapi_php.ini
```

Richten Sie die Datei ~/adsapi_php.ini ein.

Füllen Sie die folgenden Felder aus:

[AD_MANAGER]
networkCode = "INSERT_NETWORK_CODE_HERE"
applicationName = "INSERT_APPLICATION_NAME_HERE"

[OAUTH2]
jsonKeyFilePath = "INSERT_ABSOLUTE_PATH_TO_OAUTH2_JSON_KEY_FILE_HERE"
scopes = "https://www.googleapis.com/auth/dfp"

Führen Sie Code aus und stellen Sie eine Anfrage. <ph type="x-smartling-placeholder">

</ph> Dieser Beispielcode muss über die Befehlszeile und nicht in einem Browser ausgeführt werden. Die Datei mit diesem Code muss sich im Stammverzeichnis des Projektverzeichnisses befinden. wobei composer require ausgeführt wurde.

<?php
require 'vendor/autoload.php';
use Google\AdsApi\AdManager\AdManagerSession;
use Google\AdsApi\AdManager\AdManagerSessionBuilder;
use Google\AdsApi\AdManager\v202408\ApiException;
use Google\AdsApi\AdManager\v202408\ServiceFactory;
use Google\AdsApi\Common\OAuth2TokenBuilder;

// Generate a refreshable OAuth2 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();
// Construct an API session configured from a properties file and the OAuth2
// credentials above.
$session = (new AdManagerSessionBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->build();

// Get a service.
$serviceFactory = new ServiceFactory();
$networkService = $serviceFactory->createNetworkService($session);

// Make a request
$network = $networkService->getCurrentNetwork();
printf(
    "Network with code %d and display name '%s' was found.\n",
    $network->getNetworkCode(),
    $network->getDisplayName()
);

Auf GitHub ansehen

.NET

Hier ist ein einfaches Beispiel, das zeigt, wie Sie den .NET-Client verwenden: Mediathek

Neues Projekt erstellen
Öffnen Sie Visual Studio und erstellen Sie ein neues Projekt (Console-Anwendung).
Ihrem Projekt die erforderlichen Bibliotheksverweise hinzufügen
Fügen Sie eine Nuget-Abhängigkeit für Google.Dfp hinzu.
App.config einrichten
Kopieren Sie src\App.config in Ihr Projektverzeichnis und fügen Sie die Datei Ihrem Projekt hinzu. Wenn Ihre Anwendung eine eigene App.config hat, können Sie die folgenden Knoten in Ihre App.config kopieren:
- configuration/AdManagerApi
- configuration/configSections/section[name="AdManagerApi"]
- configuration/system.net

Anmeldedaten einrichten

Öffnen Sie App.config und bearbeiten Sie die folgenden Schlüssel:

<add key="ApplicationName" value="INSERT_YOUR_APPLICATION_NAME_HERE" />
<add key="NetworkCode" value="INSERT_YOUR_NETWORK_CODE_HERE" />
<add key="OAuth2Mode" value="SERVICE_ACCOUNT" />
<add key="OAuth2SecretsJsonPath" value="INSERT_OAUTH2_SECRETS_JSON_FILE_PATH_HERE" />

Bibliothek anrufen

Sie können die Bibliothek wie im folgenden C#-Code-Snippet gezeigt aufrufen.

Auf GitHub ansehen

AdManagerUser user = new AdManagerUser();
      using (InventoryService inventoryService = user.GetService<InventoryService>())
            {
                // Create a statement to select ad units.
                int pageSize = StatementBuilder.SUGGESTED_PAGE_LIMIT;
                StatementBuilder statementBuilder =
                    new StatementBuilder().OrderBy("id ASC").Limit(pageSize);

                // Retrieve a small amount of ad units at a time, paging through until all
                // ad units have been retrieved.
                int totalResultSetSize = 0;
                do
                {
                    AdUnitPage page =
                        inventoryService.getAdUnitsByStatement(statementBuilder.ToStatement());

                    // Print out some information for each ad unit.
                    if (page.results != null)
                    {
                        totalResultSetSize = page.totalResultSetSize;
                        int i = page.startIndex;
                        foreach (AdUnit adUnit in page.results)
                        {
                            Console.WriteLine(
                                "{0}) Ad unit with ID \"{1}\" and name \"{2}\" was found.", i++,
                                adUnit.id, adUnit.name);
                        }
                    }

                    statementBuilder.IncreaseOffsetBy(pageSize);
                } while (statementBuilder.GetOffset() < totalResultSetSize);

                Console.WriteLine("Number of results found: {0}", totalResultSetSize);
            }

Wenn Sie Ihre Anmeldedaten nicht in Ihrer App.config festlegen möchten, verweisen Sie auf zu diesem Wiki-Artikel . Weitere Informationen zur Verwendung der .NET-Clientbibliothek finden Sie unter in der README-Datei Wenn Sie in .NET ohne die Clientbibliothek entwickeln möchten, finden Sie weitere Informationen in der NoClientLibrary Wiki-Artikel

Ruby

Hier ist ein einfaches Beispiel, das zeigt, wie die Ruby- Clientbibliothek. Für die Ruby-Clientbibliothek ist Ruby 2.1 oder höher erforderlich.

Installieren Sie das Ruby-Gem und rufen Sie die Konfigurationsdatei ab.
Führen Sie in einer Shell die folgenden Befehle aus:
```
gem install google-dfp-api
curl https://raw.githubusercontent.com/googleads/google-api-ads-ruby/main/ad_manager_api/ad_manager_api.yml -o ~/ad_manager_api.yml
```
Wenn ein Fehler wie „cannot load such file -- mkmf (LoadError)“ angezeigt wird während der Installation von Edelsteinen müssen möglicherweise zusätzliche Ruby-Entwicklungsbibliotheken wie ruby-dev installieren, wie z. B. mit ruby-devel oder xcode-select.
Anmeldedaten einrichten
Füllen Sie die Pflichtfelder in der ~/ad_manager_api.yml aus -Datei. Wenn Sie noch keine OAuth2-Schlüsseldatei haben, folgen Sie den Schritte zur Erstellung Ihres OAuth2- Anmeldedaten
```
:authentication:
  :oauth2_keyfile: INSERT_PATH_TO_JSON_KEY_FILE_HERE
  :application_name: INSERT_APPLICATION_NAME_HERE
  :network_code: INSERT_NETWORK_CODE_HERE
```

Schreiben Sie Code und stellen Sie eine Anfrage.

# Import the library.
require 'ad_manager_api'

# Initialize an Ad Manager client instance (uses credentials in ~/ad_manager_api.yml by default).
ad_manager = AdManagerApi::Api.new

# Get a service instance.
network_service = ad_manager.service(:NetworkService, :v202408)

# Make a request.
network = network_service.get_current_network()

puts "The current network is %s (%d)." %
        [network[:display_name], network[:network_code]]

Auf GitHub ansehen

Eine ausführlichere Anleitung für die ersten Schritte finden Sie in der README. die mit der Ruby-Clientbibliothek verteilt wird. Weitere Informationen finden Sie in der vollständigen Beispielbibliothek für Ruby.

Nächste Schritte

Wenn eine Clientbibliothek aktiv ist, ändern Sie die bereitgestellten Beispiele an und erweitern sie an Ihre Bedürfnisse.

Weitere Informationen finden Sie in der Referenzdokumentation. mehr über die API erfahren.

Wenn Sie Hilfe benötigen, besuchen Sie unsere Supportseite.

Mehr erfahren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Zugriff auf ein Ad Manager-Netzwerk erhalten

Anmeldedaten für die Authentifizierung erstellen

Ad Manager-Netzwerk konfigurieren

Client einrichten

Java

Python

PHP

.NET

Ruby

Nächste Schritte

Mehr erfahren
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.