Öffnungszeiten von Google auf der Webseite anzeigen

Weg 1 · Kostenlos

Google Business Profile API: gratis, aber mit Vollzugriff

Diese API kostet keine Nutzungsgebühr. Der Haken: Du autorisierst deine eigene App per OAuth, dein Profil komplett zu lesen und zu verwalten („business.manage“) – und Google muss dir den Zugang erst freischalten. Dafür liest du die Zeiten direkt aus deinem eigenen Unternehmensprofil, ganz ohne laufende Kosten. Am besten geeignet, wenn du das Profil selbst verwaltest und kein Budget für API-Calls ausgeben willst.

So richtest du den Zugang ein

1. 1. Voraussetzungen prüfen. Du brauchst ein bestätigtes Google-Unternehmensprofil (idealerweise 60+ Tage aktiv), eine echte Firmen-Website und das Google-Konto, das das Profil verwaltet.
2. 2. Google-Cloud-Projekt anlegen. Erstelle ein Projekt und aktiviere die Business Profile APIs (Account Management und Business Information).
3. 3. Zugriff beantragen. Fülle das Formular „Application for Basic API Access“ aus. Wichtig: Neue Projekte haben Kontingent 0 – ohne Freigabe bekommst du keine Daten. Die Prüfung dauert Tage bis Wochen.
4. 4. OAuth einrichten. Konfiguriere den OAuth-Zustimmungsbildschirm, erstelle eine OAuth-Client-ID, autorisiere einmal mit dem Scope business.manage und sichere den Refresh-Token serverseitig.
5. 5. Öffnungszeiten abrufen. Lies die Zeiten deiner Location mit einer readMask – so bekommst du nur das Feld regularHours.

{
  "regularHours": {
    "periods": [
      { "openDay": "MONDAY",  "openTime": { "hours": 9 },
        "closeDay": "MONDAY",  "closeTime": { "hours": 18 } },
      { "openDay": "TUESDAY", "openTime": { "hours": 9 },
        "closeDay": "TUESDAY", "closeTime": { "hours": 18 } }
    ]
  }
}

Erstelle eine serverseitige Integration für meine Website, die die
Öffnungszeiten aus MEINEM eigenen Google-Unternehmensprofil über die
Google Business Profile API holt und anzeigt.

Vorgaben:
- Auth: OAuth 2.0 mit dem Scope https://www.googleapis.com/auth/business.manage.
  Nutze einen serverseitig gespeicherten Refresh-Token, um Access-Tokens zu
  erneuern. Keine Tokens im Frontend.
- Öffnungszeiten lesen:
  GET https://mybusinessbusinessinformation.googleapis.com/v1/LOCATION_NAME?readMask=regularHours,title
  (LOCATION_NAME sieht aus wie "locations/0123456789".)
- Die Antwort enthält regularHours.periods mit openDay, openTime {hours, minutes},
  closeDay und closeTime. Wandle das in lesbare deutsche Zeilen pro Wochentag um
  (z. B. "Montag: 09:00–18:00", pro Tag zusammengefasst).
- Ergebnis 24 Stunden serverseitig cachen und serverseitig rendern.
- Fallback anzeigen, wenn die API nicht erreichbar ist.

Frag mich nach LOCATION_NAME, Client-ID, Client-Secret und Refresh-Token und
erkläre mir, wo ich sie einsetze.

Weg 2 · Schnell

Google Places API: in 1–2 Stunden online, nur ein API-Key

Die Places API braucht keine langwierige Freigabe – nur einen API-Key und die Place ID deines Betriebs. Praktischer Bonus: Sie liefert die Zeiten mit languageCode=de schon als fertige deutsche Zeilen. Der einzige Haken: Du brauchst ein Google-Cloud-Konto mit Kreditkarte, weil Öffnungszeiten in der kostenpflichtigen „Pro“-Stufe liegen.

So richtest du es ein

1. 1. Place ID finden. Jeder Google-Ort hat eine eindeutige Place ID. Über sie fragst du später genau deinen Standort ab (Googles „Place ID Finder“ hilft).
2. 2. Projekt + Billing aktivieren. Lege ein Google-Cloud-Projekt an, aktiviere die „Places API (New)“ und hinterlege eine Kreditkarte (Billing).
3. 3. API-Key erstellen und einschränken. Beschränke den Key so eng wie möglich – auf die Places API und auf deinen Server. So kann ihn niemand missbrauchen.
4. 4. Place Details mit Field Mask abrufen. Die Field Mask sorgt dafür, dass du nur die nötigen Felder lädst – das hält die Kosten niedrig.
5. 5. Serverseitig cachen. Frag Google nicht bei jedem Seitenaufruf neu. Ein 24-Stunden-Cache spart Kosten, macht die Seite schnell und schützt vor Ausfällen.

