Google Cloud API

Beginnend mit der Version 20.1 können verschiedene Google Dienste aus Xentral angesprochen werden. Google Cloud Print, Google Kalender und Google Mail
 

Voraussetzungen & Vorgehensweise


In diesem Artikel wird die erstmalige Einrichtung der Google API beschrieben. Diese muss einmalig durchgeführt werden und besteht aus den folgenden Schritten:
Anschließend können z.B. Google Cloud Drucker angebunden werden. Für weitere Infos weiter im Artikel lesen.
 

Google API-Account anlegen

Loggen Sie sich zunächst in Ihren Google Account ein. Rufen Sie dan im selben Browser die Seite https://console.cloud.google.com auf.

Anschließend sind drei Schritte notwendig, die wir im Folgenden genauer beschrieben haben. Dabei können Sie die Eingabewerte gerne - soweit sie beliebig sind - auch übernehmen. Passen Sie bitte die URLs sorgfältig an.

Nun folgen die ersten drei Schritte 

Neues Projekt anlegen

Bi der ersten Verwendung müssen Sie zunächst den Google Cloud-Nutzungsbedingungen zustimmen.

Klicken Sie dann auf das Projekt-DropDown oben und legen Sie dort ein Neues Projekt an.



Sie können einen beliebigen Namen eingeben oder den aus unserem Beispiel verwenden. Klicken Sie im Anschluß daran auf Erstellen.



Es dauert eine Weile bis das Projekt erstellt wird.



Anschließend können Sie das Projekt gleich durch durch Klicken auswählen.


 

Neuen Zustimmungsbildschirm anlegen

Sobald Sie das Projekt ausgewählt haben, können Sie Anmeldedaten anklicken um einen neuen Zugang anzulegen. Wählen Sie dazu bitte die Option OAuth-Client-ID.



Beim ersten Durchlauf müssen Sie dazu zunächst einen neuen Zustimmungsbildschirm konfigurieren, dieser Prozess ist auch beim Anlegen mehrerer API-Zugänge nur einmal notwendig.

Klicken Sie dazu bitte auf den Button Zustimmungsbildschirm konfigurieren.

Sie können einen beliebige Namen verwenden oder unserer Textvorschlag verwenden. Der Upload eines Logos ist optional.



Nun kommen wichtige Einstellungen in denen Sie auf fehlerfreie Eingabe achten sollten:
Sie bekommen angezeigt, wenn der Zustimmungsbildschirm erfolgreich konfiguriert wurde.


 

API-Zugang anlegen

Im Anschluß an die Erstellung des Zustimmungsbildschirms werden Sie zu der Seite weitergeleitet auf der Sie den eigentlichen API-Zugang anlegen können.

Wählen Sie bitte unter Anwendungstyp die Option Webanwendung.Tragen Sie bitte unter Name einen beliebigen Namen oder unseren Textvorschlag ein.



Den letzten einzufüllenden Wert, die Autorisierte Weiterleitungs-URI erhalten Sie im folgenden Schritt aus Xentral.

Lassen Sie daher das Browserfenster hier geöffnet und wechseln Sie in einem anderen Tab oder Fenster in ihre Xentral-Instanz. 

Google Kalender API aktivieren

Um die Synchronisation des Google Kalenders mit Xentral zu ermöglichen muss vorher die Google Calendar API explizit aktiviert werden.

Wechseln Sie dazu ins Dashboard und klicken Sie auf "APIS UND DIENSTE AKTIVIEREN"

Suchen Sie nach dem englischen Begriff "calendar" und wählen Sie die "Google Calendar API" aus.



Auf der Nächsten Seite klicken Sie auf "Aktivieren".


 

API-Zugang in Xentral konfigurieren

Navigieren Sie in den Xentral AppStore und suchen dort nach "Google". Sie finden die App Google API, die SIe bitte aus dem App-Store starten.

Legen Sie dort einen neuen Eintrag an, indem Sie auf den Button "Neu" klicken.

Füllen Sie zunächst die folgenden Wert ein: Aktivieren Sie den Eintrag API Typ: Google Cloud Print auswählen Name (intern): Beliebigen Namen (ohne Sonderzeichen, ohne Leerzeichen) Beschreibung: Beliebige Beschreibung


Kopieren Sie sich dann aus dem Feld Redirect URI den Wert und wechseln zurück in das andere Browserfenster bzw. den letzten Tab mit Ihrer Google Cloud Console.

Dort füllen Sie den Wert unter Autorisierte Weiterleitungs-URI ein und klicken auf Erstellen.


