Für Anfragen an den ReachPlanService müssen OAuth
Anmeldedaten und eine Kundennummer angegeben werden, auf die mit den OAuth-Anmeldedaten zugegriffen werden kann. Außerdem muss das Google Cloud-Projekt, das mit Ihren OAuth-Anmeldedaten verknüpft ist, für die Verwendung dieses Dienstes genehmigt sein.
In dieser Anleitung werden die Authentifizierungsdetails für
ReachPlanService behandelt. Falls noch nicht geschehen, führen Sie zuerst
die Schritte unter Erste Schritteaus und kehren Sie dann zu dieser Anleitung zurück.
OAuth-Anmeldedaten
Zusätzlich zu den Informationen unter Erste Schritte sollten Sie die folgenden Punkte beachten:
- Ihre Google Cloud-Projektnummer muss der entsprechenden Zulassungsliste
hinzugefügt werden, um eine Verbindung zum
ReachPlanServiceherzustellen. Das gilt auch, wenn sie bereits für die Verwendung mit anderen Google Ads API-Diensten genehmigt ist. Weitere Informationen finden Sie unter Teilnahmevoraussetzungen. - Sie müssen die Nutzungsbedingungen für die Google Ads API akzeptieren, um eine Verbindung zur Google Ads API herzustellen.
- Der Nutzer, dem Ihr OAuth-Aktualisierungstoken gehört, bestimmt, welche Kundennummern Sie
abfragen können im
ReachPlanService. Das wirkt sich auf Ihre Integration aus und wird in den folgenden Abschnitten genauer erläutert.
Kundennummern
Die meisten Dienste in der Google Ads API funktionieren mit bestimmten Google Ads-Konten und ‑Kampagnen. Daher sind für die meisten Anfragen sowohl eine Kundennummer zur Identifizierung des Zielkontos als auch OAuth-Anmeldedaten erforderlich, die für den Zugriff auf diese Kundennummer autorisiert sind.
Der ReachPlanService ist jedoch für die Videoplanung
vorgesehen, die möglicherweise erfolgt, bevor Sie ein bestimmtes Kundenkonto für
die Ausführung einer Kampagne einrichten.
Interne Tools
Wenn Sie Tools für den internen Gebrauch in Ihrer Organisation entwickeln, haben Sie folgende Möglichkeiten:
- Planer ohne direkten Zugriff auf Kundenkonten: Wenn Ihre Planer keinen
Zugriff auf die Google Ads-Konten Ihrer Kunden haben, generieren Sie OAuth-Anmeldedaten
mit dem Authentifizierungsablauf für einen einzelnen Nutzer
für einen Nutzer mit Zugriff auf Ihr Verwaltungskonto. Erstellen oder besorgen Sie dann für jedes Team ein
Google Ads-Konto mit Ihrem Tool und verknüpfen Sie es mit Ihrem Verwaltungskonto. Wenn Sie Anfragen an
ReachPlanServicesenden, geben Sie die Kundennummer an, die dem Team des Nutzers entspricht. - Planer mit Zugriff auf Kundenkonten: Wenn Ihre Planer Zugriff auf ein Google Ads-Verwaltungskonto haben, über das die Konten Ihrer Kunden verwaltet werden, implementieren Sie den Authentifizierungsablauf für mehrere Nutzer, damit Ihre Anwendung die OAuth-Anmeldedaten Ihrer Planer verwenden kann. Anschließend können Sie die Kundennummer übergeben, die dem Kundenplan entspricht.
Externe Tools
Wenn Sie Tools für Drittanbieter oder externe Nutzer entwickeln, empfehlen wir die folgenden Optionen:
- Kundenkonten:Generieren Sie OAuth-Anmeldedaten mit dem Authentifizierungsablauf für einen einzelnen Nutzer für einen Nutzer mit Zugriff auf Ihr Verwaltungskonto. Erstellen Sie für jeden externen Kunden ein Google Ads-Konto und verknüpfen Sie es mit Ihrem Verwaltungskonto. Konfigurieren Sie Ihr Tool so, dass die entsprechende Kundennummer des Kunden angegeben wird, wenn Pläne erstellt werden.
- Vom Nutzer gewährter Zugriff: Ermöglichen Sie Ihren Nutzern, Ihrem Tool mit dem Authentifizierungsablauf für mehrere Nutzer Zugriff auf ihre
Konten zu gewähren. Sobald ein Nutzer die Berechtigung erteilt hat, verwenden Sie
die
CustomerService, um die Liste der Google Ads -Konten abzurufen, auf die er zugreifen kann.
Wählen Sie vor der Integration der API einen der oben genannten Ansätze basierend auf Ihren Systemanforderungen aus und ermitteln Sie einige Testkundennummern. Im Zweifelsfall beginnen Sie mit dem Authentifizierungsablauf für einen einzelnen Nutzer mit verknüpften Konten.
Nächste Schritte
Informationen zum Angeben eines Mediaplans