Für Anfragen an ReachPlanService müssen OAuth-Anmeldedaten und eine Kunden-ID angegeben werden, auf die mit Ihren OAuth-Anmeldedaten zugegriffen werden kann. Außerdem muss das Google Cloud-Projekt, das mit Ihren OAuth-Anmeldedaten verknüpft ist, für die Verwendung dieses Dienstes genehmigt werden.
In diesem Leitfaden werden 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 Informationen unter Erste Schritte sollten Sie Folgendes beachten:
- Ihre Google Cloud-Projektnummer muss der entsprechenden Zulassungsliste hinzugefügt werden, um eine Verbindung zur
ReachPlanServiceherzustellen. Das gilt auch, wenn sie bereits für die Verwendung mit anderen Google Ads API-Diensten genehmigt wurde. Weitere Informationen zu den Voraussetzungen - Sie müssen die Google Ads API-Nutzungsbedingungen 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. Das ist für Ihre Integration wichtig und wird in den folgenden Abschnitten genauer 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 Kunden-ID zur Identifizierung des Zielkontos als auch OAuth-Anmeldedaten erforderlich, die für den Zugriff auf diese Kunden-ID autorisiert sind.
ReachPlanService ist jedoch für die Videoplanung gedacht, die möglicherweise stattfindet, bevor Sie ein bestimmtes Kundenkonto zum Ausführen einer Kampagne einrichten.
Interne Tools
Wenn Sie Tools für die interne Verwendung in Ihrer Organisation entwickeln, sollten Sie die folgenden Optionen in Betracht ziehen:
- 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 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 lassen Sie ein Konto erstellen und verknüpfen Sie es mit Ihrem Verwaltungskonto. Wenn Sie Anfragen an
ReachPlanServicesenden, geben Sie die Kunden-ID an, die dem Team des Nutzers entspricht. - Planer mit Zugriff auf das Kundenkonto:Wenn Ihre Planer Zugriff auf ein Google Ads-Verwaltungskonto haben, über das die Konten Ihrer Kunden verwaltet werden, implementieren Sie den Multi-User-Authentifizierungsablauf, damit Ihre Anwendung die OAuth-Anmeldedaten Ihrer Planer verwenden kann. Anschließend können Sie die Kunden-ID übergeben, die dem Kundenabo entspricht.
Externe Tools
Wenn Sie Tools für Drittanbieter oder externe Nutzer entwickeln, empfehlen wir die folgenden Optionen:
- Konten pro Client:Generieren Sie OAuth-Anmeldedaten mit dem Authentifizierungsablauf für einzelne Nutzer für einen Nutzer mit Zugriff auf Ihr Verwaltungskonto. Erstellen Sie ein Google Ads-Konto für jeden externen Kunden und verknüpfen Sie es mit Ihrem Verwaltungskonto. Konfigurieren Sie Ihr Tool so, dass beim Generieren von Plänen die entsprechende Kunden-ID 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. Nachdem ein Nutzer die Berechtigung erteilt hat, können Sie mit
CustomerServicedie Liste der Google Ads-Konten abrufen, auf die er zugreifen kann.
Bevor Sie die API einbinden, wählen Sie einen der oben genannten Ansätze basierend auf Ihren Systemanforderungen aus und ermitteln Sie einige Testkunden-IDs. Im Zweifelsfall sollten Sie mit dem Authentifizierungsablauf für einzelne Nutzer mit verknüpften Konten beginnen.