Schritt 5: API-Aktualisierungen in Echtzeit

Das Inventar in Ihrem System schwankt aufgrund neuer Buchungen im Laufe des Tages Stornierungen und Terminänderungen Ihrer Händler. Das Echtzeit-Update Die API ist ein Mechanismus, um Google über diese Änderungen am Inventar zu informieren Verfügbarkeit. Sie können auch Echtzeit-API-Updates nutzen, um Google über Änderungen an bestehenden Buchungen.

API-Aktualisierungen in Echtzeit und Feeds

API-Updates in Echtzeit werden verwendet, um Google über inkrementelle Änderungen Inventarverfügbarkeit und Buchungen in Echtzeit. Außerdem zu API-Updates in Echtzeit wechseln, senden Sie täglich vollständige Verfügbarkeitsfeeds, dass Google über die genauesten und aktuellsten Informationen zur Verfügbarkeit als in Ihrem System vorhanden ist. Vollständige Feeds dienen als Momentaufnahme der aktuellen Status der Inventarverfügbarkeit in Ihrem System.

Obwohl API-Aktualisierungen verwendet werden können, um alle Informationen zu aktualisieren, die über Feeds bereitgestellt werden, etwa Informationen zu Händlern und Dienstleistungen, werden normalerweise nur zur Aktualisierung von Verfügbarkeitsinformationen verwendet.

Erforderliche APIs für Echtzeitaktualisierungen

Echtzeitaktualisierungen über die Availability Replace API

Verwenden Sie die Availability Replace API, um Verfügbarkeitsaktualisierungen in der folgende Anwendungsfälle:

• Ein Nutzer bucht eine Reservierung in Ihrem System, daher ist der verfügbare Slot nicht nicht mehr verfügbar sind.
• Ein Händler ändert seine Verfügbarkeit in deinem System.
• Ein Nutzer bucht eine Reservierung über Google. Der verfügbare Slot ist also nicht nicht mehr verfügbar sind.
• Eine Reservierung, die über Google vorgenommen wurde, wird von Ihnen storniert, z. B. direkt vom Händler. Sie müssen die Buchung und den da der ursprüngliche Slot jetzt wieder verfügbar ist.
• Der BatchAvailabilityLookup-Aufruf des Buchungsservers wird zurückgegeben das nicht mit dem tatsächlichen Inventar übereinstimmt.

Weitere Informationen findest du unter folgenden Links:

• Anleitung: Echtzeitaktualisierungen strukturieren
• Beispiel für einen Java-Client für Echtzeitaktualisierungen mit RESTful-Aufrufen
• API-Referenzseite für die Inventaraktualisierung

Echtzeitaktualisierung für die Booking Notification API

Die Booking Notification APIs informieren Google über Aktualisierungen bestehender Buchungen. Wenn Sie eine Mitteilung zu Stornierungen senden, nur die wesentlichen Informationen in der Anfrage mit dem updateMask-Abfrageparameter an. Hier ein Beispiel:

Request:
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status

Body:
{"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"CANCELED"}

Auf die API zugreifen

Dienstkonto erstellen

Verwenden Sie den Tab Anmeldedaten in der Google API Console, um ein Dienstkonto erstellen. Privaten Schlüssel im JSON-Format an einem sicheren Ort speichern Wenn Sie das Konto erstellen, können Sie die Rolle auf „Inhaber“.

Maps Booking APIs authentifizieren

Authentifiziere nach dem Erstellen des Dienstkontos die folgenden APIs:

• Google Maps Booking API
• Google Maps Booking API (Entwicklerversion)

Eine detaillierte Anleitung dazu finden Sie im Mit der Maps Booking API authentifizieren

RESTful-Aufrufe verwenden oder die Clientbibliothek herunterladen

Wir empfehlen, RESTful-Aufrufe direkt an die Maps Booking API zu senden. mit JSON-Nutzlasten. Weitere Informationen finden Sie in der Dokumentation zur REST API

Du kannst auch Clientbibliotheken verwenden, um eine Verbindung zur API herzustellen.

Zusätzliche Informationen Supportbibliotheken stehen zum Download zur Verfügung. die Autorisierung und andere Aspekte von Aufrufen von Google APIs abwickeln. Bei Bedarf schau dir das an diesen Beispielen.

Discovery-Dokument abrufen

Bei einigen Clientbibliotheken wie z. B. Ruby ist es notwendig, die Discovery-Dokument für die API, in dem die Methoden und Parameter.

Verwenden Sie den folgenden Befehl, um das Discovery-Dokument abzurufen:

curl -s -o 'mapsbooking_rest' 'https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha'

Weitere Informationen zum Zugriff auf die API über Ruby finden Sie unter den folgenden Links: Ruby API Client und Ruby Auth Library:

Autorisierte API-Aufrufe durchführen

Beachten Sie bei API-Aufrufen Folgendes: Einen autorisierten API-Aufruf zur Autorisierung Ihres Dienstes vorbereiten -Konto mit deinem privaten Schlüssel und dem folgenden OAuth-Bereich: https://www.googleapis.com/auth/mapsbooking

API-Kontingente

Für API-Updates gilt ein Kontingent von 1.500 Anfragen alle 60 Sekunden oder 25 Anfragen. durchschnittlich pro Sekunde. Wenn ein Kontingent überschritten wird. Dies kann passieren, wenn Sie in Ihrem Partner-Portal nicht die richtige Google Cloud-Projektnummer angegeben haben. folgende Fehlermeldung:

{
  "error": {
    "code": 429,
    "message": "Insufficient tokens for quota ...",
    "status": "RESOURCE_EXHAUSTED",
    "details": [...]
  }
}

Um dies zu vermeiden, wiederholen Sie den Aufruf in exponentiell größeren Intervallen, bis dass es erfolgreich ist. Wenn Sie das Kontingent regelmäßig mit ReplaceServiceAvailability, wechseln zu Mit BatchReplaceServiceAvailabily können Sie die Anzahl der APIs reduzieren. Anrufe. Mit dieser Methode können Sie mehrere Dienste in einer einzigen API aktualisieren aufrufen.

Sandbox- und Produktionsendpunkte

Sie können Aufrufe an die Sandbox- und die Produktionsumgebung über die API verwenden. Dazu musst du beide APIs in deinem Google Cloud-Projekt aktiviert haben. Beide APIs verwenden denselben Bereich, haben aber unterschiedliche Endpunkte.

Produktionsendpunkt: https://mapsbooking.googleapis.com/

Sandbox-Endpunkt: https://partnerdev-mapsbooking.googleapis.com/

Hier siehst du anhand eines Java-Beispiels, wie Endpunkte gewechselt werden:

    // This block of code is for OAuth and is the same for prod and sandbox.
    GoogleCredential
      .fromStream(new FileInputStream(...))
      .createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))

    // This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
    new GoogleMapsBookingAPI.Builder(...)
      .setApplicationName(...)
      .setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
      .build()