Mit der Google Chat API können Sie Daten aus Ihren anderen Messaging-Plattformen in Google Chat importieren. Sie können vorhandene Nachrichten, Anhänge, Reaktionen, Mitgliedschaften und Gruppenbereichs-Entitäten von Ihren anderen Messaging-Plattformen in die entsprechenden Chat API-Ressourcen importieren. Sie können diese Daten importieren, indem Sie Google Chat-Gruppenbereiche im Importmodus erstellen und Daten in diese Gruppenbereiche importieren. Nach erfolgreichem Abschluss des Vorgangs werden diese Bereiche zu Standard-Chatbereichen.
Im Folgenden wird der vollständige Importvorgang beschrieben:
- Import planen
- Autorisierung für die Chat App konfigurieren
- Gruppenbereich im Importmodus erstellen
- Ressourcen importieren
- Importierte Ressourcen validieren
- Abweichungen bei importierten Ressourcen aus den Quelldaten abgleichen
- Vollständiger Importmodus
- Zugriff auf den Gruppenbereich nach dem Importmodus gewähren
- Fehlerbehebung
Vorbereitung
Apps Script
- Ein Business- oder Enterprise Google Workspace-Konto mit Zugriff auf Google Chat.
- Google Cloud-Projekt erstellen
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, Symbol und einer Beschreibung für Ihre Chat-App.
- Erstellen Sie ein eigenständiges Apps Script-Projekt und aktivieren Sie den erweiterten Chatdienst.
- Der Chat-App muss domainweite Berechtigung in allen Domains delegiert werden, in die die App Inhalte importiert. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Python
- Ein Google Workspace-Konto für Unternehmen oder Organisationen mit Zugriff auf Google Chat.
- Google Cloud-Projekt erstellen
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, Symbol und einer Beschreibung für Ihre Chat-App.
- Python 3.6 oder höher
- Das Paketverwaltungstool pip
- Der Chat-App muss domainweite Berechtigung in allen Domains delegiert werden, in die die App Inhalte importiert. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Import planen
Planen Sie die zu importierende Datenmenge entsprechend, informieren Sie sich darüber, wie sich die Nutzungslimits und Kontingente auf den Importprozess auswirken können, und informieren Sie sich über die Arten von Gruppenbereichen, die beim Importieren in einen neuen Gruppenbereich unterstützt werden.
Limits für die API-Nutzung überprüfen
Die Zeit, die zum Importieren von Daten in Google Chat benötigt wird, kann je nach Anzahl der zu importierenden Chat-Ressourcen stark variieren. Sehen Sie sich die Nutzungslimits Ihrer Chat-App und die Menge der Daten an, die von der Quell-Messaging-Plattform importiert werden sollen, um einen geschätzten Zeitplan zu ermitteln.
Wenn Sie Nachrichten in einen Gruppenbereich importieren, empfehlen wir, die Aufrufe der Methode messages.create()
auf verschiedene Nachrichtenthreads zu verteilen.
Zu importierende unterstützte Gruppenbereiche ermitteln
Im Importmodus werden nur die SpaceType
von SPACE
und GROUP_CHAT
unterstützt. DIRECT_MESSAGE
wird nicht unterstützt.
Weitere Informationen finden Sie in der Dokumentation zu SpaceType
.
Gruppenbereich im Importmodus erstellen
Rufen Sie zum Erstellen eines Gruppenbereichs im Importmodus die Methode create
für die Ressource Space
auf und setzen Sie importMode
auf true
.
Beachten Sie beim Erstellen des Gruppenbereichs im Importmodus Folgendes:
- Datum und Uhrzeit: Der Importmodus muss innerhalb von 30 Tagen abgeschlossen werden. Wenn sich der Gruppenbereich 30 Tage nach dem Aufruf der Methode
spaces.create()
noch im Importmodus befindet, wird er automatisch gelöscht und ist nicht mehr zugänglich und nicht wiederherstellbar.- Verwenden Sie den Wert des Felds
createTime
nicht, um das Ablaufen des 30-tägigen Zeitraums zu verfolgen. Das ist nicht immer dasselbe wie beim Aufrufen derspaces.create()
-Methode. Wenn Sie den Importmodus verwenden, kann das FeldcreateTime
auf den Zeitstempel festgelegt werden, zu dem der Gruppenbereich in der Quelle erstellt wurde, um die ursprüngliche Erstellungszeit beizubehalten.
- Verwenden Sie den Wert des Felds
- Ressourcenname des Gruppenbereichs (
name
): Mit dieser eindeutigen Kennung werden Informationen zum jeweiligen Gruppenbereich abgerufen. Darauf wird in späteren Schritten beim Importieren von Inhalten in den Gruppenbereich verwiesen.
Wenn Sie den Erstellungszeitpunkt der entsprechenden Gruppenbereichs-Entität aus der Quell-Messaging-Plattform beibehalten möchten, können Sie die createTime
des Gruppenbereichs festlegen. createTime
muss auf einen Wert zwischen dem 1. Januar 2000 und heute festgelegt werden.
Wenn Sie einen externen Gruppenbereich im Importmodus erstellen möchten, setzen Sie externalUserAllowed
auf true
.
Nach Abschluss des Imports können Sie externe Nutzer hinzufügen.
Im folgenden Beispiel wird gezeigt, wie Sie einen Gruppenbereich im Importmodus erstellen:
Apps Script
function createSpaceInImportMode() {
const space = Chat.Spaces.create({
spaceType: 'SPACE',
displayName: 'DISPLAY_NAME',
importMode: true,
createTime: (new Date('January 1, 2000')).toJSON()
});
console.log(space.name);
}
Python
"""Create a space in import mode."""
import datetime
from google.oauth2 import service_account
from googleapiclient.discovery import build
# Specify required scopes.
SCOPES = [
'https://www.googleapis.com/auth/chat.import',
]
CREDENTIALS = (
service_account.Credentials.from_service_account_file('credentials.json')
.with_scopes(SCOPES)
.with_subject('EMAIL')
)
# Build a service endpoint for Chat API.
service = build('chat', 'v1', credentials=CREDENTIALS)
result = (
service.spaces()
.create(
body={
'spaceType': 'SPACE',
'displayName': 'DISPLAY_NAME',
'importMode': True,
'createTime': f'{datetime.datetime(2000, 1, 1).isoformat()}Z',
}
)
.execute()
)
print(result)
Ersetzen Sie Folgendes:
EMAIL
: die E-Mail-Adresse des Nutzerkontos, das Sie mit domainweiter Befugnis imitieren.DISPLAY_NAME
: Der Name des im Importmodus erstellten Gruppenbereichs. Dies muss ein eindeutiger Name für den Gruppenbereich sein, der Chatnutzern angezeigt wird. Wir empfehlen, denselben Anzeigenamen wie für den Gruppenbereich zu verwenden, aus dem Sie Daten importieren.
Ressourcen importieren
Wenn Sie Ressourcen aus anderen Messaging-Plattformen importieren möchten, erstellen Sie Google Chat-Ressourcen (z. B. Nachrichten, Reaktionen, Anhänge) im Gruppenbereich im Importmodus. Wenn Sie eine Ressource im Gruppenbereich erstellen, geben Sie Daten aus der zugehörigen Ressource der Nachrichtenplattform an, von der Sie migrieren.
Nachrichten
Ihre Chat-Apps können Nachrichten mit ihrer eigenen Autorisierung oder im Namen eines Nutzers durch Identitätsdiebstahl importieren. Als Absender der Nachricht wird das gefälschte Nutzerkonto angegeben. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Wenn Sie eine Nachricht in einen Gruppenbereich im Importmodus importieren möchten, rufen Sie die Methode create
für die Ressource Message
auf.
Wenn Sie die Erstellungszeit der ursprünglichen Nachricht von der Quell-Messaging-Plattform beibehalten möchten, können Sie die createTime
der Nachricht festlegen. Für createTime
muss ein Wert festgelegt werden, der zwischen dem zuvor festgelegten Erstellungszeitpunkt des Raums und dem heutigen Zeitpunkt liegt.
Nachrichten im selben Gruppenbereich können nicht dieselbe createTime
enthalten, auch wenn vorherige Nachrichten mit dieser Uhrzeit gelöscht wurden.
In Gruppenbereichen im Importmodus können keine Linkvorschauen für Nachrichten mit Drittanbieter-URLs in Google Chat gerendert werden.
Wenn Sie die Nachrichten im Importmodus erstellen, werden keine Nutzer benachrichtigt und es werden keine E-Mails an Nutzer gesendet. Das gilt auch für Nachrichten, die Erwähnungen von Nutzern enthalten.
Im folgenden Beispiel wird gezeigt, wie eine Nachricht in einem Gruppenbereich im Importmodus erstellt wird:
Python
"""Create a message in import mode space."""
import datetime
from google.oauth2 import service_account
from googleapiclient.discovery import build
# Specify required scopes.
SCOPES = [
'https://www.googleapis.com/auth/chat.import',
]
CREDENTIALS = (
service_account.Credentials.from_service_account_file('credentials.json')
.with_scopes(SCOPES)
.with_subject('EMAIL')
)
# Build a service endpoint for Chat API.
service = build('chat', 'v1', credentials=CREDENTIALS)
NAME = 'spaces/SPACE_NAME'
result = (
service.spaces()
.messages()
.create(
parent=NAME,
body={
'text': 'Hello, world!',
'createTime': f'{datetime.datetime(2000, 1, 2).isoformat()}Z',
},
)
.execute()
)
print(result)
Ersetzen Sie Folgendes:
EMAIL
: Die E-Mail-Adresse des Nutzerkontos, dessen Identität Sie mit domainweiter Autorisierung stehlen.SPACE_NAME
: der Name des im Importmodus erstellten Gruppenbereichs.
Reaktionen
Ihre Chat-App kann mithilfe der Chat API Reaktionen auf Nachrichten importieren. Informationen zu den Ressourcenmethoden und Authentifizierungstypen, die in Gruppenbereichen im Importmodus unterstützt werden, finden Sie unter Chat-Apps autorisieren.
Anhänge
Ihre Chat-App kann über die Chat API Anhänge hochladen. Informationen zu den Ressourcenmethoden und Authentifizierungstypen, die in Gruppenbereichen im Importmodus unterstützt werden, finden Sie unter Chat-Apps autorisieren. Wir empfehlen Ihnen jedoch dringend, die Google Drive API zu verwenden, um Anhänge als Google Drive-Dateien hochzuladen und die Datei-URIs mit den entsprechenden Nachrichten in den Bereichen im Importmodus zu verknüpfen, um Anhänge von anderen Nachrichtenplattformen zu importieren. So vermeiden Sie, dass das interne Limit von Google Chat für das Hochladen von Anhängen erreicht wird.
Bisherige Mitgliedschaften
Verlaufsmitgliedschaften sind Mitgliedschaften, die für Nutzer erstellt wurden, die die ursprüngliche Gruppenbereichsentität der Quell-Messaging-Plattform bereits verlassen haben, aber ihre Daten in Google Chat beibehalten möchten. Informationen zum Hinzufügen neuer Mitglieder, nachdem der Gruppenbereich nicht mehr im Importmodus ist, finden Sie unter Mitgliedschaftsressource erstellen.
Wenn diese historischen Mitglieder einer Richtlinie zur Datenaufbewahrung in Google unterliegen, möchten Sie in vielen Fällen die Daten (z. B. Nachrichten und Reaktionen) beibehalten, die durch historische Mitgliedschaften in einem Gruppenbereich erstellt wurden, bevor Sie sie in Google Chat importieren.
Solange sich der Gruppenbereich im Importmodus befindet, können Sie diese bisherigen Mitgliedschaften mithilfe der Methode create
für die Membership
-Ressource in den Gruppenbereich importieren.
Damit der Zeitpunkt des Austritts der bisherigen Mitgliedschaft erhalten bleibt, müssen Sie die deleteTime
der Mitgliedschaft festlegen. Dieser Termin muss korrekt sein, da er sich darauf auswirkt, welche Daten für diese Mitgliedschaften aufbewahrt werden. Darüber hinaus muss dieser deleteTime
nach dem Zeitstempel für die Erstellung des Gruppenbereichs liegen und darf kein zukünftiger Zeitstempel sein.
Zusätzlich zu deleteTime
können Sie auch createTime
festlegen, um die ursprüngliche Beitrittszeit der bisherigen Mitgliedschaft beizubehalten. Im Gegensatz zu deleteTime
ist createTime
optional. Wenn dieser Wert nicht festgelegt ist, wird createTime
automatisch berechnet, indem 1 Mikrosekunde von deleteTime
abgezogen wird. Wenn festgelegt, muss createTime
vor deleteTime
liegen und muss am oder nach dem Datum der Gruppenbereichserstellung liegen. Diese createTime
-Informationen werden nicht verwendet, um die Datenaufbewahrung festzulegen. Sie sind in Administratortools wie der Admin-Konsole und Google Vault nicht sichtbar.
Es kann mehrere Möglichkeiten geben, wie ein Nutzer einem Gruppenbereich auf der Quell-Messaging-Plattform beitreten und ihn verlassen kann (z. B. über Einladungen, selbst beitreten oder von einem anderen Nutzer hinzugefügt werden). In Google Chat werden diese Aktionen alle in den Feldern für die bisherige Mitgliedschaft createTime
und deleteTime
als Hinzufügen oder Entfernen dargestellt.
Das folgende Beispiel zeigt, wie Sie eine bisherige Mitgliedschaft in einem Bereich im Importmodus erstellen:
Python
"""Create a historical membership in import mode space."""
import datetime
from google.oauth2 import service_account
from googleapiclient.discovery import build
# Specify required scopes.
SCOPES = [
'https://www.googleapis.com/auth/chat.import',
]
CREDENTIALS = (
service_account.Credentials.from_service_account_file('credentials.json')
.with_scopes(SCOPES)
.with_subject('EMAIL')
)
# Build a service endpoint for Chat API.
service = build('chat', 'v1', credentials=CREDENTIALS)
NAME = 'spaces/SPACE_NAME'
USER = 'users/USER_ID'
result = (
service.spaces()
.members()
.create(
parent=NAME,
body={
'createTime': f'{datetime.datetime(2000, 1, 3).isoformat()}Z',
'deleteTime': f'{datetime.datetime(2000, 1, 4).isoformat()}Z',
'member': {'name': USER, 'type': 'HUMAN'},
},
)
.execute()
)
print(result)
Ersetzen Sie Folgendes:
EMAIL
: Die E-Mail-Adresse des Nutzerkontos, dessen Identität Sie mit domainweiter Autorisierung stehlen.SPACE_NAME
: Name des im Importmodus erstellten GruppenbereichsUSER_ID
: die eindeutige ID für den Nutzer.
Ressourcen in einen externen Gruppenbereich importieren
Sie können einen externen Gruppenbereich mit Importmodus nur mit Anmeldedaten von Nutzern innerhalb Ihrer Workspace-Organisation erstellen. Dies gilt nur, während sich der Gruppenbereich im Importmodus befindet. Sobald der Importmodus des Gruppenbereichs abgeschlossen ist, können externe Nutzer in die importierten Gruppenbereiche eingeladen werden (siehe Zugriffsbereich). Mit ihren Anmeldedaten kann die Chat API aufgerufen werden.
Importierte Ressourcen validieren
Ihre Chat-App kann den Inhalt eines Gruppenbereichs im Importmodus lesen und validieren, indem die Methode list
auf der Ressource Message
aufgerufen wird.
Sie können Reaction
- und Attachment
-Ressourcen aus den Feldern emojiReactionSummaries
und attachment
jeder zurückgegebenen Nachricht lesen. Chat-Apps können diese Methode nur im Namen eines Nutzers durch Identitätsdiebstahl aufrufen. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Ihre Chat-App kann auch einzelne Nachrichten zur Validierung lesen, indem die Methode get
auf der Message
-Ressource aufgerufen wird.
Chat-Apps können diese Methode nur aufrufen, um ihre eigenen Nachrichten zu lesen, und zwar mit ihrer eigenen Autorisierung. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Chat-Apps können auch bisherige Mitgliedschaften auflisten, indem sie die Methode list
auf der Ressource Membership
aufrufen.
Nachdem der Importmodus für den Gruppenbereich beendet wurde, macht die Methode list
keine historischen Mitgliedschaften mehr verfügbar. Chat-Apps können diese Methode nur im Namen eines Nutzers durch Identitätsdiebstahl aufrufen. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Sie können die Eigenschaften eines Gruppenbereichs im Importmodus lesen, indem Sie die Methode get
auf der Ressource Space
aufrufen.
Chat-Apps können diese Methode nur mit ihrer eigenen Autorisierung aufrufen.
Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Unterschiede zwischen importierten Ressourcen aus Quelldaten abgleichen
Wenn eine importierte Ressource aufgrund von Änderungen an der ursprünglichen Entität während des Imports nicht mehr mit der ursprünglichen Entität aus der Quellnachrichtenplattform übereinstimmt, können Chat-Apps die Chat API aufrufen, um die importierte Chatressource zu ändern. Wenn ein Nutzer beispielsweise eine Nachricht auf der Quellplattform für Nachrichten bearbeitet, nachdem sie in Chat erstellt wurde, können Chat-Apps die importierte Nachricht so aktualisieren, dass sie dem aktuellen Inhalt der ursprünglichen Nachricht entspricht.
Nachrichten
Wenn Sie unterstützte Felder in einer Nachricht in einem Gruppenbereich im Importmodus aktualisieren möchten, rufen Sie die Methode update
auf der Ressource Message
auf.
Chat-Apps können diese Methode nur mit derselben Autorisierung aufrufen, die bei der ursprünglichen Erstellung der Nachricht verwendet wurde. Wenn Sie bei der anfänglichen Nachrichtenerstellung die Nutzeridentität übernommen haben, müssen Sie denselben imitierten Nutzer verwenden, um die Nachricht zu aktualisieren.
Wenn Sie eine Nachricht in einem Gruppenbereich im Importmodus löschen möchten, rufen Sie die Methode delete
für die Ressource Message
auf.
Nachrichten in einem Gruppenbereich im Importmodus müssen nicht vom ursprünglichen Ersteller gelöscht werden. Sie können auch von einem Nutzer in der Domain gelöscht werden, der sich als eine andere Person ausgibt.
Chat-Apps können nur ihre eigenen Nachrichten löschen. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Reaktionen
Wenn Sie eine Reaktion auf eine Nachricht in einem Gruppenbereich im Importmodus löschen möchten, verwenden Sie die Methode delete
auf der reactions
-Ressource. Informationen zu den Ressourcenmethoden und Authentifizierungstypen, die in Gruppenbereichen im Importmodus unterstützt werden, finden Sie unter Chat-Apps autorisieren.
Anhänge
Wenn Sie Anhänge für eine Nachricht in einem Gruppenbereich im Importmodus aktualisieren möchten, verwenden Sie die Methode upload
für die media
-Ressource. Informationen zu den Ressourcenmethoden und -typen für die Authentifizierung in Gruppenbereichen im Importmodus finden Sie unter Chat-Apps autorisieren.
Bisherige Mitgliedschaften
Verwenden Sie zum Löschen einer früheren Mitgliedschaft in einem Bereich im Importmodus die Methode delete
für die Ressource Membership
. Nachdem der Importmodus für einen Gruppenbereich beendet wurde, können Sie mit der Methode delete
keine bisherigen Mitgliedschaften mehr löschen.
Sie können eine frühere Mitgliedschaft in einem Gruppenbereich im Importmodus nicht aktualisieren. Wenn Sie eine fälschlicherweise importierte frühere Mitgliedschaft korrigieren möchten, müssen Sie sie zuerst löschen und dann neu erstellen, solange sich der Gruppenbereich noch im Importmodus befindet.
Gruppenbereiche
Verwenden Sie zum Aktualisieren unterstützter Felder in einem Bereich im Importmodus die Methode patch
für die Ressource spaces
.
Wenn Sie einen Gruppenbereich im Importmodus löschen möchten, verwenden Sie die Methode delete
auf der spaces
-Ressource.
Informationen zu den Ressourcenmethoden und Authentifizierungstypen, die in Gruppenbereichen im Importmodus unterstützt werden, finden Sie unter Chat-Apps autorisieren.
Vollständiger Importmodus
Bevor Sie die Methode completeImport
aufrufen, sollten Sie die Validierung und die Abgleichung von Ressourcenabweichungen abgeschlossen haben. Das Beenden eines Bereichs außerhalb des Importmodus kann nicht rückgängig gemacht werden und wandelt den Bereich im Importmodus in einen regulären Bereich um. In Google Chat gibt es keinen Hinweis darauf, dass diese Gruppenbereiche einem Datenimport zugeordnet sind.
Notieren Sie sich das Datum und die Uhrzeit, zu der Sie completeImport
aufrufen, den Ressourcennamen des Nutzers, der den Aufruf getätigt hat, und die zurückgegebene Antwort. Das kann hilfreich sein, wenn Probleme auftreten und Sie sie untersuchen müssen.
Um den Importmodus abzuschließen und den Gruppenbereich für Nutzer zugänglich zu machen, kann die Chat-App die Methode completeImport
für die Ressource Space
aufrufen.
Chat-Apps können diese Methode nur im Namen eines Nutzers durch Identitätsübernahme aufrufen. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Der Nutzer, der sich als eine andere Person ausgibt, wird dem Gruppenbereich als Administrator hinzugefügt, sobald diese Methode abgeschlossen ist. Diese Methode muss innerhalb von 30 Tagen nach dem ersten Aufruf der create.space
-Methode aufgerufen werden. Wenn Sie versuchen, diese Methode nach Ablauf der 30 Tage aufzurufen, führt der Aufruf zu Fehlern, da der Bereich im Importmodus gelöscht wird und nicht mehr für die Chat-App zugänglich ist.
Der Nutzer, der in der completeImport
-Methode imitiert wird, muss nicht der Ersteller des Gruppenbereichs sein.
Das folgende Beispiel zeigt, wie Sie den Importmodus abschließen:
Python
"""Complete import."""
from google.oauth2 import service_account
from googleapiclient.discovery import build
# Specify required scopes.
SCOPES = [
'https://www.googleapis.com/auth/chat.import',
]
CREDENTIALS = (
service_account.Credentials.from_service_account_file('credentials.json')
.with_scopes(SCOPES)
.with_subject('EMAIL')
)
# Build a service endpoint for Chat API.
service = build('chat', 'v1', credentials=CREDENTIALS)
NAME = 'spaces/SPACE_NAME'
result = service.spaces().completeImport(name=NAME).execute()
print(result)
Ersetzen Sie Folgendes:
EMAIL
: Die E-Mail-Adresse des Nutzerkontos, dessen Identität Sie mit domainweiter Autorisierung stehlen.SPACE_NAME
: Name des im Importmodus erstellten Gruppenbereichs
Zugriff auf den Gruppenbereich nach dem Importmodus gewähren
Damit Chat-Nutzer Zugriff auf den kürzlich importierten Gruppenbereich erhalten, können Chat-Apps innerhalb von 30 Tagen nach dem ersten create.space()
-Methodenaufruf weiterhin den Umfang chat.import
und die Nutzeridentitätsdiebstahl-Funktion verwenden, um Folgendes zu tun:
- Dem Gruppenbereich Mitglieder hinzufügen: Rufen Sie die Methode
create()
für die RessourceMembership
auf. Wir empfehlen, dass Chat-Apps sofort nach Abschluss des GruppenbereichsimportsMembership
-Ressourcen erstellen, damit Chat-Apps denMembership
-Zugriffsbereich weiterhin verwenden können und alle importierten Mitglieder Zugriff auf den Gruppenbereich haben. - Zielgruppe festlegen: Rufen Sie die Methode
update()
für die RessourceSpace
auf. Informationen zum Erstellen und Hinzufügen von Zielgruppen finden Sie unter Einen Google Chat-Bereich für bestimmte Nutzer in einer Google Workspace-Organisation sichtbar machen.
Wenn Sie diese Methoden mit dem Umfang chat.import
verwenden möchten, muss der Nutzer, der sich ausgibt, Administrator des Gruppenbereichs sein.
Bei externen Gruppenbereichen können Sie mit der Mitgliedschaftsmethode create()
auch Nutzer außerhalb Ihrer Workspace-Organisation einladen. Informieren Sie sich über alle bekannten Einschränkungen für externe Nutzer.
Fehlerbehebung
Wenn beim Importieren von Chatbereichen ein Problem auftritt, lesen Sie die folgenden Hinweise zur Unterstützung. Wenn Sie eine Fehlermeldung erhalten, notieren Sie sich diese (kopieren Sie den Text in ein Dokument oder speichern Sie einen Screenshot), um sie später zur Fehlerbehebung zu verwenden.
Wenn ein Gruppenbereich erfolgreich importiert wurde, erhält CompleteImportSpace
den Status OK
.
Der Import wurde nicht vor Ablauf des 30-tägigen Zeitraums abgeschlossen.
Wie bereits im Abschnitt Gruppenbereich im Importmodus erstellen beschrieben, wird der Gruppenbereich nach 30 Tagen nach dem Aufruf der create-Methode automatisch gelöscht, wenn er sich noch im Importmodus befindet. Er ist dann nicht mehr zugänglich und kann nicht wiederhergestellt werden.
Der gelöschte Gruppenbereich ist leider nicht mehr verfügbar und kann nicht wiederhergestellt werden. Der Importvorgang muss noch einmal gestartet werden.
Fehlende Gruppenbereiche finden
Wenn Sie den neuen Chatbereich nicht finden können, sehen Sie sich die folgende Tabelle zu der Antwort an, die Sie von CompleteImportSpace
erhalten haben. Dort finden Sie die Erläuterung und mögliche Lösungen.
Antwort erhalten | Untersuchungsschritte | Erklärung | Auflösung |
---|---|---|---|
CompleteImportSpace löst eine Ausnahme aus und der Aufruf von GetSpace gibt PERMISSION_DENIED zurück. |
Sehen Sie in Ihren Daten nach, wann der Gruppenbereich erstellt wurde. Wenn er älter als 30 Tage ist, wurde er automatisch gelöscht. Außerdem wird der importierte Speicherplatz nicht im Tool zur Gruppenbereichsverwaltung oder im Audit-Log aufgezeichnet. | Der Importvorgang wurde vor mehr als 30 Tagen gestartet und die Migration des Gruppenbereichs konnte nicht abgeschlossen werden. | Erstellen Sie einen neuen Gruppenbereich und führen Sie den Importvorgang noch einmal aus. |
CompleteImportSpace gibt OK zurück und der Aufruf von GetSpace gibt PERMISSION_DENIED zurück. |
Im Tool zum Verwalten von Gruppenbereichen ist kein Eintrag für den importierten Gruppenbereich vorhanden. Im Audit-Log wird jedoch angezeigt, dass der Gruppenbereich gelöscht wurde. | Der Gruppenbereich wurde erfolgreich importiert, aber anschließend gelöscht. | Erstellen Sie einen neuen Gruppenbereich und führen Sie den Importvorgang noch einmal aus. |