Informationen für Einsteiger

Mit der Google Ad Manager REST API können Sie Ihre Ad Manager-Daten lesen und Berichte erstellen.

Um Ihnen den Einstieg zu erleichtern, bieten wir eine Client-Bibliothek für Java mit mehr Sprachen folgen. Führen Sie die folgenden Schritte aus, um Ihre erste API-Anfrage zu senden.

Zugriff auf ein Ad Manager-Netzwerk erhalten

Falls Sie noch keines haben, sich für ein Ad Manager-Konto registrieren 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 REST API-Clientbibliotheken für Ad Manager lesen Anmeldedaten aus Standardanmeldedaten für Anwendungen. So legen Sie diese fest: mit Umgebungsvariablen oder gcloud, folgen Sie dieser Anleitung.

Dienstkonto

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/keyfile.json

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

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 aus PyPi.

pip install google-ads-admanager

Erste Anfrage stellen

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.

Python

from google.ads import admanager

client = admanager.NetworkServiceClient()

request = admanager.GetNetworkRequest(
     name="networks/NETWORK_CODE",
)

response = client.get_network(request=request)

print(response)

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