Geteilte Aliasse

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:

• Kontakt-E-Mail-Adresse für die Google Ads API: Die E-Mail-Adressen, denen die Rolle Inhaber oder Bearbeiter für Ihr Google Cloud-Projekt zugewiesen ist. Google verwendet diese Adressen, um obligatorische Servicemitteilungen und administrative Benachrichtigungen zu senden.
• E-Mail-Adresse des Google Cloud Console-Kontos: Die E-Mail-Adresse, die Administratorzugriff auf das Google Cloud-Projekt hat, das für Ihre OAuth 2.0-Anwendung verwendet wird.
• Zugriff auf das Google Ads-Verwaltungskonto: Das Dienstkonto (empfohlen) oder der freigegebene E‑Mail-Alias mit Zugriffsberechtigungen für die Google Ads-Verwaltungskonten, auf die über die Google Ads API zugegriffen wird.

Hinweis: Wir empfehlen dringend, Dienstkonten oder freigegebene Team-Aliasse anstelle von individuellen Nutzer-E-Mails zu verwenden, damit Sie den Zugriff auf diese Konten nicht verlieren, wenn Teammitglieder das Team wechseln oder das Unternehmen verlassen. Achten Sie darauf, dass alle freigegebenen E‑Mail-Aliasse, die für die Google Cloud- oder Google Ads-Authentifizierung verwendet werden, mit einem aktiven Google-Konto verknüpft sind, das E‑Mails empfangen und die Passkey-Bestätigung durchführen kann.

Im weiteren Verlauf dieses Leitfadens werden die oben aufgeführten Konten und die Konfiguration dieser Konten erläutert, damit Ihre Integration nicht von der E-Mail-Adresse eines einzelnen Nutzers abhängt.

Google Ads API-Kontakt-E-Mail-Adresse

Google sendet administrative Benachrichtigungen, Updates zur API-Überprüfung, Prüfungsanfragen, Servicemitteilungen (MSAs) und Kommunikationsmittel für Notfälle zur Produktion an die E-Mail-Adressen, die mit den Rollen Inhaber und Bearbeiter Ihres Google Cloud-Projekts verknüpft sind. Weitere Informationen finden Sie unter Neue API-Kontakt-E-Mails, da die alte Einstellung für die API-Center-Kontakt-E-Mail-Adresse in der Google Ads-Benutzeroberfläche eingestellt wurde.

Wenn Sie Ihre Kontakt-E-Mail-Adresse aktualisieren und dafür sorgen möchten, dass Ihr gesamtes Team diese Benachrichtigungen erhält, weisen Sie einem freigegebenen Team-Alias in Ihrem Google Cloud-Projekt die Rolle Inhaber oder Bearbeiter zu und prüfen Sie regelmäßig die an diesen Alias gesendeten E-Mails.

Google Cloud Console-Konto

Das Google Cloud Console-Projekt enthält die OAuth-Anmeldedaten Ihrer Anwendung und steuert den Zugriff auf die Google Ads API. Gewähren Sie einem freigegebenen Teamalias die Rolle Inhaber (oder Bearbeiter), um den Zugriff auf dieses Projekt zu ermöglichen.

So fügen Sie einen freigegebenen Alias als Google Cloud-Projektinhaber hinzu:

1. Melden Sie sich in der Google Cloud Console an.
2. Wählen Sie oben auf der Seite in der Projektauswahl Ihr Projekt aus.
3. Klicken Sie im Navigationsmenü auf IAM und Verwaltung > IAM.
4. Klicken Sie auf Zugriff gewähren.
5. Geben Sie im Abschnitt Hauptkonten hinzufügen die freigegebene E-Mail-Adresse in das Feld Neue Hauptkonten ein.
6. Klicken Sie im Abschnitt Rollen zuweisen auf Rolle auswählen und wählen Sie Einfach > Inhaber (oder Einfach > Bearbeiter) aus.
7. Klicken Sie auf Speichern. Wenn Sie die Rolle Inhaber einer E-Mail-Adresse außerhalb Ihrer Google Cloud-Organisation (oder in einem Projekt ohne Organisation) zugewiesen haben, sendet Google Cloud eine E-Mail-Einladung an den freigegebenen Alias, die angenommen werden muss, bevor die Rolle wirksam wird. Weitere Informationen zum Gewähren und Widerrufen des Zugriffs finden Sie in der Cloud-Dokumentation.

Google Ads-Verwaltungskonto

Eine gängige Methode zur Verwaltung von Konten mit der Google Ads API besteht darin, alle Ihre 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 legt der Entwickler den Anfrageheader login-customer-id (oder die Konfigurationseinstellung login_customer_id der Clientbibliothek) auf die 10-stellige Kundennummer (ohne Bindestriche) des Google Ads-Verwaltungskontos fest. Außerdem legt er das Ziel customer_id auf das Betriebskonto fest, an das API-Aufrufe gesendet werden.

Empfohlen: Dienstkonto verwenden

Die Verwendung eines Dienstkontos ist die bevorzugte Methode, um sich zu authentifizieren und auf ein Google Ads-Verwaltungskonto zuzugreifen. Im Gegensatz zu einzelnen Nutzerkonten wird ein Dienstkonto in Ihrem Google Cloud-Projekt verwaltet und ist nicht an eine bestimmte Person gebunden. So werden Ausfälle vermieden, wenn Teammitglieder die Rolle wechseln oder das Unternehmen verlassen. Folgen Sie der Anleitung für Dienstkonten, um ein Dienstkonto zu erstellen und ihm Zugriff auf Ihr Google Ads-Verwaltungskonto zu gewähren.

Alternative: Gemeinsam genutzten E‑Mail-Alias verwenden

Wenn für Ihre Integration kein Dienstkonto verwendet werden kann und stattdessen der Authentifizierungs-Workflow für einzelne Nutzer verwendet wird, stellt ein Nutzer mit Zugriff auf das Google Ads-Verwaltungskonto ein OAuth 2.0-Aktualisierungstoken aus.

Achtung: Wenn der autorisierte Nutzer den Zugriff auf das Google Ads-Verwaltungskonto verliert, ist das Aktualisierungstoken nicht mehr gültig und alle API-Aufrufe schlagen sofort fehl.

So vermeiden Sie dieses Szenario, wenn Sie Nutzeranmeldedaten verwenden:

1. Laden Sie einen freigegebenen E-Mail-Alias (der mit einem aktiven Google-Konto mit aktivierter Passkey-Bestätigung verknüpft ist) ein, dieses Google Ads-Verwaltungskonto mit den entsprechenden Zugriffsebenen zu verwalten.
2. Nehmen Sie die Einladung über den freigegebenen E‑Mail-Alias an.
3. Verwenden Sie diesen freigegebenen E-Mail-Alias, um das OAuth-Aktualisierungstoken für API-Aufrufe auszustellen.