Bei der Arbeit mit der Google Ads API werden E-Mail-Adressen an mehreren Stellen für die Kontakt- und Zugriffsverwaltung verwendet. Die wichtigsten sind die folgenden:
- E-Mail-Adresse für Google Ads API-Kontakt: Das ist die E-Mail-Adresse, die im API Center der Google Ads-Benutzeroberfläche als Kontakt aufgeführt ist.
- E-Mail-Adresse des Google Cloud Console-Kontos: Dies ist die E-Mail-Adresse, die Administratorzugriff auf das Google Cloud Console-Konto hat, das für Ihre OAuth 2.0-Anwendung verwendet wird.
- E-Mail-Adressen für Google Ads-Verwaltungskonten: Dies sind die E-Mail-Adressen, die Administratorberechtigungen für die Google Ads-Verwaltungskonten haben, auf die Sie über die Google Ads API zugreifen. Wenn Sie ein Aktualisierungstoken für Ihre Anwendung generieren, authentifizieren Sie Ihre Google Ads API-Anwendung in der Regel mit einer dieser E-Mail-Adressen.
Wir empfehlen dringend, Aliasse für gemeinsame Teams zu verwenden, damit Sie den Zugriff auf diese Konten nicht verlieren, wenn einzelne Teammitglieder das Team wechseln oder das Unternehmen verlassen. Im Rest dieser Anleitung wird auf jede der oben aufgeführten E-Mails eingegangen und es wird erläutert, wie Sie sie so aktualisieren können, dass anstelle der E-Mail-Adresse eines einzelnen Nutzers ein gemeinsamer Teamalias verwendet wird.
E-Mail-Adresse für Google Ads API-Kontakt
Die Kontakt-E-Mail-Adresse für die Google Ads API ist eine E-Mail-Adresse, die Sie bei der Registrierung für die Google Ads API angeben. Sie sollten sicherstellen, dass Sie Zugriff auf diesen Alias haben, und regelmäßig die an diese Adresse gesendeten E‑Mails prüfen. Google verwendet diese E-Mail-Adresse, um Ihr Team bei API-Überprüfungen, Prüfanfragen oder Produktionsnotfällen zu kontaktieren, die sofortige Aufmerksamkeit erfordern. Verwenden Sie einen gemeinsamen Teamalias als Kontakt-E-Mail-Adresse, damit das gesamte Team diese Benachrichtigungen erhält.
So aktualisieren Sie die Kontakt-E-Mail-Adresse für die API:
Klicken Sie links unten auf Verwaltung.
Klicken Sie unter Einstellungen des Verwaltungskontos auf API-Center.
Notieren Sie sich unter Entwicklerdetails die E-Mail-Adresse für API-Kontakte. Klicken Sie auf den Abwärtspfeil und bearbeiten Sie die E‑Mail-Adresse. Klicken Sie auf Speichern.
Google Cloud Console-Konto
Das Google API Console-Projekt enthält die OAuth-Anmeldedaten Ihrer Anwendung und steuert den Zugriff auf die Google Ads API. Sorgen Sie dafür, dass Sie auf dieses Konto zugreifen können, indem Sie ein gemeinsames Alias zum Kontoinhaber machen.
So aktualisieren Sie den Inhaber des Google API Console-Projekts:
- Melden Sie sich in der Google API Console an.
- Wählen Sie Ihr Projekt oben links auf der Seite im Drop-down-Menü aus.
- Rufen Sie im Menü links IAM und Verwaltung > IAM auf.
- Klicken Sie auf die Schaltfläche Zugriff gewähren.
- Geben Sie die gemeinsame E-Mail-Adresse im Bereich Hauptkonten hinzufügen ein.
- Weisen Sie die Rolle Inhaber zu.
- Klicken Sie auf Speichern. Weitere Informationen zum Erteilen und Widerrufen des Zugriffs finden Sie in der Cloud-Dokumentation.
Google Ads-Verwaltungskonto
Eine gängige Methode zum Verwalten von Konten mit der Google Ads API besteht darin, alle Konten mit einem gemeinsamen Verwaltungskonto zu verknüpfen und API-Aufrufe für alle Konten mit den Anmeldedaten des obersten Verwaltungskontos auszuführen. In dieser Konfiguration:
- Der Entwickler stellt ein Aktualisierungstoken mit den Anmeldedaten eines Nutzers aus, der Zugriff auf das Google Ads-Verwaltungskonto hat.
- Der Entwickler legt den
login_customer_id-Header als Kunden-ID des Google Ads-Verwaltungskontos und dencustomer_id-Header als Kunden-ID des Kontos fest, an das API-Aufrufe gesendet werden.
Ein potenzielles Risiko dieser Einrichtung besteht darin, dass alle API-Aufrufe fehlschlagen, wenn der autorisierte Nutzer den Zugriff auf das Google Ads-Verwaltungskonto verliert, da das Aktualisierungstoken dann nicht mehr gültig ist. Um dies zu vermeiden, können Sie einen gemeinsamen E-Mail-Alias einladen, dieses Google Ads-Verwaltungskonto mit den entsprechenden Zugriffsebenen zu verwalten. Verwenden Sie diesen gemeinsamen E‑Mail-Alias, um das Aktualisierungstoken für API-Aufrufe auszugeben.