OBS/CloudConnect/GoogleAPI: Unterschied zwischen den Versionen

Aus OBS Wiki
Zur Navigation springen Zur Suche springen
Rademacker (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
Thiel (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
 
(12 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 13: Zeile 13:
Leider ändert Google häufiger das Aussehen und die Beschreibungen der einzelnen Punkte.
Leider ändert Google häufiger das Aussehen und die Beschreibungen der einzelnen Punkte.
Daher ist die Beschreibung etwas allgemeiner gehalten. Bei Problemen bitte nachfragen.
Daher ist die Beschreibung etwas allgemeiner gehalten. Bei Problemen bitte nachfragen.
# Es wird ein Google-Konto benötigt, bitte anlegen wenn noch nicht vorhanden
# Aufruf der Entwickler-Konsole über https://console.developers.google.com/
# Anlegen eines Google-Kontos soweit noch nicht vorhanden (google.de)
# Aufruf der Entwickler-Konsole auf https://console.developers.google.com/
# Dort den '''API-Manager''' öffnen
# Beim ersten Zugriff muss ein Projekt angelegt werden (beliebiger Name, z.B. "OBSZugang")
# In der Übersicht die gewünschte API suchen: "Google Calendar API"
# API auswählen und aktivieren
# Verwaltung der API aufrufen
# Unter '''Anmeldedaten''' den Punkt '''neue Anmeldedaten''' wählen, dann '''OAuth-Client-ID'''
# Anwendungstyp '''Sonstige''', beliebige Bezeichnung wählen (z.B. "OBS")
# Erstellen
# Es erscheint ein neues Fenster mit '''Client-ID''' und '''Clientschlüssel''', beides merken
==Einrichtung der Google-API in OBS==
# 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
Die neue Google-API kann jetzt für die Einrichtung für Google-Zugänge genutzt werden.
==Vorbereiten des Google-Kontos==


# Anlegen eines Google-Kontos soweit noch nicht vorhanden (google.de)
# Anlegen eines Google-Kontos soweit noch nicht vorhanden (google.de)
# Aufruf der Entwickler-Konsole auf https://console.developers.google.com/
# Aufruf der Entwickler-Konsole auf https://console.developers.google.com/
# Dort den '''API-Manager''' öffnen
# Dort den API-Manager öffnen (Menüpunkt "APIs & Dienste")
# Beim ersten Zugriff muss ein Projekt angelegt werden (beliebiger Name, z.B. "OBSZugang")
# Beim ersten Zugriff muss ein Projekt angelegt werden (beliebiger Name, z.B. "OBSZugang")
# In der Übersicht muss jetzt die gewünschte API aktiviert werden
# Über den Schalter "APIs und Dienste aktivieren" gelangen Sie zur Übersicht der zur Verfügung stehenden APIs
## Als Beispiel: '''Calendar API''' unter '''Google Apps APIs''' auswählen
#* In der Übersicht die gewünschte API suchen und aktivieren:
## API per Klick aktivieren
#** OBS Google Kalender
# Im Menü den Punkt "Zugangsdaten" auswählen
#*** "Google Calendar API"
# Unter '''Anmeldedaten''' den Punkt '''neue Anmeldedaten''' wählen, dann '''OAuth-Client-ID'''
#** OBS Maps/Tourenplanung
# Anwendungstyp '''Sonstige''', beliebige Bezeichnung wählen (z.B. "OBS")
#*** ''"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.]'''
# Erstellen
#*** "Routen API" (ersetzt die Directions API'')''
# Es erscheint ein neues Fenster mit '''Client-ID''' und '''Clientschlüssel''', beides merken
#*** "Geocoding API"
 
#*** "Maps JavaScript API"
Videoanleitung:
#** OBS Mail
 
#*** "GMail API"
<html5media width="720" height="480">File:Gapi_einrichtung.mp4</html5media> <br/>
# 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==
==Einrichtung der Google-API in OBS==


* Für "Google Calendar API" und "GMail API"
# Liste Cloud-Connect öffnen (Menü Stammdaten \ Z Weitere Stammdaten \ Cloud Connect)
# Liste Cloud-Connect öffnen (Menü Stammdaten \ Z Weitere Stammdaten \ Cloud Connect)
# Neuen Datensatz erstellen (Einf.)
# Neuen Datensatz erstellen (Einf.)
Zeile 80: Zeile 49:
# Mit F2 speichern
# Mit F2 speichern


Die neue Google-API kann jetzt für die Einrichtung für Google-Zugänge genutzt werden.
* Für "Maps/Tourenplanung"
 


# Den API-Key müssen Sie unter:  [Stammdaten] → [Programmparameter] → [F10] → [Google/Microsoft Parameter] einpflegen
{{Achtung|OBS muss nach der Neueingabe eines Keys '''zwingend''' neu gestartet werden!}}

Aktuelle Version vom 18. Februar 2025, 20:03 Uhr

HINWEIS: Bitte beachten sie dass für den Betrieb der Schnittstelle der Cloud-Dienst in OBS aktiviert sein muss.


Einrichtung: Google-API Zugang

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

Leider ändert Google häufiger das Aussehen und die Beschreibungen der einzelnen Punkte. Daher ist die Beschreibung etwas allgemeiner gehalten. Bei Problemen bitte nachfragen.

  1. Anlegen eines Google-Kontos soweit noch nicht vorhanden (google.de)
  2. Aufruf der Entwickler-Konsole auf https://console.developers.google.com/
  3. Dort den API-Manager öffnen (Menüpunkt "APIs & Dienste")
  4. Beim ersten Zugriff muss ein Projekt angelegt werden (beliebiger Name, z.B. "OBSZugang")
  5. Über den Schalter "APIs und Dienste aktivieren" gelangen Sie zur Übersicht der zur Verfügung stehenden APIs
    • In der Übersicht die gewünschte API suchen und aktivieren:
      • 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 hier.
        • "Routen API" (ersetzt die Directions API)
        • "Geocoding API"
        • "Maps JavaScript API"
      • OBS Mail
        • "GMail API"
  6. Unter Anmeldedaten den Punkt Anmeldedaten erstellen wählen,
    • Für "Google Calendar API" und "GMail API"
      1. wählen Sie OAuth-Client-ID
      2. Anwendungstyp Desktopanwendung, beliebige Bezeichnung wählen (z.B. "OBS")
      3. Erstellen
      4. Es erscheint ein neues Fenster mit Client-ID und Clientschlüssel, beides merken
    • Für "Maps/Tourenplanung"
      1. wählen Sie API Schlüssel

Einrichtung der Google-API in OBS

  • Für "Google Calendar API" und "GMail API"
  1. Liste Cloud-Connect öffnen (Menü Stammdaten \ Z Weitere Stammdaten \ Cloud Connect)
  2. Neuen Datensatz erstellen (Einf.)
  3. Als Typ Google API wählen
  4. Beliebigen Titel wählen
  5. Unter Login die Client-ID eintragen
  6. Unter Passwort den Clientschlüssel eintragen
  7. Mit F2 speichern
  • Für "Maps/Tourenplanung"
  1. Den API-Key müssen Sie unter: [Stammdaten] → [Programmparameter] → [F10] → [Google/Microsoft Parameter] einpflegen
ACHTUNG: OBS muss nach der Neueingabe eines Keys zwingend neu gestartet werden!