mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-26 14:40:29 +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
|
||
|
|
<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 />
|