Workflow für Dienstkonten

In diesem Leitfaden wird beschrieben, wie Sie mit Dienstkonten auf die Google Ads API zugreifen.

Ein Dienstkonto ist ein Konto, das zu Ihrer App und nicht zu einem einzelnen Endnutzer gehört. Für Dienstkonten wird ein OAuth 2.0-Vorgang verwendet, für den keine Autorisierung durch eine Person erforderlich ist. Stattdessen wird eine Schlüsseldatei verwendet, auf die nur Ihre App zugreifen kann.

Dienstkonten haben zwei wesentliche Vorteile:

• Die Autorisierung für den Google Ads API-Zugriff auf Google Ads-Konten erfolgt als Konfigurationsschritt über die Autorisierungs- und Kontoverwaltungsfunktionen der Google Ads-Benutzeroberfläche. So sparen Entwickler Zeit, da sie keine OAuth 2.0-Vorgänge erstellen und sich nicht mit Komplikationen befassen müssen, die Nutzerinteraktionen, das Speichern von Nutzeranmeldedaten und die Tokenverwaltung betreffen.

• Die Autorisierung für den Zugriff auf Google Ads-Konten ist nicht an die Anmeldedaten einzelner Nutzer gebunden. Das kann nützlich sein, wenn die Autorisierung auch dann fortgesetzt werden soll, wenn der Mitarbeiter, der den Zugriff ursprünglich autorisiert hat, das Team oder das Unternehmen verlässt.

Kontozugriff einrichten

1. Erstellen Sie zuerst ein Dienstkonto und Anmeldedaten.

   Laden Sie den Dienstkontoschlüssel im JSON-Format herunter und notieren Sie sich die Dienstkonto-ID und die E-Mail-Adresse.

2. Melden Sie sich als Administrator in Ihrem Google Ads-Konto an. Rufen Sie Verwaltung > Zugriff und Sicherheit auf.

3. Klicken Sie auf dem Tab Nutzer auf den Button +.

4. Geben Sie die E‑Mail-Adresse des Dienstkontos in das Eingabefeld E‑Mail ein. Wählen Sie die entsprechende Zugriffsebene für das Konto aus (Dienstkonten unterstützen nicht die Zugriffsebene Nur E-Mail) und klicken Sie auf die Schaltfläche Konto hinzufügen.

5. Dem Dienstkonto wird Zugriff gewährt.

6. Optional:Standardmäßig können Sie einem Dienstkonto keinen Administratorzugriff gewähren. Halten Sie sich an das Prinzip der geringsten Berechtigung und gewähren Sie Administratorzugriff nur, wenn Ihre API-Aufrufe dies erfordern. So können Sie den Zugriff upgraden:

   • Klicken Sie in der Spalte Zugriffsebene auf den Drop-down-Pfeil neben der Zugriffsebene des Dienstkontos.
   • Wählen Sie in der Drop-down-Liste Administrator aus.

Clientbibliotheken konfigurieren

Wählen Sie den Tab für Ihre Programmiersprache aus, um eine Anleitung zum Konfigurieren der Clientbibliothek zu erhalten. Wenn Ihr Dienstkonto über ein Google Ads-Verwaltungskonto auf Kundenkonten zugreift, legen Sie login-customer-id (oder loginCustomerId) auf die 10-stellige Kundennummer dieses Verwaltungskontos ohne Bindestriche fest (siehe Kundennummer für die Anmeldung).

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "JSON_KEY_FILE_PATH",
    // ...
};
GoogleAdsClient client = new GoogleAdsClient(config);

json_key_file_path: JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

[OAUTH2]
; For service account flow.
jsonKeyFilePath = "JSON_KEY_FILE_PATH"
scopes = "https://www.googleapis.com/auth/adwords"

c.keyfile = 'JSON_KEY_FILE_PATH'

jsonKeyFilePath=JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

gcloud auth login --cred-file=JSON_KEY_FILE_PATH

gcloud auth \
  print-access-token \
  --scopes='https://www.googleapis.com/auth/adwords'

curl -i -X POST \
  https://googleads.googleapis.com/v25/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}