Mit einem Google-Dienstkonto können Sie eine Verbindung zu Ihrer Zieldomain für Google Workspace herstellen. Sie verwenden ein Dienstkonto, um die Zielverbindung hinzuzufügen.
Sie müssen kein neues Dienstkonto erstellen, wenn Sie eine Zielverbindung hinzufügen. Sie können das Dienstkonto verwenden, das Sie zuvor eingerichtet haben. Wenn Sie ein Dienstkonto wiederverwenden, führen Sie die Schritte 2 und 3 aus.
Wenn Sie ein neues Dienstkonto erstellen möchten, führen Sie die Schritte 1–3 aus.
Schritt 1: Dienstkonto erstellen (optional)
Wie Sie das Dienstkonto erstellen, hängt davon ab, ob Sie ein automatisches Skript ausführen (empfohlen) oder das Konto manuell erstellen möchten.
Option 1: Konto über automatisches Skript erstellen (empfohlen)
- Folgen Sie der Anleitung unter Dienstkonto über automatisches Skript erstellen.
- Fahren Sie mit Schritt 3: Zielverbindung einrichten fort.
Option 2: Konto manuell erstellen
Hinweis: Verwenden Sie ein Google Cloud-Projekt, das entweder zur Quell- oder zur Zielumgebung gehört, je nachdem, wie Sie die API-Nutzung und die Kontingente verwalten möchten. Sie können das neue Dienstkonto in einem anderen Google Cloud-Projekt erstellen. Aktivieren Sie in diesem Fall zuerst die APIs im neuen Projekt. Weitere Informationen finden Sie unter Schritt 1: APIs mit Google Cloud aktivieren.
- InGoogle Cloud, klicken Sie auf IAM und Verwaltung
Dienstkonten. Möglicherweise müssen Sie zuerst auf das Dreistrich-Menü
klicken.
- Klicken Sie auf Dienstkonto erstellen.
- Geben Sie für Name des Dienstkontos einen Namen ein.
Die Dienstkonto-ID wird automatisch ausgefüllt.
- Optional: Wenn Sie dem Dienstkonto eine eigene Beschreibung hinzufügen möchten, klicken Sie auf Beschreibung des Dienstkontos und geben Sie eine Beschreibung ein.
- Klicken Sie auf Erstellen und fortfahren.
- Dienstkonto- und Nutzerberechtigungen sind für Google Workspace Migrate nicht erforderlich.
Klicken Sie auf Fertig, um diese Schritte zu überspringen.
- Wählen Sie die E-Mail-Adresse des von Ihnen erstellten Dienstkontos aus.
- Klicken Sie oben aufSchlüssel
- Prüfen Sie, ob als Schlüsseltyp JSON festgelegt ist, und klicken Sie dann auf Erstellen.
Sie erhalten eine Meldung, dass die JSON-Schlüsseldatei des Dienstkontos erstellt und auf Ihren Computer heruntergeladen wurde. Notieren Sie sich den Namen der Datei, da Sie sie später benötigen.
- Klicken Sie auf Schließen.
Hinweise
Das Erstellen von Dienstkonten kann bis zu 24 Stunden dauern. Wenn Sie den Namen der Schlüsseldatei verlieren, wiederholen Sie diese Schritte, um eine neue zu erstellen.
Schritt 2: Dienstkonto autorisieren
Als Nächstes autorisieren Sie das Dienstkonto in der Admin-Konsole für Ihre Zieldomain. Sie müssen diesen Schritt auch ausführen, wenn Sie ein Dienstkonto wiederverwenden.
-
Melden Sie sich in der Google Admin-Konsole an.
Verwenden Sie zur Anmeldung ein Konto mit Super Admin-Berechtigungen (endet nicht auf @gmail.com).
-
Öffnen Sie in der Admin-Konsole das Dreistrich-Menü
Sicherheit
Für diese Aufgabe müssen Sie als Super Admin angemeldet sein. -
Klicken Sie auf Neu hinzufügen und geben Sie die Client-ID Ihres Dienstkontos ein.
Sie finden die ID (auch bekannt als eindeutige ID) in der JSON-Datei, die Sie beim Erstellen des Dienstkontos heruntergeladen haben, oder in der Google Cloud unter IAM & Verwaltung
- Kopieren Sie für OAuth-Bereiche die folgenden Bereiche und fügen Sie sie ein:
https://apps-apis.google.com/a/feeds/emailsettings/2.0/,
https://www.googleapis.com/auth/contacts,
https://www.googleapis.com/auth/admin.directory.group,
https://www.googleapis.com/auth/admin.directory.group.member,
https://www.googleapis.com/auth/admin.directory.orgunit,
https://www.googleapis.com/auth/admin.directory.resource.calendar,
https://www.googleapis.com/auth/admin.directory.user,
https://www.googleapis.com/auth/apps.groups.migration,
https://www.googleapis.com/auth/apps.groups.settings,
https://www.googleapis.com/auth/calendar,
https://www.googleapis.com/auth/drive,
https://www.googleapis.com/auth/drive.appdata,
https://www.googleapis.com/auth/drive.file,
https://www.googleapis.com/auth/gmail.modify,
https://www.googleapis.com/auth/migrate.deployment.interop,
https://www.googleapis.com/auth/tasks,
https://www.googleapis.com/auth/userinfo.email,
https://sites.google.com/feeds,
https://www.googleapis.com/auth/gmail.settings.basic,
https://www.googleapis.com/auth/gmail.settings.sharing,
https://www.googleapis.com/auth/admin.directory.customer.readonly,
https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly - Klicken Sie auf Autorisieren.
-
Wählen Sie die neue Client-ID aus, klicken Sie auf Details ansehen und prüfen Sie, ob alle Bereiche aufgelistet sind.
Wenn ein Bereich fehlt, klicken Sie auf Bearbeiten, geben Sie den fehlenden Bereich ein und klicken Sie auf Autorisieren. Die Client-ID lässt sich nicht bearbeiten.
-
Klicken Sie dann in Google Cloud auf Speichern.
Fehlerbehebung
Der folgende Fehler kann angezeigt werden: Der Client ist nicht berechtigt, Zugriffstokens mit dieser Methode abzurufen, oder der Client ist für einen der angeforderten Bereiche nicht autorisiert.
So können Sie den Fehler beheben:
- Wiederholen Sie Schritt 2 oben (Dienstkonto autorisieren).
- Achten Sie darauf, die richtige Client-ID zu verwenden. Öffnen Sie die JSON-Datei in einem Texteditor, um zu prüfen, ob die Client-IDs übereinstimmen.
- Wenn der Fehler weiterhin angezeigt wird, müssen Sie möglicherweise warten, bis der Autorisierungsvorgang abgeschlossen ist. Das dauert in der Regel einige Minuten, kann aber auch bis zu 24 Stunden in Anspruch nehmen.
Schritt 3: Zielverbindung einrichten
- Klicken Sie auf der Google Workspace Migrate-Plattform auf New (Neu)
- Geben Sie einen Namen für die Verbindung ein.
- Wählen Sie unter Type (Typ) die Option Google Workspace aus.
- Geben Sie unter Admin email (Admin-E-Mail-Adresse) die E-Mail-Adresse eines Super Admins Ihrer Google Workspace-Zieldomain ein.
- Klicken Sie unter Account (Konto) auf Add new account (Neues Konto hinzufügen).
- Klicken Sie unter Service certificate (Dienstzertifikat) auf Upload file (Datei hochladen), gehen Sie zum heruntergeladenen privaten JSON-Schlüssel und klicken Sie auf Open (Öffnen). Alternativ können Sie die JSON-Datei in das Feld ziehen.
- Klicken Sie auf Create (Erstellen).
Nächster Schritt
Google, Google Workspace sowie zugehörige Marken und Logos sind Marken von Google LLC. Alle anderen Unternehmens- und Produktnamen sind Marken der Unternehmen, mit denen sie verbunden sind.