Mit der Maps Booking API authentifizieren

Um Echtzeit-Updates vorzunehmen , müssen Sie Anfragen an die senden. Für die Maps Booking API müssen Sie Ihre Anfragen über OAuth 2.0 mit einem GCP-Dienstkonto authentifizieren, das Zugriff auf die API hat und dem die erforderliche QPS zugewiesen wurde. In dieser Anleitung werden die folgenden Schritte beschrieben:

  1. Google Cloud-Projekt einrichten
  2. Dienstkonto erstellen
  3. Maps Booking API in Ihrem GCP-Projekt aktivieren
  4. Häufige Probleme beheben

Informationen zum Senden von Anfragen an die API finden Sie im Abschnitt API-Updates in Echtzeit in der Anleitung zu Reservierungsangeboten.

Google Cloud-Projekt mit dem Aktionscenter einrichten

  1. Melden Sie sich in Ihrem Google Cloud Platform-Konto an.
  2. Sie können ein neues Projekt erstellen oder ein vorhandenes Projekt verwenden.
    • Notieren Sie sich die Cloud-Projektnummer, da Sie sie in den nächsten Schritten benötigen. Sie finden die Cloud-Projektnummer auch auf der Google Cloud Platform-Startseite. Die Cloud-Projektnummer besteht immer nur aus Ziffern.
  3. Melden Sie sich im Partner-Portal an.
  4. Führen Sie Schritt 1 auf der Seite „Onboarding-Aufgaben“ des Partner-Portals aus, indem Sie die Cloud-Projektnummer und die E-Mail-Adresse des Cloud-Projekts (die E-Mail-Adresse, die zum Verwalten des Cloud-Projekts verwendet wird) senden.

Dienstkonto und OAuth-Anmeldedaten erstellen

  1. Melden Sie sich wieder in Ihrem Google Cloud Platform-Konto an.
  2. Rufen Sie „IAM & Verwaltung“ > „Dienstkonten“ auf.
  3. Suchen Sie nach Ihrer vorhandenen oder neu erstellten Cloud-Projekt-ID.
  4. Erstellen Sie ein Dienstkonto.
  5. Geben Sie die Details zum Dienstkonto ein.
  6. Weisen Sie dem neuen Dienstkonto die Rolle zu, die am besten zu den Anforderungen Ihrer Anwendung passt. Die Wahl der Rolle für das Dienstkonto hat keine Auswirkungen darauf, welche Aufrufe an die Google Maps Booking API gesendet werden können Die Zuweisung von ausreichend Kontingent für die Verwendung wird stattdessen durch die Verknüpfung Ihrer Projektnummer in der Aktionscenter-Konfiguration bestimmt. Wenn Sie sich nicht sicher sind, welche Rolle Sie auswählen sollen, wählen Sie einfach „Projekt“ > „Betrachter“ aus.
  7. Nachdem Sie in Schritt 6 auf „Weiter“ geklickt haben, können Sie JSON-Schlüssel erstellen.
  8. Speichern Sie die JSON-Anmeldedaten. Bewahren Sie sie an einem sicheren Ort auf, da Sie sie später nicht mehr abrufen können.
  9. Melden Sie sich wieder im Partner-Portal an und führen Sie die verbleibenden Aufgaben auf der Seite „Onboarding-Aufgaben“ des Partner-Portals aus.

Maps Booking API aktivieren

  1. Melden Sie sich in Ihrem Google Cloud Platform-Konto an.
  2. Rufen Sie „API & Dienste > Dashboard“ auf.
  3. Klicken Sie auf APIs und Dienste aktivieren und suchen Sie nach Google Maps Booking API.
  4. Aktivieren Sie die folgenden APIs:
    • Google Maps Booking API
    • Google Maps Booking API (Entwicklerversion)

Häufige Fehler

Es gibt verschiedene Gründe, warum bei Anfragen für Echtzeit-Updates Autorisierungsprobleme auftreten können. Eine allgemeine Anleitung zum Senden von Anfragen für Echtzeit-Updates finden Sie im Abschnitt API-Updates in Echtzeit in der Anleitung zu Reservierungsangeboten. Beispielclients in mehreren Sprachen finden Sie im Abschnitt Codebeispiele.

Wenn 403-Fehler auftreten, prüfen Sie, ob Sie alle der folgenden Anforderungen erfüllen:

  1. Verwenden Sie eine Google-Clientbibliothek.
  2. Erstellen Sie OAuth-Anmeldedaten mit der Dienstkonto-Authentifizierung.
  3. Autorisieren Sie sich für den entsprechenden Bereich.
  4. Senden Sie Anfragen an den entsprechenden Endpunkt (siehe unten).

Achten Sie darauf, dass Sie Anfragen an den richtigen Endpunkt senden :

  1. Sandbox: https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
  2. Produktion: https://mapsbooking.googleapis.com/v1alpha/...

Achten Sie darauf, dass Sie Ihre OAuth-Anmeldedatenanfragen richtig autorisieren :

  1. Sie autorisieren sich für den Bereich „https://www.googleapis.com/auth/mapsbooking“.
  2. Sie verwenden den Dienstkontoschlüssel, der unter Dienstkonto und OAuth-Anmeldedaten erstellen erstellt wurde.

Treten weiterhin Fehler auf?

Wenn nach diesen Schritten weiterhin Fehler auftreten, wenden Sie sich mit den folgenden Informationen an Ihren Aktionscenter-Ansprechpartner:

  • Cloud-Projektnummer und ‑Projekt-ID mit einem Screenshot
  • Dienstkonto-ID
  • E-Mail-Adresse, die zum Erstellen des Dienstkontos verwendet wurde
  • Details zu den Endpunkten, an die Anfragen gesendet wurden
  • Zeitpunkt der Anfragen
  • Vollständige Anfragen und Fehlermeldungen, die beim Senden von Anfragen empfangen wurden