Bitte beachten: Nach der Eingabe immer erst mit Taste [3] oder [4] bestätigen, der Wert wird sonst nicht übernommen.Nach der Erstellung des API-Zugangs erscheint ein Dialog mit den letzten beiden notwendigen Werten, die Zur Anbindung vion Xentral an den Google Cloud Dienst notwendig sind. Diese kopieren Sie bitte nacheinander in das entsprechende Feld in Ihrer Xentral Google API-App.


Nachdem der Google API-Zugang eingerichtet wurde kann sich Xentral nun mit dem Google Cloud Print-Dienst verbinden.


 

Google Account in Xentral autorisieren

Um die in Google registrierten Drucker in Xentral verwenden zu können muss der entsprechende Google Account einmalig autorisiert werden.

Dazu klicken Sie in der App bitte auf VerbindenSie werden zur Autorisierung Ihres Google Kontos weitergeleitet. Hier verwenden Sie bitte den Google Account unter dem Sie zuvor die Drucker eingerichtet hatten. Dieser muss nicht mit Ihrem Google-API-Account übereinstimmen.

Je nachdem aus welcher Domain der API-Account und Ihre Google Account kommen kann die folgende Warnung erscheinen, die Sie bitte wir in den Bildern angedeutet beantworten:


Sie müssen nun erneut die Verbindung bestätigen:



und noch einmal gesondert den notwendigen Rechten zustimmen:



Abschließend werden Sie gebeten den Zugriff von Google auf Ihre Drucker für diese Anwendung (Druck aus Xentral ) zu autorisieren.

Google Cloud Printer

 
Beginnend mit der Version 20.1 können Drucker bequem über den Google Cloud Print-Dienst angesprochen werden. Dazu verbinden sich kompatible Drucker entweder direkt mit den Druckdienst von Google oder Drucker werden über den Browser Google Chrome vom lokalen PC aus angesprochen. Google Chrome übernimmt in diesem Fall die Kommunikation mit dem Google Cloud Dienst.

Voraussetzungen & Vorgehensweise

  • Ein verwendbarer Google Account ist vorhanden
  • Google Cloud-Printer sind eingerichtet.
    Weitere Informationen zur Einrichtung der Drucker erfahren Sie unter 3. Drucker mit Google Cloud Print verbinden auf der Google-Support-Seite.
  • Sie verwenden Xentral 20.1 oder eine neuere Version
Informationen zur Einrichtung der Google Cloud API und die Herstellung der Verbindung von Xentral zu dieser API finden Sie im Artikel Google Cloud API

Drucker in Xentral einrichten

Um den oder die Drucker nun in Xentral einzurichten sind noch drei Schritte notwendig
  • Neuen Drucken anlegen
  • Google Account auswählen
  • Drucker auswählen
Navigieren Sie in Xentral zunächst zu Administration > Drucker.

Legen Sie einen neuen Drucker an und füllen die Felder wie beschrieben aus:
  1. Beliebiger Name des Druckers, dieser erscheint zur Auswahl in Xentral, könnte also Standort und Typbezeichnnung enthalten.
  2. Technischer Name des Druckers (bitte nur Buchstaben und Zahlen verwenden, keine Leer- oder Sonderzeichen).
  3. Aktivieren Sie den Drucker
  4. Wählen Sie Google Cloud Print als Option und
  5. Speichern Sie den Eintrag einmal


Anschließend erhalten Sie zusätzliche Funktionen im unteren Bereich der Seite. hier können Sie
  1. ihren Google-Account wählen (falls Sie mehrere Accounts autorisiert haben)
  2. den gewünschten Drucker wählen.
  3. Speichern Sie anschließend erneut um die Druckereinrichtung abzuschließen.
 

Google Mail via OAuth

Neuere Google Accounts erlauben das Versenden von E-Mails nur noch mit der sogenannten OAuth Authentifizierung.

Zugang zur Google Mail API

Legen Sie Ein Projekt an und erstellen Sie einen Zustimmungsbildschirm, sofern diese noch nicht existieren.
Erstellen Sie in der Google API Konsole neue OAuth Anmeldedaten oder verwenden Sie einen bereits bestehenden Zugang.
Die Client-ID und der Clientschlüssel werden im folgenden Schritt benötigt.

API Zugang in Xentral konfigurieren

Erstellen Sie über den "Neu" Button eine neue Google-Api, wählen Sie den Typ Google Mail aus und tragen Sie die Client-ID und den Clientschlüssel ein.
Vervollständigen Sie das Formular und speichern Sie.

Google Mail Accounts konfigurieren

Nun können Sie Google Email Adressen in der Email Accounts App für Google OAuth konfigurieren.