Bei Anfragen an die ReachPlanService müssen
die OAuth-Anmeldedaten und eine Kundennummer angegeben werden, auf die mit den OAuth-Anmeldedaten zugegriffen werden kann. Außerdem muss das Google Cloud-Projekt, zu dem die OAuth-Anmeldedaten gehören, für die Verwendung dieses Dienstes genehmigt sein.
In diesem Leitfaden werden die Authentifizierungsdetails für den
ReachPlanService beschrieben. Führen Sie zuerst die Schritte unter Erste Schritte aus und kehren Sie dann zu diesem Punkt zurück.
OAuth-Anmeldedaten
Zusätzlich zu den Informationen unter Erste Schritte sollten Sie Folgendes 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 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 mit der Berechtigung für den Zugriff auf diese
Kundennummer erforderlich. 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 einen einzelnen Nutzer für einen Nutzer mit Zugriff auf
Ihr Verwaltungskonto. Erstellen oder besorgen Sie dann ein Google Ads-Konto für jedes Team
das Ihr Tool verwendet, und verknüpfen Sie es mit Ihrem Verwaltungskonto.
Geben Sie bei Anfragen an den 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 einen einzelnen Nutzer, der Zugriff auf Ihr Verwaltungskonto hat. Erstellen Sie ein Google Ads-Konto für jeden externen Kunden und verknüpfen Sie es mit Ihrem Verwaltungskonto. 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 Zugriff auf ihre Konten zu gewähren
indem sie den Authentifizierungsablauf für mehrere Nutzer
verwenden. 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