Zum Inhalt springen

OBS/CloudConnect/Google API: Unterschied zwischen den Versionen

Aus OBS Wiki
Thiel (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
MINERVA-Thiel (Diskussion | Beiträge)
Seite neu geschrieben nach Styleguide [Volltext ersetzt]
 
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 1: Zeile 1:
{{Vorlage:CloudConnect}}
{{Vorlage:CloudConnect}}
{{Seitentyp|Anleitung}}
= Google API =


=Einrichtung: Google-API Zugang=
Damit OBS auf Google zugreifen kann, z.B. für den Google-Kalender oder Gmail, brauchen Sie einmalig einen Zugang zur Google API. Ein einziger Zugang genügt für beliebig viele Google-Konten.
 
Anleitung zur Einrichtung eines Google-API-Zugangs. Der Zugang ist nötig um mit OBS auf Google-Konten zugreifen zu können (z.B. Kalender).


{{Hinweis|Es muss nur einmalig ein API-Zugang eingerichtet werden um beliebige Google-Konten mit OBS zu synchronisieren. Es bietet sich daher an ein Google-Konto für die Firma anzulegen dessen API dann aktiviert wird.}}
== Voraussetzungen ==
* Ein Google-Konto, über das der Zugang verwaltet wird. Am besten legen Sie dafür ein eigenes Konto für Ihre Firma an.


{{Hinweis|Google ändert die Oberfläche der Cloud Console häufig. Heißen Menüpunkte bei Ihnen anders, sprechen Sie uns gerne an.}}


==Vorbereiten des Google-Kontos==
== Vorgehen ==
=== Zugang bei Google anlegen ===
{{Schritte|1=
# Öffnen Sie die Google Cloud Console unter [https://console.developers.google.com/ console.developers.google.com] und melden Sie sich mit dem Google-Konto an.
# Legen Sie beim ersten Aufruf ein Projekt an, z.B. ''OBSZugang''.
# Wählen Sie '''APIs & Dienste''' und klicken Sie auf '''APIs und Dienste aktivieren'''.
# Suchen und aktivieren Sie die APIs, die Sie brauchen:
#* für den Google-Kalender: ''Google Calendar API''
#* für E-Mail: ''Gmail API''
#* für Karten und Tourenplanung: ''Routes API'', ''Geocoding API'' und ''Maps JavaScript API''
# Für Kalender und E-Mail wählen Sie unter '''Anmeldedaten''' den Punkt '''Anmeldedaten erstellen''' und dann '''OAuth-Client-ID'''. Wählen Sie als Anwendungstyp ''Desktopanwendung'' und vergeben Sie eine Bezeichnung, z.B. ''OBS''.
# Google zeigt '''Client-ID''' und '''Clientschlüssel'''. Notieren Sie beide.
# Für Karten und Tourenplanung wählen Sie unter '''Anmeldedaten erstellen''' stattdessen '''API-Schlüssel''' und notieren den Schlüssel.
}}


Leider ändert Google häufiger das Aussehen und die Beschreibungen der einzelnen Punkte.
{{Hinweis|Die ''Directions API'' unterstützt OBS seit der Version vom 12.02.2025 nicht mehr, weil Google sie abgekündigt hat. Verwenden Sie stattdessen die ''Routes API''.}}
Daher ist die Beschreibung etwas allgemeiner gehalten. Bei Problemen bitte nachfragen.


# Anlegen eines Google-Kontos soweit noch nicht vorhanden (google.de)
=== Zugang in OBS eintragen (Kalender und E-Mail) ===
# Aufruf der Entwickler-Konsole auf https://console.developers.google.com/
{{Schritte|1=
# Dort den API-Manager öffnen (Menüpunkt "APIs & Dienste")
# Öffnen Sie '''Stammdaten → Z Weitere Stammdaten → Cloud Connect''' und legen Sie mit {{Einfg}} einen neuen Eintrag an.
# Beim ersten Zugriff muss ein Projekt angelegt werden (beliebiger Name, z.B. "OBSZugang")
# Wählen Sie bei '''Cloud Typ''' ''Google API'' und vergeben Sie einen '''Titel'''.
# Über den Schalter "APIs und Dienste aktivieren" gelangen Sie zur Übersicht der zur Verfügung stehenden APIs
# Tragen Sie bei '''Login''' die Client-ID und bei '''Passwort''' den Clientschlüssel ein.
#* In der Übersicht die gewünschte API suchen und aktivieren:
# Sichern Sie mit {{F2}}.
#** OBS Google Kalender
}}
#*** "Google Calendar API"
#** OBS Maps/Tourenplanung
#*** ''"Directions API"'' '''ab OBS Version vom 12.02.2025 nicht mehr unterstützt, da von Google abgekündigt. Alle Informationen [https://developers.google.com/maps/billing-and-pricing/faq?utm_medium=MSA&utm_source=Customer_MSA&utm_campaign=Jan_25&utm_content=FAQ&utm_term=Reminder&hl=de#legacy hier.]'''
#*** "Routen API" (ersetzt die Directions API'')''
#*** "Geocoding API"
#*** "Maps JavaScript API"
#** OBS Mail
#*** "GMail API"
# Unter '''Anmeldedaten''' den Punkt '''Anmeldedaten''' '''erstellen''' wählen,
#* Für "Google Calendar API" und "GMail API"
#*# wählen Sie '''OAuth-Client-ID'''
#*# Anwendungstyp '''Desktopanwendung''', beliebige Bezeichnung wählen (z.B. "OBS")
#*# Erstellen
#*# Es erscheint ein neues Fenster mit '''Client-ID''' und '''Clientschlüssel''', beides merken
#* Für "Maps/Tourenplanung"
#*# wählen Sie '''API Schlüssel'''


==Einrichtung der Google-API in OBS==
=== Schlüssel in OBS eintragen (Karten und Tourenplanung) ===
Tragen Sie den API-Schlüssel unter '''Stammdaten → Programmparameter''', {{F10}}, '''Google/Microsoft Parameter''' ein.


* Für "Google Calendar API" und "GMail API"
{{Achtung|Starten Sie OBS nach dem Eintragen eines neuen Schlüssels neu. Erst dann wird er verwendet.}}
# Liste Cloud-Connect öffnen (Menü Stammdaten \ Z Weitere Stammdaten \ Cloud Connect)
# Neuen Datensatz erstellen (Einf.)
# Als Typ '''Google API''' wählen
# Beliebigen Titel wählen
# Unter Login die '''Client-ID''' eintragen
# Unter Passwort den '''Clientschlüssel''' eintragen
# Mit F2 speichern


* Für "Maps/Tourenplanung"
== Ergebnis ==
Den Eintrag vom Typ ''Google API'' wählen Sie in jedem [[OBS/CloudConnect/Google Kalender|Google-Kalender-Konto]] auf der Registerkarte '''Kalender''' im Feld '''Google API'''.


# Den API-Key müssen Sie unter:  [Stammdaten] → [Programmparameter] → [F10] → [Google/Microsoft Parameter] einpflegen
== Siehe auch ==
{{Achtung|OBS muss nach der Neueingabe eines Keys '''zwingend''' neu gestartet werden!}}
* [[OBS/CloudConnect/Google Kalender|Google Kalender]]
* [[OBS/CloudConnect/OAuth2|OAuth2-Authentifizierung]]
* [[OBS/CloudConnect/Übersicht|Cloud-Schnittstellen]]

Aktuelle Version vom 2. Oktober 2026, 08:35 Uhr

Google API

Damit OBS auf Google zugreifen kann, z.B. für den Google-Kalender oder Gmail, brauchen Sie einmalig einen Zugang zur Google API. Ein einziger Zugang genügt für beliebig viele Google-Konten.

Voraussetzungen

  • Ein Google-Konto, über das der Zugang verwaltet wird. Am besten legen Sie dafür ein eigenes Konto für Ihre Firma an.
HINWEIS: Google ändert die Oberfläche der Cloud Console häufig. Heißen Menüpunkte bei Ihnen anders, sprechen Sie uns gerne an.

Vorgehen

Zugang bei Google anlegen

  1. Öffnen Sie die Google Cloud Console unter console.developers.google.com und melden Sie sich mit dem Google-Konto an.
  2. Legen Sie beim ersten Aufruf ein Projekt an, z.B. OBSZugang.
  3. Wählen Sie APIs & Dienste und klicken Sie auf APIs und Dienste aktivieren.
  4. Suchen und aktivieren Sie die APIs, die Sie brauchen:
    • für den Google-Kalender: Google Calendar API
    • für E-Mail: Gmail API
    • für Karten und Tourenplanung: Routes API, Geocoding API und Maps JavaScript API
  5. Für Kalender und E-Mail wählen Sie unter Anmeldedaten den Punkt Anmeldedaten erstellen und dann OAuth-Client-ID. Wählen Sie als Anwendungstyp Desktopanwendung und vergeben Sie eine Bezeichnung, z.B. OBS.
  6. Google zeigt Client-ID und Clientschlüssel. Notieren Sie beide.
  7. Für Karten und Tourenplanung wählen Sie unter Anmeldedaten erstellen stattdessen API-Schlüssel und notieren den Schlüssel.
HINWEIS: Die Directions API unterstützt OBS seit der Version vom 12.02.2025 nicht mehr, weil Google sie abgekündigt hat. Verwenden Sie stattdessen die Routes API.

Zugang in OBS eintragen (Kalender und E-Mail)

  1. Öffnen Sie Stammdaten → Z Weitere Stammdaten → Cloud Connect und legen Sie mit Einfg einen neuen Eintrag an.
  2. Wählen Sie bei Cloud Typ Google API und vergeben Sie einen Titel.
  3. Tragen Sie bei Login die Client-ID und bei Passwort den Clientschlüssel ein.
  4. Sichern Sie mit F2.

Schlüssel in OBS eintragen (Karten und Tourenplanung)

Tragen Sie den API-Schlüssel unter Stammdaten → Programmparameter, F10, Google/Microsoft Parameter ein.

ACHTUNG: Starten Sie OBS nach dem Eintragen eines neuen Schlüssels neu. Erst dann wird er verwendet.

Ergebnis

Den Eintrag vom Typ Google API wählen Sie in jedem Google-Kalender-Konto auf der Registerkarte Kalender im Feld Google API.

Siehe auch