Mit der Maps Booking API authentifizieren

Wenn du Aktualisierungen in Echtzeit vornehmen möchtest, musst du Anfragen an die Maps Booking API senden. Für die Maps Booking API musst du deine Anfragen über OAuth 2.0 mit einem GCP-Dienstkonto authentifizieren, das Zugriff auf die API hat und ihm die erforderlichen Abfragen pro Sekunde zugewiesen wurde. Dieser Leitfaden führt Sie durch die folgenden Schritte:

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

Informationen zum Senden von Anfragen an die API findest du im Abschnitt zu Echtzeit-API-Updates des End-to-End-Leitfadens für Termine.

Google Cloud-Projekt mit dem Actions Center einrichten

  1. Melden Sie sich in Ihrem Google Cloud Platform-Konto an.
  2. Sie können ein neues Projekt erstellen oder ein vorhandenes Projekt für diesen Zweck verwenden.
    • Notieren Sie sich die Cloud-Projektnummer, da Sie diese in den nächsten Schritten benötigen. Die Nummer Ihres Cloud-Projekts finden Sie auch auf der Startseite der Google Cloud Platform. Die Cloud-Projektnummer besteht immer nur aus Ziffern.
  3. Melden Sie sich im Partner-Portal an.
  4. Schließen Sie Schritt 1 auf der Seite „Onboarding Tasks“ des Partner-Portals ab. Senden Sie dazu die Cloud-Projektnummer und die Cloud-Projekt-E-Mail-Adresse (die E-Mail-Adresse zur Verwaltung des Cloud-Projekts).

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 der ID Ihres bestehenden oder neu erstellten Cloud-Projekts.
  4. Erstellen Sie ein Dienstkonto.
  5. Füllen Sie die Dienstkontodetails aus.
  6. Weisen Sie dem neuen Dienstkonto die Rolle zu, die für Ihre Anwendung am besten geeignet ist. Die Auswahl der Rolle für das Dienstkonto hat keinen Einfluss darauf, welche Aufrufe an die Google Maps Booking API gesendet werden können, da die Zuordnung eines ausreichenden Kontingents für die Nutzung durch die Verknüpfung Ihrer Projektnummer in der Actions Center-Konfiguration bestimmt wird. Wenn Sie nicht sicher sind, welche Rolle Sie wählen sollen, wählen Sie einfach „Projekt“ > „Betrachter“ aus.
  7. Nachdem Sie in Schritt 6 auf „Weiter“ geklickt haben, wird eine Option zum Erstellen von JSON-Schlüsseln angezeigt.
  8. Speichern Sie die JSON-Anmeldedaten. Bewahren Sie diese 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 Tasks (Onboarding-Aufgaben) des Partner-Portals aus.

MapsBooking API aktivieren

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

Häufige Fehler

Autorisierungsprobleme beim Senden von Echtzeitaktualisierungen können verschiedene Ursachen haben. Allgemeine Informationen zu Anfragen für Echtzeitaktualisierungen finden Sie im Abschnitt zu Echtzeit-API-Updates des End-to-End-Leitfadens für Termine. Im Abschnitt Codebeispiele finden Sie Beispielclients in mehreren Sprachen.

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

  1. Verwenden Sie eine Google-Clientbibliothek.
  2. Erstellen Sie OAuth-Anmeldedaten mit der Dienstkontoauthentifizierung.
  3. Führen Sie die Autorisierung über den entsprechenden Bereich durch.
  4. Rufen Sie den entsprechenden Endpunkt auf (siehe unten).

Prüfen Sie, ob Sie Aufrufe 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-Anmeldedaten richtig autorisieren:

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

Werden weiterhin Fehler angezeigt?

Sollten weiterhin Fehler auftreten, nachdem Sie diese Schritte ausgeführt haben, wenden Sie sich mit den folgenden Informationen an Ihren Actions Center-Ansprechpartner:

  • Cloud-Projektnummer und Projekt-ID mit einem Screenshot
  • Dienstkonto-ID
  • E-Mail-Adresse, die zum Erstellen des Dienstkontos verwendet wurde
  • Endpunktdetails, für die Anfragen gesendet werden sollen
  • Zeitpunkt der Anfrageversuche
  • Beim Senden von Anfragen erhaltene vollständige Anfrage- und Fehlermeldungen.