Bei der Arbeit mit der Google Ads API gibt es mehrere Stellen, an denen E-Mail-Adressen für die Kontakt- und Zugriffsverwaltung verwendet werden. Hier sind die wichtigsten:
- Kontakt-E-Mail-Adresse für Google Ads API: Das ist die E-Mail-Adresse, die im API-Center der Google Ads-Benutzeroberfläche als Kontakt angegeben 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-Adresse(n) 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 die 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 das Team wechseln oder das Unternehmen verlassen. Im weiteren Verlauf dieses Leitfadens werden die zuvor aufgeführten E-Mails näher ausgeführt und erläutert, wie Sie sie aktualisieren können, um einen gemeinsamen Teamalias anstelle der E-Mail-Adresse eines einzelnen Nutzers zu verwenden.
E-Mail-Adresse des Ansprechpartners 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 regelmäßig E-Mails überwachen, die an diese Adresse gesendet werden. Google verwendet diese E-Mail-Adresse, um Ihr Team während API-Überprüfungen, Auditanfragen oder Produktionsnotfällen, die sofortige Aufmerksamkeit erfordern, zu kontaktieren. Verwenden Sie einen gemeinsamen Teamalias als Kontakt-E-Mail-Adresse, um sicherzustellen, dass 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, über das Sie den Zugriff auf die Google Ads API beantragt haben. Dies ist das Konto, in dem sich auch Ihr Entwicklertoken befindet.
- Gehen Sie zu Tools und Einstellungen > API-Center.
- Klicken Sie auf den Pfeil unter dem Bereich 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. Legen Sie einen gemeinsamen Alias zum Kontoinhaber fest, um Zugriff auf dieses Konto zu erhalten.
Führen Sie die folgenden Schritte aus, um den Inhaber des Google API Console-Projekts zu aktualisieren:
- Melden Sie sich in der Google API Console an.
- Wählen Sie Ihr Projekt aus dem Drop-down-Menü oben links auf der Seite aus.
- Rufen Sie im Menü auf der linken Seite 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 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 Ihre 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 mit den Anmeldedaten eines Nutzers, der Zugriff auf das Google Ads-Verwaltungskonto hat, ein Aktualisierungstoken aus.
- Der Entwickler legt den
login_customer_id-Header als Kundennummer des Google Ads-Verwaltungskontos und dencustomer_id-Header als Kundennummer des Kontos fest, an das API-Aufrufe erfolgen.
Ein potenzielles Risiko bei 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 freigegebenen 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.