Anfragen an die ReachPlanService müssen ein genehmigtes Entwicklertoken, OAuth-Anmeldedaten und eine Kundennummer enthalten, auf die Ihre OAuth-Anmeldedaten zugreifen können.
In diesem Leitfaden werden Details zur Authentifizierung für ReachPlanService beschrieben. Falls noch nicht geschehen, führen Sie zuerst die unter Erste Schritte beschriebenen Schritte aus und kehren Sie dann zu diesem Punkt zurück.
Entwicklertoken und OAuth-Anmeldedaten
Zusätzlich zu den Anleitungen unter Erste Schritte sind die folgenden Punkte zu beachten:
- Das Entwicklertoken muss auf der Zulassungsliste für die Verbindung mit der
ReachPlanServicestehen, auch wenn es bereits für die Verwendung mit anderen Google Ads API-Diensten genehmigt wurde. Weitere Informationen finden Sie in den Teilnahmevoraussetzungen. - Sie müssen die Nutzungsbedingungen für die Google Ads API akzeptieren, um eine Verbindung zur Google Ads API herstellen zu können.
- Der Nutzer, dem Ihr OAuth-Aktualisierungstoken gehört, bestimmt, welche Kundennummern Sie in der
ReachPlanServiceabfragen können. Dies wirkt sich auf die Integration aus und wird unten genauer erklärt.
Kundennummern
Die meisten Dienste innerhalb der Google Ads API beziehen sich auf bestimmte Google Ads-Konten und -Kampagnen. Daher sind für die meisten Anfragen sowohl eine Kundennummer erforderlich, um das von Ihnen verwaltete oder abgefragte Konto zu identifizieren, als auch OAuth-Anmeldedaten, die eine Zugriffsberechtigung für diese Kundennummer haben. ReachPlanService ist jedoch für Videoplanungsaktivitäten gedacht, die möglicherweise stattfinden, bevor Sie die spezifische Kundennummer kennen, unter der Sie eine Kampagne ausführen möchten.
Für Partner, die Tools für den internen Gebrauch in ihrer Organisation erstellen, empfehlen wir eine der folgenden Optionen:
Wenn Ihre Planer keinen Zugriff auf die Google Ads-Konten Ihrer Kunden haben: Generieren Sie OAuth-Anmeldedaten mithilfe des Workflows für installierte Anwendungen für einen Nutzer, der Zugriff auf das Verwaltungskonto Ihres Entwicklertokens hat. Erstellen oder erstellen 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
ReachPlanServicedie Kundennummer des Teams eines Nutzers an.Wenn Ihre Planer Zugriff auf ein Google Ads-Verwaltungskonto haben, über das die Konten Ihrer Kunden verwaltet werden: Implementieren Sie den Webanwendungsablauf, damit für Ihre Anwendung die OAuth-Anmeldedaten Ihrer Planer verwendet werden können. Anschließend können Sie die Kundennummer des Kunden Ihres Tarifs übergeben.
Für Partner, die ein Tool für externe Nutzer erstellen, empfehlen wir ähnliche Ansätze:
Generieren Sie OAuth-Anmeldedaten mithilfe des Workflows für installierte Anwendungen für einen Nutzer mit Zugriff auf das Verwaltungskonto Ihres Entwicklertokens. Erstellen Sie ein Google Ads-Konto für jeden externen Kunden und verknüpfen Sie ihn mit Ihrem Verwaltungskonto. Konfigurieren Sie dann Ihr Tool so, dass beim Erstellen von Plänen die entsprechende Kundennummer eines Clients bereitgestellt wird.
Geben Sie Ihren Nutzern die Möglichkeit, Ihrem Tool mithilfe von Webanwendungen Zugriff auf ihre Konten zu gewähren. Nachdem ein Nutzer die Berechtigung erteilt hat, stellen Sie ihm mithilfe des
CustomerServiceeine Liste der Google Ads-Konten zur Verfügung, auf die er zugreifen kann.
Ziel ist es, bei der Verwendung von ReachPlanService möglichst reibungslose Abläufe für Planer zu schaffen. Bevor Sie die API einbinden, wählen Sie je nach Situation einen der beiden Ansätze aus und identifizieren Sie einige Kunden-IDs zum Testen. Im Zweifelsfall verwenden Sie den ersten vorgeschlagenen Ansatz für Ihren Tooltyp.