Für Anfragen an den ReachPlanService müssen
ein genehmigtes Entwicklertoken, OAuth-Anmeldedaten und eine Kundennummer angegeben werden, auf die mit Ihren OAuth-Anmeldedaten zugegriffen werden kann.
In dieser Anleitung werden die Authentifizierungsdetails für
ReachPlanService behandelt. Führen Sie zuerst die Schritte unter Erste
Schritte aus und kehren Sie dann zu diesem Punkt zurück.
Entwicklertoken und OAuth-Anmeldedaten
Zusätzlich zu den Informationen unter Erste Schritte sollten Sie Folgendes beachten:
- Ihr Entwicklertoken muss der entsprechenden Zulassungsliste hinzugefügt werden, um eine Verbindung
zum
ReachPlanServiceherzustellen. Das gilt auch, wenn es bereits für die Verwendung mit anderen Google Ads API-Diensten genehmigt wurde. Weitere Informationen finden Sie unter Voraussetzungen . - Sie müssen die Nutzungsbedingungen für die Google Ads API akzeptieren, um eine Verbindung zur Google Ads API herzustellen.
- Der Nutzer, der Inhaber Ihres OAuth-Aktualisierungstokens ist, bestimmt, welche Kundennummern Sie
im
ReachPlanServiceabfragen können. Das wirkt sich auf Ihre Integration aus und wird in den folgenden Abschnitten näher 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 Kontos, das Sie verwalten oder abfragen, als auch OAuth
Anmeldedaten erforderlich, die die Berechtigung zum Zugriff auf diese
Kundennummer haben. Der ReachPlanService
ist jedoch für die Videoplanung vorgesehen, die möglicherweise erfolgt, bevor Sie die
spezifische Kundennummer kennen, unter der Sie eine Kampagne ausführen möchten.
Interne Tools
Wenn Sie Tools für den internen Gebrauch in Ihrem Unternehmen entwickeln, empfehlen wir Folgendes.
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 einzelne Nutzer
für einen Nutzer mit Zugriff auf
das Verwaltungskonto Ihres Entwicklertokens. Erstellen oder besorgen Sie dann
für jedes Team, das Ihr Tool verwendet, ein Google Ads-Konto und verknüpfen Sie es mit
Ihrem Verwaltungskonto. Geben Sie bei Anfragen an
ReachPlanService die Kundennummer an,
die dem Team eines 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 App die OAuth-Anmeldedaten Ihrer Planer verwenden kann. Anschließend können Sie die Kundennummer übergeben, die dem Kunden Ihres Plans entspricht.
Externe Tools
Wenn Sie ein Tool für externe Nutzer entwickeln, empfehlen wir ähnliche Ansätze:
Konten pro Kunde
Generieren Sie OAuth-Anmeldedaten mit dem Authentifizierungsablauf für einzelne Nutzer für einen Nutzer mit Zugriff auf das Verwaltungskonto Ihres Entwicklertokens. Erstellen Sie für jeden externen Kunden ein Google Ads Konto und verknüpfen Sie es mit Ihrem Verwaltung Konto. Konfigurieren Sie dann Ihr Tool so, dass die entsprechende Kundennummer eines Kunden angegeben wird, wenn dieser Pläne erstellt.
Vom Nutzer gewährter Zugriff
Geben Sie Ihren Nutzern die Möglichkeit, Ihrem Tool über den Authentifizierungsablauf für mehrere Nutzer Zugriff auf ihre Konten zu gewähren. Sobald ein Nutzer die
Berechtigung erteilt hat, verwenden Sie den
CustomerService, um
ihm eine Liste der Google Ads-Konten zur Verfügung zu stellen, auf die er zugreifen kann.
Ziel ist es, die Nutzung des
ReachPlanService für Planer so einfach wie möglich zu gestalten. Bevor Sie die API einbinden, wählen Sie je nach Situation einen der beiden Ansätze aus und ermitteln Sie einige Kundennummern zum Testen. Im Zweifelsfall verwenden Sie den ersten vorgeschlagenen Ansatz für Ihren Tooltyp.
Nächste Schritte
Informationen zum Angeben eines Mediaplans