Anfragen an die ReachPlanService müssen ein genehmigtes Entwickler-Token, OAuth-Anmeldedaten und eine Kunden-ID enthalten, auf die Ihre OAuth-Anmeldedaten zugreifen können.
In diesem Leitfaden werden spezifische Authentifizierungsdetails für ReachPlanService behandelt. Falls noch nicht geschehen, führen Sie zuerst die unter Erste Schritte beschriebenen Schritte aus und kehren Sie dann hierher zurück.
Entwicklertoken und OAuth-Anmeldedaten
Zusätzlich zur Anleitung unter Erste Schritte sollten Sie die folgenden Punkte beachten:
- Ihr Entwicklertoken muss auf der Zulassungsliste für die Verbindung mit der
ReachPlanServicestehen, auch wenn das Token bereits für die Verwendung mit anderen Google Ads API-Diensten zugelassen ist. Weitere Informationen findest du in den Teilnahmevoraussetzungen. - Sie müssen die Nutzungsbedingungen der Google Ads API akzeptieren, um eine Verbindung zur Google Ads API herstellen zu können.
- Der Inhaber Ihres OAuth-Aktualisierungstokens bestimmt, welche Kundennummern Sie in der
ReachPlanServiceabfragen können. Dies fließt in Ihre Integration ein und wird unten genauer erläutert.
Kundennummern
Die meisten Dienste in der Google Ads API laufen über bestimmte Google Ads-Konten und -Kampagnen. Daher benötigen die meisten Anfragen sowohl eine Kundennummer zur Identifizierung des von Ihnen verwalteten oder abgefragten Kontos als auch OAuth-Anmeldedaten mit Zugriffsberechtigung für diese Kundennummer. ReachPlanService ist jedoch für Videoplanungsaktivitäten vorgesehen, die möglicherweise stattfinden, bevor Sie die Kundennummer kennen, bei der Sie eine Kampagne ausführen würden.
Wir empfehlen Partnern, die Tools für die interne Verwendung in ihrer Organisation erstellen, eine der folgenden Optionen:
Wenn die Planer keinen Zugriff auf die Google Ads-Konten Ihrer Kunden haben: Generieren Sie OAuth-Anmeldedaten mithilfe des Ablaufs der installierten Anwendungen für einen Nutzer mit Zugriff auf das Verwaltungskonto Ihres Entwicklertokens. Erstellen oder erwerben 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 Vorgang für Webanwendungen, damit in Ihrer Anwendung die OAuth-Anmeldedaten der Planer verwendet werden können. Dann können Sie die Kundennummer übergeben, die dem Kunden Ihres Tarifs entspricht.
Partnern, die ein Tool für externe Nutzer erstellen, empfehlen wir ähnliche Ansätze:
Generieren Sie OAuth-Anmeldedaten mithilfe des Ablaufs installierter Anwendungen für einen Nutzer mit Zugriff auf das Verwaltungskonto Ihres Entwickler-Tokens. Erstellen Sie für jeden externen Kunden ein Google Ads-Konto und verknüpfen Sie ihn mit Ihrem Verwaltungskonto. Konfigurieren Sie dann Ihr Tool so, dass beim Generieren von Plänen die entsprechende Kundennummer eines Kunden angegeben wird.
Ermöglichen Sie Ihren Nutzern, dem Tool mithilfe des Webanwendungsablaufs Zugriff auf ihre Konten zu gewähren. Nachdem ein Nutzer die Berechtigung erteilt hat, können Sie ihm mit der
CustomerServiceeine Liste der Google Ads-Konten zukommen lassen, auf die er Zugriff hat.
Ziel ist es, die Verwendung 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 legen Sie einige Kundennummern zum Testen fest. Verwenden Sie im Zweifelsfall die erste empfohlene Vorgehensweise für Ihren Tooltyp.