Authentifizierung mit der Maps Booking API

Wenn Sie Aktualisierungen in Echtzeit vornehmen möchten, müssen Sie Anfragen an die Maps Booking API stellen. 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 ihm die erforderlichen Abfragen pro Sekunde zugewiesen wurde. Dieser Leitfaden führt Sie durch folgende Schritte:

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

Informationen dazu, wie Sie Anfragen an die API senden, finden Sie im Ende-zu-Ende-Leitfaden im Abschnitt Echtzeit-API-Updates.

Google Cloud-Projekt mit „Mit Google reservieren“ einrichten

Hinweis:Wenn Sie Ihr Partner-Portal-Konto bereits eingerichtet haben, müssen Sie das Google Cloud-Projekt verwenden, das bei der Einrichtung eingegeben wurde. Wenn du keinen Zugriff mehr auf dieses Google Cloud Platform-Projekt hast oder Hilfe bei der Identifizierung benötigst, wende dich an deinen Ansprechpartner für „Mit Google reservieren“.

1. Melden Sie sich in Ihrem Google Cloud Platform-Konto an.
2. Sie können zu diesem Zweck ein neues Projekt erstellen oder ein vorhandenes Projekt verwenden.
   • Notieren Sie sich die Nummer des Cloud-Projekts, da Sie sie in den nächsten Schritten benötigen. Ihre Cloud-Projektnummer finden Sie auch auf der Startseite der Google Cloud Platform. Die Cloud-Projektnummer ist immer numerisch.
3. Melde dich im Partner-Portal an.
4. Schließe Schritt 1 auf der Onboarding-Seite des Partner-Portals ab, indem du die Cloud-Projektnummer und die E-Mail-Adresse des Cloud-Projekts (die zum Verwalten des Cloud-Projekts verwendete E-Mail-Adresse) sendest.

Dienstkonto und OAuth-Anmeldedaten erstellen

Hinweis:Diese Schritte müssen über das Konto mit der Entwickler-E-Mail-Adresse ausgeführt werden, die in den Einrichtungsschritten eingegeben wurde.

1. Melde dich wieder in deinem Google Cloud Platform-Konto an.
2. Rufen Sie IAM & Verwaltung; Dienstkonten auf.
3. Suchen Sie nach der 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 Ihren Anwendungsanforderungen passt. Die Auswahl der Rolle für das Dienstkonto hat keinen Einfluss darauf, welche Aufrufe an die Google Maps Booking API gesendet werden können. Die Zuweisung eines ausreichenden Kontingents für deren Nutzung wird stattdessen durch die Verknüpfung Ihrer Projektnummer in der Konfiguration von „Mit Google reservieren“ bestimmt. Wenn Sie 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, erhalten Sie die Option, JSON-Schlüssel zu erstellen.
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 noch einmal im Partner-Portal an und führen Sie die restlichen 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. 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 folgende APIs:
   • Google Maps Booking API
   • Google Maps Booking API (Entwicklerversion)

Hinweis:Wenn du die Einrichtungsschritte bereits abgeschlossen hast und dein vorhandenes Cloud-Projekt auf ein neues aktualisieren möchtest, wende dich bitte an deinen Ansprechpartner für „Mit Google reservieren“.

Häufige Fehler

Es gibt verschiedene Gründe, warum beim Anfordern von Echtzeitaktualisierungen Autorisierungsprobleme auftreten können. Allgemeine Informationen zum Anfordern von Echtzeit-Updates finden Sie im Abschnitt API-Updates in Echtzeit im Ende-zu-Ende-Leitfaden. Im Abschnitt Codebeispiele finden Sie außerdem Beispielclients in mehreren Sprachen.

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

1. Verwende eine Google-Clientbibliothek.
2. Erstellen Sie OAuth-Anmeldedaten mit Dienstkonto-Authentifizierung.
3. Autorisieren Sie den Schlüssel für den entsprechenden Umfang.
4. Rufen Sie den entsprechenden Endpunkt auf (siehe unten).

Rufen Sie den richtigen Endpunkt auf:

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

Achten Sie darauf, Ihre OAuth-Anmeldedatenanfragen ordnungsgemäß zu autorisieren:

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

Werden immer noch Fehler angezeigt?

Sollten nach diesen Schritten immer noch Fehler auftreten, wende dich an deinen Ansprechpartner für „Mit Google reservieren“ und gib dabei folgende Informationen an:

• Cloud-Projektnummer und Projekt-ID mit Screenshot
• Dienstkonto-ID
• E-Mail-Adresse, die zum Erstellen des Dienstkontos verwendet wurde
• Endpunktdetails, die versucht haben, Anfragen an
• Zeitpunkt der Anfrageversuche
• Vollständige Anfrage und Fehlermeldungen bei Anfragen