Für Anfragen an ReachPlanService müssen ein genehmigtes Entwicklertoken, OAuth-Anmeldedaten und eine Kunden-ID angegeben werden, auf die mit Ihren OAuth-Anmeldedaten zugegriffen werden kann.
In diesem Leitfaden werden Authentifizierungsdetails für ReachPlanService behandelt. Wenn Sie das noch nicht getan haben, führen Sie zuerst die Schritte unter Erste Schritte aus und kehren Sie dann zu diesem Punkt zurück.
Entwicklertoken und OAuth-Anmeldedaten
Beachten Sie zusätzlich zur Anleitung unter Erste Schritte die folgenden Punkte:
- Ihr Entwicklertoken muss der entsprechenden Zulassungsliste hinzugefügt werden, um eine Verbindung zur
ReachPlanServiceherzustellen, 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 herzustellen.
- Der Nutzer, dem Ihr OAuth-Aktualisierungstoken gehört, bestimmt, welche Kunden-IDs Sie in der
ReachPlanServiceabfragen können. Dies ist für Ihre Integration wichtig und wird in den folgenden Abschnitten näher erläutert.
Kundennummern
Die meisten Dienste in der Google Ads API beziehen sich auf bestimmte Google Ads-Konten und ‑Kampagnen. Daher ist 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. ReachPlanService ist jedoch für die Videoplanung gedacht, die möglicherweise stattfindet, bevor Sie die spezifische Kundennummer kennen, unter der Sie eine Kampagne schalten möchten.
Interne Tools
Wenn Sie Tools für den internen Gebrauch in Ihrer Organisation entwickeln, finden Sie hier unsere Empfehlungen.
Planer ohne direkten Zugriff auf das Kundenkonto
Wenn Ihre Planer keinen Zugriff auf die Google Ads-Konten Ihrer Kunden haben, generieren Sie OAuth-Anmeldedaten mit dem Flow für installierte Anwendungen für einen Nutzer mit Zugriff auf das Verwaltungskonto Ihres Entwickler-Tokens. Erstellen Sie dann für jedes Team, das Ihr Tool verwendet, ein Google Ads-Konto oder fordern Sie es an und verknüpfen Sie es mit Ihrem Verwaltungskonto. Geben Sie bei Anfragen an ReachPlanService die Kunden-ID 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 Webanwendungsablauf, damit Ihre App die OAuth-Anmeldedaten Ihrer Planer verwenden kann. Anschließend können Sie die Kunden-ID des Kunden Ihres Plans übergeben.
Externe Tools
Wenn Sie ein Tool für externe Nutzer entwickeln, empfehlen wir ähnliche Ansätze:
Pro Kundenkonto
Generieren Sie OAuth-Anmeldedaten mit dem Ablauf für installierte Anwendungen 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 Verwaltungskonto. Konfigurieren Sie dann Ihr Tool so, dass die entsprechende Kunden-ID eines Kunden angegeben wird, wenn Pläne erstellt werden.
Vom Nutzer gewährter Zugriff
Mit dem Webanwendungsablauf können Sie Ihren Nutzern die Möglichkeit geben, Ihrem Tool Zugriff auf ihre Konten zu gewähren. Nachdem ein Nutzer die Berechtigung erteilt hat, können Sie mit CustomerService eine Liste der Google Ads-Konten abrufen, auf die er zugreifen kann.
Ziel ist es, die Nutzung der 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 Kunden-IDs für Tests. Im Zweifelsfall sollten Sie den ersten vorgeschlagenen Ansatz für Ihren Tooltyp verwenden.