In diesem Leitfaden wird eine Clientbibliothek verwendet, um Google Ads-Kampagnen abzurufen.
Um den API-Zugriff zu aktivieren, müssen Sie zuerst die erforderlichen OAuth2-Anmeldedaten abrufen.
Fügen Sie dann die Autorisierungs- und Kontodetails in eine Konfigurationsdatei ein. 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 das Entwicklertoken kann die Anwendung auf die API zugreifen. Das Token ist jedoch nicht auf ein Google Ads-Konto beschränkt. Sobald Ihr Token freigegeben ist, können Sie es für Anfragen an alle Ihre 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 werden durch OAuth-Anmeldedaten aus dem Verwaltungskonto 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. Ausstehende Tokens können nur mit Testkonten verbunden werden.
Sie können das Entwickler-Token abrufen, indem Sie sich in Ihrem Verwaltungskonto anmelden und dann das API-Center aufrufen (TOOLS & SETTINGS > SETUP > 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 Entwicklertoken genehmigt wurde, können Sie anstelle eines Testkontos eine Client-Kundennummer aus einem Produktionskonto verwenden.
- OAuth2-Client-ID und -Clientschlüssel
Mit der OAuth2-Client-ID und dem Clientschlüssel wird Ihre Clientanwendung einem Projekt in der Google API Console zugeordnet und für die OAuth2-Authentifizierung verwendet. Dadurch kann Ihre Anwendung im Namen Ihres Kontos ausgeführt werden. Damit wird Ihre App für Google identifiziert und Sie können OAuth-Tokens für die Verwaltung von Google Ads-Nutzern generieren. Weitere Informationen findest du 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 übernommen. Versuchen Sie andernfalls, Tokens über den OAuth-Playground abzurufen.
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.