Zum Inhalt springen

OBS/CloudConnect/Google API: Unterschied zwischen den Versionen

Aus OBS Wiki
Rademacker (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
MINERVA-Thiel (Diskussion | Beiträge)
Seite neu geschrieben nach Styleguide [Volltext ersetzt]
 
(13 dazwischenliegende Versionen von 3 Benutzern werden 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.}}
 


==Vorbereiten des Google-Kontos==
== Voraussetzungen ==
* Ein Google-Konto, über das der Zugang verwaltet wird. Am besten legen Sie dafür ein eigenes Konto für Ihre Firma an.


Leider ändert Google häufiger das Aussehen und die Beschreibungen der einzelnen Punkte.
{{Hinweis|Google ändert die Oberfläche der Cloud Console häufig. Heißen Menüpunkte bei Ihnen anders, sprechen Sie uns gerne an.}}
Daher ist die Beschreibung etwas allgemeiner gehalten. Bei Problemen bitte nachfragen.


# Anlegen eines Google-Kontos soweit noch nicht vorhanden (google.de)
== Vorgehen ==
# Aufruf der Entwickler-Konsole auf https://console.developers.google.com/
=== Zugang bei Google anlegen ===
# Dort den '''API-Manager''' öffnen
{{Schritte|1=
# Beim ersten Zugriff muss ein Projekt angelegt werden (beliebiger Name, z.B. "OBSZugang")
# Ö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.
# In der Übersicht die gewünschte API suchen: "Google Calendar API"
# Legen Sie beim ersten Aufruf ein Projekt an, z.B. ''OBSZugang''.
# API auswählen und aktivieren
# Wählen Sie '''APIs & Dienste''' und klicken Sie auf '''APIs und Dienste aktivieren'''.
# Verwaltung der API aufrufen
# Suchen und aktivieren Sie die APIs, die Sie brauchen:
# Unter '''Anmeldedaten''' den Punkt '''neue Anmeldedaten''' wählen, dann '''OAuth-Client-ID'''
#* für den Google-Kalender: ''Google Calendar API''
# Anwendungstyp '''Sonstige''', beliebige Bezeichnung wählen (z.B. "OBS")
#* für E-Mail: ''Gmail API''
# Erstellen
#* für Karten und Tourenplanung: ''Routes API'', ''Geocoding API'' und ''Maps JavaScript API''
# Es erscheint ein neues Fenster mit '''Client-ID''' und '''Clientschlüssel''', beides merken
# 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.
}}


{{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''.}}


==Einrichtung der Google-API in OBS==
=== Zugang in OBS eintragen (Kalender und E-Mail) ===
{{Schritte|1=
# Öffnen Sie '''Stammdaten → Z Weitere Stammdaten → Cloud Connect''' und legen Sie mit {{Einfg}} einen neuen Eintrag an.
# Wählen Sie bei '''Cloud Typ''' ''Google API'' und vergeben Sie einen '''Titel'''.
# Tragen Sie bei '''Login''' die Client-ID und bei '''Passwort''' den Clientschlüssel ein.
# Sichern Sie mit {{F2}}.
}}


# Liste Cloud-Connect öffnen (Menü Stammdaten \ Z Weitere Stammdaten \ Cloud Connect)
=== Schlüssel in OBS eintragen (Karten und Tourenplanung) ===
# Neuen Datensatz erstellen (Einf.)
Tragen Sie den API-Schlüssel unter '''Stammdaten → Programmparameter''', {{F10}}, '''Google/Microsoft Parameter''' ein.
# 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


Die neue Google-API kann jetzt für die Einrichtung für Google-Zugänge genutzt werden.
{{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 [[OBS/CloudConnect/Google Kalender|Google-Kalender-Konto]] auf der Registerkarte '''Kalender''' im Feld '''Google API'''.


== Siehe auch ==
* [[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