Wenn Sie mit der Google Ads API arbeiten, werden E-Mail-Adressen an mehreren Stellen für die Kontakt- und Zugriffsverwaltung verwendet. Die wichtigsten sind:
- Kontakt-E-Mail-Adresse für die Google Ads API: Diese E-Mail-Adresse ist im API-Center der Google Ads-Benutzeroberfläche angegeben.
- E-Mail-Adresse des Google Cloud Console-Kontos: Dies ist die E-Mail-Adresse mit Administratorzugriff auf das Google Cloud Console-Konto, das für Ihre OAuth 2.0-Anwendung verwendet wird.
- E-Mail-Adressen des Google Ads-Verwaltungskontos: Dies sind die E-Mail-Adressen mit Administratorberechtigungen für die Google Ads-Verwaltungskonten, 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 normalerweise mit einer dieser E-Mail-Adressen.
Wir empfehlen dringend, gemeinsame Teamaliasse zu verwenden, damit Sie nicht den Zugriff auf diese Konten verlieren, wenn einzelne Teammitglieder die Teams wechseln oder das Unternehmen verlassen. Im weiteren Verlauf dieses Leitfadens werden alle oben aufgeführten E-Mail-Adressen näher erläutert. Außerdem erfahren Sie, wie Sie sie aktualisieren können, damit anstelle der E-Mail-Adresse eines einzelnen Nutzers ein gemeinsames Team-Alias verwendet wird.
Kontakt-E-Mail-Adresse für die Google Ads API
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 den Zugriff auf diesen Alias sicherstellen und E-Mails, die an diese Adresse gesendet werden, regelmäßig überwachen. Google verwendet diese E-Mail-Adresse, um Ihr Team bei API-Überprüfungen, Audit-Anfragen oder Produktionsnotfällen zu kontaktieren, die sofortige Aufmerksamkeit erfordern. Verwenden Sie einen gemeinsamen Team-Alias 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:
- Melden Sie sich in dem Google Ads-Verwaltungskonto an, mit dem Sie den Zugriff auf die Google Ads API beantragt haben. Dies ist dasselbe Konto, in dem sich auch Ihr Entwickler-Token befindet.
- Rufen Sie Tools und Einstellungen > API-Center auf.
- Klicken Sie auf den Pfeil unter dem Abschnitt Kontakt-E-Mail-Adresse für API.
- Aktualisieren Sie die E-Mail-Adresse und klicken Sie auf Speichern.
Google Cloud Console-Konto
Das Projekt Google API Console enthält die OAuth-Anmeldedaten Ihrer Anwendung und steuert den Zugriff auf die Google Ads API. Stellen Sie den Zugriff auf dieses Konto sicher, indem Sie einen freigegebenen 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 links oben auf der Seite im Drop-down-Menü aus.
- Gehen Sie im Menü auf der linken Seite zu IAM und Verwaltung > IAM.
- Klicken Sie auf die Schaltfläche Zugriff gewähren.
- Geben Sie im Bereich Hauptkonten hinzufügen die freigegebene E-Mail-Adresse ein.
- Weisen Sie die Rolle Inhaber zu.
- Klicken Sie auf Speichern. Weitere Informationen zum Gewähren und Entziehen von Zugriff finden Sie in der Cloud-Dokumentation.
Google Ads-Verwaltungskonto
Eine gängige Methode zur Verwaltung von Konten mithilfe der Google Ads API besteht darin, alle Konten unter einem gemeinsamen Verwaltungskonto zu verknüpfen und API-Aufrufe an alle Konten mit den Anmeldedaten des obersten Verwaltungskontos zu senden. In dieser Konfiguration gilt:
- Der Entwickler gibt mithilfe der Anmeldedaten eines Nutzers, der Zugriff auf das Google Ads-Verwaltungskonto hat, ein Aktualisierungstoken aus.
- Der Entwickler legt den Header
login_customer_idals Kundennummer des Google Ads-Verwaltungskontos und den Headercustomer_idals Kundennummer des Kontos fest, an das API-Aufrufe gesendet werden.
Ein potenzielles Risiko dieser Einrichtung besteht darin, dass das Aktualisierungstoken nicht mehr gültig ist und alle API-Aufrufe fehlschlagen, wenn der autorisierte Nutzer keinen Zugriff mehr auf das Google Ads-Verwaltungskonto hat. 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 freigegebenen E-Mail-Alias, um das Aktualisierungstoken für API-Aufrufe auszustellen.