curl -X GET \
  -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: displayName,regularOpeningHours,currentOpeningHours,googleMapsUri" \
  "https://places.googleapis.com/v1/places/PLACE_ID?languageCode=de"

{
  "regularOpeningHours": {
    "openNow": true,
    "weekdayDescriptions": [
      "Montag: 09:00–18:00",
      "Dienstag: 09:00–18:00",
      "Mittwoch: 09:00–18:00",
      "Donnerstag: 09:00–18:00",
      "Freitag: 09:00–18:00",
      "Samstag: 10:00–14:00",
      "Sonntag: Geschlossen"
    ]
  }
}

Erstelle eine serverseitige Funktion (z. B. eine API-Route oder Cloud Function)
für meine Website, die die aktuellen Öffnungszeiten meines Betriebs aus der
Google Places API (New) holt und anzeigt.

Vorgaben:
- Anfrage: GET https://places.googleapis.com/v1/places/PLACE_ID?languageCode=de
- Header: "X-Goog-Api-Key: API_KEY" und
  "X-Goog-FieldMask: regularOpeningHours,currentOpeningHours,displayName,googleMapsUri"
- Den API-Key NUR serverseitig verwenden, niemals im HTML/Frontend sichtbar machen.
- Die Antwort 24 Stunden serverseitig zwischenspeichern (cachen), damit nicht bei
  jedem Seitenaufruf eine Anfrage an Google geht – das spart Kosten.
- Aus der Antwort das Feld regularOpeningHours.weekdayDescriptions nehmen
  (enthält bereits fertige deutsche Zeilen wie "Montag: 09:00–18:00") und als
  saubere Liste oder Tabelle ausgeben.
- currentOpeningHours.openNow nutzen, um "Jetzt geöffnet" / "Geschlossen" anzuzeigen.
- Wenn Google nicht erreichbar ist, die zuletzt gecachten Zeiten oder einen
  freundlichen Hinweis zeigen – niemals eine leere Seite oder Fehlermeldung.
- Die Zeiten serverseitig rendern (gut für Google), nicht erst per JavaScript
  im Browser nachladen.

Ersetze PLACE_ID und API_KEY durch meine Werte und erkläre mir kurz, wo ich
beide einsetze.

Ohne Technik

Kein API-Stress: ein iFrame mit denselben Öffnungszeiten

Beide API-Wege sind machbar – aber wenn dir das alles zu viel ist, gibt es eine Abkürzung ohne Cloud-Projekt, ohne API-Key und ohne Caching. Käufer von ÖffnungszeitenDisplay.de bekommen ein fertiges iFrame für die eigene Website. Es zeigt dieselben Öffnungszeiten wie das digitale Schild im Schaufenster – du pflegst die Zeiten also nur an einer Stelle.

Mit optionalem Google Sync lässt sich diese Anzeige zusätzlich mit deinen Google-Öffnungszeiten verbinden. Dann hängen Google, Website und Schaufenster am selben Aktualisierungsprozess statt an drei getrennten Baustellen.

Drei typische Fehler

• Google-Seiten scrapen. Bricht schnell, ist schwer wartbar und verstößt gegen die Richtlinien. Immer die offiziellen APIs nutzen.
• API-Key oder Token im Frontend. Schlüssel und OAuth-Tokens gehören auf den Server – sonst kann sie jeder aus dem Quelltext kopieren und auf deine Kosten nutzen.
• Zeiten nur clientseitig nachladen. Für Besucher okay, für SEO und Tempo schwächer. Besser serverseitig gerendert oder statisch gecacht.

Was ist mit Feiertagen und Sonderzeiten?

Genau hier entscheidet sich, ob die Integration im Alltag trägt. Regelzeiten sind einfach. Feiertage, Urlaub, Inventur oder kurzfristige Änderungen sind der eigentliche Stresstest. Wenn du Google-Daten übernimmst, muss klar sein, welche Quelle gewinnt: Google, dein CMS oder dein internes System.

Für die Website ist oft ein Mix am besten: Regelzeiten automatisch, Sonderhinweise aber sofort sichtbar ausspielen. Für den Aushang im Laden hilft zusätzlich unsere kostenlose Öffnungszeiten-Schild-Vorlage. Welche Schild-Art sich fürs Schaufenster eignet, vergleicht der Ratgeber zum digitalen Öffnungszeitenschild.

Offizielle Google-Quellen

• Places API: Place Details
• Places API: Nutzung und Abrechnung
• Business Profile API: Voraussetzungen & Zugriff beantragen
• Business Profile API: Locations & regularHours

Häufige Fragen