Bei Anfragen an die ReachPlanService müssen OAuth-Anmeldedaten und eine Kundennummer angegeben werden, auf die Ihre OAuth-Anmeldedaten zugreifen können. Außerdem muss das mit Ihren OAuth-Anmeldedaten verknüpfte Google Cloud-Projekt für die Verwendung dieses Dienstes genehmigt sein.
In diesem Leitfaden werden die Authentifizierungsdetails für ReachPlanService behandelt. Falls noch nicht geschehen, führen Sie zuerst die Schritte unter Erste Schritte aus und kehren Sie dann zu diesem Leitfaden zurück.
OAuth-Anmeldedaten
Zusätzlich zu den Hinweisen unter Erste Schritte sollten Sie Folgendes beachten:
- Ihre Google Cloud-Projektnummer muss der entsprechenden Zulassungsliste hinzugefügt werden, um eine Verbindung zur
ReachPlanServiceherzustellen, auch wenn sie 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 der Google Ads API akzeptieren, um eine Verbindung zur Google Ads API herstellen zu können.
- Der Nutzer, der Inhaber Ihres OAuth-Aktualisierungstokens ist, bestimmt, welche Kundennummern Sie in der
ReachPlanServiceabfragen können. Diese Informationen sind für Ihre Integration relevant und werden in den folgenden Abschnitten ausführlicher erläutert.
Kundennummern
Die meisten Dienste in der Google Ads API werden für bestimmte Google Ads-Konten und -Kampagnen verwendet. Daher sind für die meisten Anfragen sowohl eine Kundennummer zur Identifizierung des Zielkontos als auch OAuth-Anmeldedaten erforderlich, die für den Zugriff auf diese Kundennummer autorisiert sind.
ReachPlanService ist jedoch für die Planung von Videoaktivitäten gedacht, die möglicherweise vor dem Einrichten eines bestimmten Kundenkontos für die Ausführung einer Kampagne erfolgen.
Interne Tools
Wenn Sie Tools für die interne Verwendung in Ihrer Organisation erstellen, sollten Sie die folgenden Optionen in Betracht ziehen:
- 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 Ihr Verwaltungskonto. Erstellen Sie dann für jedes Team, das Ihr Tool verwendet, ein Google Ads-Konto oder rufen Sie ein solches ab und verknüpfen Sie es mit Ihrem Verwaltungskonto. Geben Sie bei Anfragen an
ReachPlanServicedie Kundennummer des Teams des Nutzers an. - 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 Ablauf für die Multi-User-Authentifizierung, damit Ihre Anwendung die OAuth-Anmeldedaten Ihrer Planer verwenden kann. Anschließend können Sie die Kundennummer übergeben, die dem Kundenpreismodell entspricht.
Externe Tools
Wenn Sie Tools für Drittanbieter oder externe Nutzer erstellen, empfehlen wir die folgenden Optionen:
- Pro Kundenkonto: Generieren Sie OAuth-Anmeldedaten mit dem Authentifizierungsablauf für einzelne Nutzer für einen Nutzer mit Zugriff auf Ihr Verwaltungskonto. Erstellen Sie für jeden externen Kunden ein Google Ads-Konto und verknüpfen Sie es mit Ihrem Verwaltungskonto. Konfigurieren Sie Ihr Tool so, dass beim Erstellen von Plänen die entsprechende Kundennummer des Kunden angegeben wird.
- Vom Nutzer gewährter Zugriff: Ermöglichen Sie Ihren Nutzern, Ihrem Tool über den Authentifizierungsablauf für mehrere Nutzer Zugriff auf ihre Konten zu gewähren. Sobald ein Nutzer die Berechtigung erteilt hat, können Sie mit der
CustomerServicedie Liste der Google Ads-Konten abrufen, auf die er zugreifen kann.
Wählen Sie vor der Integration der API einen der oben genannten Ansätze basierend auf Ihren Systemanforderungen aus und legen Sie einige Test-Kundennummern fest. Im Zweifelsfall solltest du mit dem Authentifizierungsablauf für einzelne Nutzer mit verknüpften Konten beginnen.
Nächste Schritte
Informationen zum Angeben eines Mediaplans