Informationen für Einsteiger

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 Clientbibliotheken der Ad Manager API lesen Anmeldedaten aus Standardanmeldedaten für Anwendungen. Sie können sie mithilfe von 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 zur Auswahl von Anmeldedatentypen und zum Erstellen von Anmeldedaten finden Sie in der Authentifizierungsanleitung.

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'

Installation:

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