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:
- E-Mail-Adresse des Google Ads API-Kontakts: Dies 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: Diese E-Mail-Adresse hat Administratorzugriff auf das Google Cloud Console-Konto, das für deine OAuth 2.0-Anwendung verwendet wird.
- E-Mail-Adressen des Google Ads-Verwaltungskontos: Das 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 in der Regel mit einer dieser E-Mail-Adressen.
Wir empfehlen dringend, geteilte Aliasse für Teams zu verwenden, damit Sie nicht den Zugriff auf diese Konten verlieren, wenn einzelne Teammitglieder das Team wechseln oder das Unternehmen verlassen. Im Rest dieses Leitfadens werden die oben aufgeführten E-Mails näher erläutert und Sie erfahren, wie Sie sie so aktualisieren können, dass ein freigegebener Alias für das Team anstelle der E-Mail-Adresse eines einzelnen Nutzers verwendet wird.
E-Mail-Adresse des Google Ads API-Kontakts
Die E-Mail-Adresse des Ansprechpartners für die Google Ads API ist die E-Mail-Adresse, die Sie bei der Registrierung für die Google Ads API angegeben haben. Sie sollten Zugriff auf diesen Alias haben und E-Mails, die an diese Adresse gesendet werden, regelmäßig prüfen. Google verwendet diese E-Mail-Adresse, um Ihr Team bei API-Überprüfungen, Auditanfragen oder Produktionsnotfällen zu kontaktieren, die sofortige Aufmerksamkeit erfordern. Verwenden Sie einen freigegebenen Teamalias als Kontakt-E-Mail-Adresse, damit das gesamte Team diese Benachrichtigungen erhält.
So aktualisieren Sie die E-Mail-Adresse des API-Kontakts:
Klicken Sie links unten auf dem Bildschirm auf Verwaltung.
Klicken Sie unter Einstellungen des Verwaltungskontos auf API-Konsole.
Notieren Sie sich unter Entwicklerdetails die E-Mail-Adresse des API-Kontakts. Klicken Sie auf den Abwärtspfeil und bearbeiten Sie die E-Mail. Klicken Sie auf Speichern.
Google Cloud Console-Konto
Das Projekt in der Google API Console enthält die OAuth-Anmeldedaten Ihrer Anwendung und steuert den Zugriff auf die Google Ads API. Damit Sie Zugriff auf dieses Konto haben, müssen 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 links oben auf der Seite im Drop-down-Menü Ihr Projekt aus.
- Gehen Sie im Menü links zu IAM und Verwaltung > IAM.
- Klicken Sie auf die Schaltfläche Zugriff gewähren.
- Geben Sie die E-Mail-Adresse der freigegebenen E-Mail-Adresse im Abschnitt Hauptkonten hinzufügen ein.
- Weisen Sie die Rolle Inhaber zu.
- Klicken Sie auf Speichern. Weitere Informationen zum Erteilen und Widerrufen von Zugriffsrechten 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 an alle Konten mit den Anmeldedaten des übergeordneten Verwaltungskontos zu senden. Bei dieser Konfiguration:
- Der Entwickler stellt ein Aktualisierungstoken mit den Anmeldedaten eines Nutzers aus, der Zugriff auf das Google Ads-Verwaltungskonto hat.
- Der Entwickler legt die Kopfzeile
login_customer_idals Kunden-ID des Google Ads-Verwaltungskontos und die Kopfzeilecustomer_idals Kunden-ID des Kontos fest, für das API-Aufrufe ausgeführt werden.
Ein potenzielles Risiko dieser Konfiguration besteht darin, dass das Aktualisierungstoken ungültig wird und alle API-Aufrufe fehlschlagen, wenn der autorisierte Nutzer den Zugriff auf das Google Ads-Verwaltungskonto verliert. Sie können dieses Szenario vermeiden, indem Sie einen freigegebenen E-Mail-Alias mit den entsprechenden Zugriffsebenen zum Verwalten dieses Google Ads-Verwaltungskontos einladen. Verwenden Sie diesen gemeinsamen E-Mail-Alias, um das Aktualisierungstoken für API-Aufrufe auszustellen.