In diesem Leitfaden wird eine Clientbibliothek zum Abrufen von Google Ads-Kampagnen verwendet.
Um den API-Zugriff zu aktivieren, müssen Sie zuerst die erforderlichen OAuth2-Anmeldedaten abrufen.
Fügen Sie dann die Autorisierungs- und Kontodetails einer Konfigurationsdatei hinzu. Sobald die Konfigurationsdatei eingerichtet ist, können Sie die API aufrufen.
Konfigurationsparameter für die Clientbibliothek
Geben Sie die folgenden Informationen in der Konfigurationsdatei Ihrer Clientbibliothek an.
- Entwicklertoken
Über Ihr Entwickler-Token kann Ihre Anwendung auf die API zugreifen, aber das Token ist nicht auf ein Google Ads-Konto beschränkt. Sobald Ihr Token genehmigt ist, können Sie es für Anfragen bei allen Ihren Google Ads-Konten verwenden, auch wenn diese nicht mit dem Google Ads-Verwaltungskonto verknüpft sind, das mit dem Token verknüpft ist.
Die von Ihnen verwalteten Konten sind durch OAuth-Anmeldedaten des Verwaltungskontos autorisiert. Ein Verwaltungskonto erfordert nur einen Satz Anmeldedaten, um alle Unterkonten zu verwalten.
Genehmigte Tokens können bei Google Ads-Produktionskonten mit der API verbunden werden, noch nicht genehmigte Tokens hingegen nur mit Testkonten.
Sie können das Entwicklertoken abrufen, indem Sie sich in Ihrem Verwaltungskonto anmelden und dann das API-Center aufrufen (TOOLS UND EINSTELLUNGEN > EINRICHTUNG > API-Center).
- Client-Kundennummer
Die Client-Kundennummer ist die Kontonummer des Google Ads-Kundenkontos, das Sie mit der API verwalten möchten. Sie hat normalerweise das Format
123-456-7890
.Optional kann die Client-Kundennummer in der Konfigurationsdatei weggelassen und programmatisch festgelegt werden. Sobald Ihr Entwickler-Token genehmigt ist, können Sie eine Client-Kundennummer aus einem Produktionskonto anstelle eines Testkontos verwenden.
- OAuth2-Client-ID und -Clientschlüssel
Die OAuth2-Client-ID und der Clientschlüssel ordnen Ihre Clientanwendung einem Projekt in der Google API Console zu und werden für die OAuth2-Authentifizierung verwendet. Dadurch kann Ihre Anwendung im Namen Ihres Kontos ausgeführt werden. Er identifiziert Google Ihre App und Sie können OAuth-Tokens für die Verwaltung von Google Ads-Nutzern generieren. Weitere Informationen finden Sie unter Client-ID und Clientschlüssel erstellen.
- OAuth2-Zugriffs- und -Aktualisierungstoken
Bevor über die API auf private Daten zugegriffen werden kann, muss ein OAuth2-Zugriffstoken abgerufen werden, um Zugriff auf die API zu erhalten.
Wenn Sie die Clientbibliotheken verwenden, wird das OAuth2-Zugriffstoken automatisch für Sie übernommen. Andernfalls können Sie Tokens über OAuth Playground abrufen.
OAuth2-Zugriffstokens verfallen nach einer bestimmten Zeit. Aus diesem Grund verwenden die Clientbibliotheken das OAuth2-Aktualisierungstoken, um das OAuth2-Zugriffstoken automatisch neu zu generieren. Unter Zugriffs- und Aktualisierungstoken finden Sie eine Anleitung zum Erstellen des Aktualisierungstokens.