mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-11-14 20:17:14 +01:00
5 lines
16 KiB
Plaintext
5 lines
16 KiB
Plaintext
<h1>Google Cloud API</h1><p>Beginnend mit der Version 20.1 können verschiedene Google Dienste aus Xentral angesprochen werden. Google Cloud Print, Google Kalender und Google Mail<br /> </p><h2>Voraussetzungen & Vorgehensweise</h2><ul><li>Ein verwendbarer Google Account ist vorhanden</li><li>Sie verwenden Xentral 20.1 oder eine neuere Version</li></ul><br />In diesem Artikel wird die erstmalige Einrichtung der Google API beschrieben. Diese muss einmalig durchgeführt werden und besteht aus den folgenden Schritten:<ul><li>Google API einrichten</li><li>API-Zugang in Xentral konfigurieren</li><li>Google Account in Xentral autorisieren</li></ul><br />Anschließend können z.B. Google Cloud Drucker angebunden werden. Für weitere Infos weiter im Artikel lesen.<br /> <h3>Google API-Account anlegen</h3> Loggen Sie sich zunächst in Ihren Google Account ein. Rufen Sie dan im selben Browser die Seite https://console.cloud.google.com auf.<br /><br />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.<br /><br />Nun folgen die ersten drei Schritte<ul><li>Neues Projekt anlegen</li><li>Neuen Zustimmungsbildschirm anlegen</li><li>API-Zugang anlegen</li></ul> <h4>Neues Projekt anlegen</h4> Bi der ersten Verwendung müssen Sie zunächst den Google Cloud-Nutzungsbedingungen zustimmen.<img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=1" /><br /><br />Klicken Sie dann auf das Projekt-DropDown oben und legen Sie dort ein Neues Projekt an.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=2" /><br /><br />Sie können einen beliebigen Namen eingeben oder den aus unserem Beispiel verwenden. Klicken Sie im Anschluß daran auf Erstellen.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=3" /><br /><br />Es dauert eine Weile bis das Projekt erstellt wird.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=4" /><br /><br />Anschließend können Sie das Projekt gleich durch durch Klicken auswählen.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=5" /><br /> <h4>Neuen Zustimmungsbildschirm anlegen</h4> 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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=6" /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=7" /><br /><br />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.<br /><br />Klicken Sie dazu bitte auf den Button Zustimmungsbildschirm konfigurieren.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=8" />Sie können einen beliebige Namen verwenden oder unserer Textvorschlag verwenden. Der Upload eines Logos ist optional.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=9" /><br /><br />Nun kommen wichtige Einstellungen in denen Sie auf fehlerfreie Eingabe achten sollten:<ul><li>Autorisierte Domains: Nummerierter ListenpunktDomain der eigenen Xentral-Instanz eingeben, das ist der erste Teil der Adresse, die Sie beim Arbeiten mit Xentral in Ihrem Browserfenster sehen können.</li><li>Lassen Sie dabei bitte das Protokoll (http: oder https://) sowie den Anfang der URL (die sog. Subdomain) weg und nehmen nur die letzten beiden Werte der Domain. Eingetragen wird also nur der Domainname und die Domain-Endung (TLD), keine Subdomains oder Pfade. In unserem Beispiel lautet der Wert xentral.biz.</li><li>Bitte beachten: Nach der Eingabe muss immer erst mit Taste <a href="1" target="_blank">[1]</a> oder <a href="2" target="_blank">[2]</a> bestätigt werden, sonst wird der Wert nicht gespeichert.</li><li>Link zur Startseit der Anwendung: Anders als im letzten Feld ist hier der komplette Pfad zu Xentral anzugeben, inkl. des Protokolls und der Pfade zu Ihrer Xentral-InstanzLink zur Datenschutzerklärung der Anwendung: Im Fall einer verwendung innerhalb der eigenen Firma ist dieser Wert nicht relevnt. Hier können Sie einen beliebigen Wert eintragen oder unser Beispiel übernehmen.</li><li>Klicken Sie zum Abschluß auf Speichern.</li></ul><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=10" />Sie bekommen angezeigt, wenn der Zustimmungsbildschirm erfolgreich konfiguriert wurde.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=11" /><br /> <h4>API-Zugang anlegen</h4> Im Anschluß an die Erstellung des Zustimmungsbildschirms werden Sie zu der Seite weitergeleitet auf der Sie den eigentlichen API-Zugang anlegen können.<br /><br />Wählen Sie bitte unter Anwendungstyp die Option Webanwendung.Tragen Sie bitte unter Name einen beliebigen Namen oder unseren Textvorschlag ein.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=12" /><br /><br />Den letzten einzufüllenden Wert, die <strong>Autorisierte Weiterleitungs-URI </strong>erhalten Sie im folgenden Schritt aus Xentral.<br /><br />Lassen Sie daher das Browserfenster hier geöffnet und <strong>wechseln Sie in einem anderen Tab oder Fenster in ihre Xentral-Instanz.</strong> <h3>Google Kalender API aktivieren</h3><p>Um die Synchronisation des Google Kalenders mit Xentral zu ermöglichen muss vorher die Google Calendar API explizit aktiviert werden.<br /><br />Wechseln Sie dazu ins Dashboard und klicken Sie auf "APIS UND DIENSTE AKTIVIEREN"<br /><br /><img src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=2673" style="width: 919px; height: 466px;" /></p>Suchen Sie nach dem englischen Begriff "calendar" und wählen Sie die "Google Calendar API" aus.<br /><br /><img src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=2674" style="width: 1238px; height: 461px;" /><br /><br />Auf der Nächsten Seite klicken Sie auf "Aktivieren".<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=2675" style="width: 1078px; height: 353px;" /><br /> <h3>API-Zugang in Xentral konfigurieren</h3> Navigieren Sie in den Xentral AppStore und suchen dort nach "<strong>Google</strong>". Sie finden die <strong>App Google API, </strong>die SIe bitte aus dem App-Store starten.<br /><br />Legen Sie dort einen neuen Eintrag an, indem Sie auf den Button "<strong>Neu</strong>" klicken.<img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=13" /><br /><br />Füllen Sie zunächst die folgenden Wert ein: <strong>Aktivieren</strong> Sie den Eintrag <strong>API Typ: Google Cloud Print </strong>auswählen <strong>Name (intern):</strong> Beliebigen Namen (ohne Sonderzeichen, ohne Leerzeichen) <strong>Beschreibung:</strong> Beliebige Beschreibung<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=14" /><br />Kopieren Sie sich dann aus dem Feld <strong>Redirect URI </strong>den Wert und wechseln zurück in das andere Browserfenster bzw. den letzten Tab mit Ihrer Google Cloud Console.<br /><br />Dort füllen Sie den Wert unter <strong>Autorisierte Weiterleitungs-URI </strong>ein und klicken auf <strong>Erstellen</strong>.<img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=15" /><br /><br /><br /><strong>Bitte beachten</strong>: Nach der Eingabe immer erst mit Taste <a href="3" target="_blank">[3]</a> oder <a href="4" target="_blank">[4]</a> 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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=16" /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=17" /><ul><li>Client-ID in Xentral kopieren</li><li>Client-Schlüssel in Xentral kopieren</li><li>Bestätigen Sie nun zunächt mit Speichern</li></ul><br />Nachdem der Google API-Zugang eingerichtet wurde kann sich Xentral nun mit dem Google Cloud Print-Dienst verbinden.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=18" /><br /> <h3>Google Account in Xentral autorisieren</h3> Um die in Google registrierten Drucker in Xentral verwenden zu können muss der entsprechende Google Account einmalig autorisiert werden.<br /><br />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.<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=19" /><br />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:<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=20" /><br /><br />Sie müssen nun erneut die Verbindung bestätigen:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=21" /><br /><br />und noch einmal gesondert den notwendigen Rechten zustimmen:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=22" /><br /><br />Abschließend werden Sie gebeten den Zugriff von Google auf Ihre Drucker für diese Anwendung (Druck aus Xentral ) zu autorisieren.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=googleapi&fileid=23" /><h1>Google Cloud Printer</h1><div class="clear"> </div><div class="component">
|
|
<article><div class="content"><div class="text text-container offset-bottom2"><span class="wiki-text">Beginnend mit der Version 20.1 können Drucker bequem über den <span class="highlight" rel="Google">Google</span> Cloud Print-Dienst angesprochen werden. Dazu verbinden sich <a href="https://www.google.com/cloudprint/learn/printers/">kompatible Drucker</a> entweder direkt mit den Druckdienst von <span class="highlight" rel="Google">Google</span> oder Drucker werden über den Browser <span class="highlight" rel="Google">Google</span> Chrome vom lokalen PC aus angesprochen. <span class="highlight" rel="Google">Google</span> Chrome übernimmt in diesem Fall die Kommunikation mit dem <span class="highlight" rel="Google">Google</span> Cloud Dienst. </span><h2 id="-voraussetzungen---vorgehensweise-">Voraussetzungen & Vorgehensweise</h2><ul><li>Ein verwendbarer <span class="highlight" rel="Google">Google</span> Account ist vorhanden</li><li><span class="highlight" rel="Google">Google</span> Cloud-Printer sind eingerichtet.<br />Weitere Informationen zur Einrichtung der Drucker erfahren Sie unter <strong>3. Drucker mit <span class="highlight" rel="Google">Google</span> Cloud Print verbinden</strong> auf der <a href="https://support.google.com/cloudprint/answer/1686197?hl=de"><span class="highlight" rel="Google">Google</span>-Support-Seite</a>.</li><li>Sie verwenden Xentral 20.1 oder eine neuere Version</li></ul> <span class="wiki-text">Informationen zur Einrichtung der <span class="highlight" rel="Google">Google</span> Cloud API und die Herstellung der Verbindung von Xentral zu dieser API finden Sie im Artikel <a href="https://xentral.com/helpdesk/googleapi"><span class="highlight" rel="Google">Google</span> Cloud API</a></span><h3 id="-drucker-in-xentral-einrichten-">Drucker in Xentral einrichten</h3> <span class="wiki-text">Um den oder die Drucker nun in Xentral einzurichten sind noch drei Schritte notwendig </span><ul><li>Neuen Drucken anlegen</li><li><span class="highlight" rel="Google">Google</span> Account auswählen</li><li>Drucker auswählen</li></ul> <span class="wiki-text">Navigieren Sie in Xentral zunächst zu <strong>Administration</strong> > <strong>Drucker</strong>.</span><br /><span class="wiki-text"><img data-mfp-src="/images/wiki-import/entwickler/googleapi_drucker_01_drucker.png" src="https://xentral.com/images/wiki-import/entwickler/googleapi_drucker_01_drucker.png" style="cursor: pointer;" /></span><br /><span class="wiki-text">Legen Sie einen neuen Drucker an und füllen die Felder wie beschrieben aus: </span><ol><li>Beliebiger Name des Druckers, dieser erscheint zur Auswahl in Xentral, könnte also Standort und Typbezeichnnung enthalten.</li><li>Technischer Name des Druckers (bitte nur Buchstaben und Zahlen verwenden, keine Leer- oder Sonderzeichen).</li><li>Aktivieren Sie den Drucker</li><li>Wählen Sie <strong><span class="highlight" rel="Google">Google</span> Cloud Print</strong> als Option und</li><li>Speichern Sie den Eintrag einmal</li></ol> <span class="wiki-text"><img data-mfp-src="/images/wiki-import/entwickler/googleapi_drucker_02_teil1.png" src="https://xentral.com/images/wiki-import/entwickler/googleapi_drucker_02_teil1.png" style="cursor: pointer;" /></span><br /><br /><span class="wiki-text">Anschließend erhalten Sie zusätzliche Funktionen im unteren Bereich der Seite. hier können Sie </span><ol><li>ihren <span class="highlight" rel="Google">Google</span>-Account wählen (falls Sie mehrere Accounts autorisiert haben)</li><li>den gewünschten Drucker wählen.</li><li>Speichern Sie anschließend erneut um die Druckereinrichtung abzuschließen.</li></ol> <span class="wiki-text"><img data-mfp-src="/images/wiki-import/entwickler/googleapi_drucker_03_teil2.png" src="https://xentral.com/images/wiki-import/entwickler/googleapi_drucker_03_teil2.png" style="cursor: pointer;" /></span><div class="clear"> </div></div></div></article>
|
|
</div>
|
|
<h1>Google Mail via OAuth</h1>Neuere Google Accounts erlauben das Versenden von E-Mails nur noch mit der sogenannten OAuth Authentifizierung.
|
|
<h2>Zugang zur Google Mail API</h2>Legen Sie Ein Projekt an und erstellen Sie einen Zustimmungsbildschirm, sofern diese noch nicht existieren.<br />Erstellen Sie in der <a href="https://console.developers.google.com/">Google API Konsole</a> neue OAuth Anmeldedaten oder verwenden Sie einen bereits bestehenden Zugang.<br />Die Client-ID und der Clientschlüssel werden im folgenden Schritt benötigt.<h2>API Zugang in Xentral konfigurieren</h2>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.<br />Vervollständigen Sie das Formular und speichern Sie.<h2>Google Mail Accounts konfigurieren</h2>Nun können Sie Google Email Adressen in der Email Accounts App für Google OAuth konfigurieren.<br /><br /><br /><br /> |