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
- Nach dem Importmodus Zugriff auf den Gruppenbereich gewähren
- Fehlerbehebung
Vorbereitung
Apps Script
- 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.
- 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, einem Symbol und einer Beschreibung für Ihre Chat-App.
- Python 3.6 oder höher
- 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 ein und achten Sie darauf, wie sich die Nutzungslimits und Kontingente auf den Importvorgang auswirken können und welche Arten von Chatbereichen beim Importieren in einen neuen Bereich unterstützt werden.
Limits für die API-Nutzung überprüfen
Die für den Import von Daten in Google Chat erforderliche Zeit 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 wird 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
Wenn Sie einen Gruppenbereich im Importmodus erstellen möchten, rufen Sie die Methode create
für die Ressource Space
auf und setzen Sie importMode
auf true
.
Achten Sie beim Erstellen des Gruppenbereichs im Importmodus auf die folgenden Punkte.
- Datum und Uhrzeit: Der Importmodus muss innerhalb von 30 Tagen abgeschlossen werden. Wenn sich der Gruppenbereich nach 30 Tagen nach dem Aufruf der
spaces.create()
-Methode noch im Importmodus befindet, wird er automatisch gelöscht und kann nicht mehr aufgerufen oder wiederhergestellt werden.- 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. Dieser createTime
-Wert muss auf einen Wert zwischen dem 1. Januar 2000 und dem aktuellen Datum festgelegt sein.
Wenn Sie einen externen Gruppenbereich im Importmodus erstellen möchten, setzen Sie externalUserAllowed
auf true
.
Nachdem der Import abgeschlossen ist, 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, dessen Identität Sie mit domainweiter Autorisierung stehlen.DISPLAY_NAME
: Der Name des im Importmodus erstellten Gruppenbereichs. Dies muss ein eindeutiger Name für den Gruppenbereich sein, der Chatnutzern angezeigt wird. Es empfiehlt sich, denselben Anzeigenamen wie für den Bereich 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.
Rufen Sie zum Importieren einer Nachricht in einen Bereich im Importmodus die Methode create
für die Ressource Message
auf.
Um den Erstellungszeitpunkt der ursprünglichen Nachricht von der Quellplattform für Nachrichten beizubehalten, können Sie den 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
: 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 in Gruppenbereichen im Importmodus 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
Frühere Mitgliedschaften sind Mitgliedschaften, die für Nutzer erstellt wurden, die die ursprüngliche Gruppenbereichs-Instanz auf der Quell-Messaging-Plattform bereits verlassen hatten, deren Daten Sie aber in Google Chat behalten möchten. Informationen zum Hinzufügen neuer Mitglieder, nachdem der Gruppenbereich nicht mehr im Importmodus ist, finden Sie unter Mitgliedschaftsressource erstellen.
Wenn für diese ehemaligen Mitglieder eine Datenspeicherungsrichtlinie von Google gilt, sollten Sie die Daten (z. B. Nachrichten und Reaktionen), die von ehemaligen Mitgliedern in einem Gruppenbereich erstellt wurden, vor dem Importieren in Google Chat aufbewahren.
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. Außerdem muss dieser deleteTime
nach dem Zeitstempel der Gruppenbereichserstellung liegen und darf nicht in der Zukunft liegen.
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.
Im folgenden Beispiel wird gezeigt, wie Sie eine frühere Mitgliedschaft in einem Gruppenbereich 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. Das gilt nur, solange sich der Gruppenbereich im Importmodus befindet. Sobald der Importmodus für den Gruppenbereich abgeschlossen ist, können externe Nutzer eingeladen werden, den importierten Gruppenbereichen beizutreten (siehe Abschnitt zum Zugriff). Ihre Anmeldedaten können dann zum Aufrufen der Chat API verwendet 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.
Die Chat-App kann auch einzelne Nachrichten zur Überprüfung lesen, indem sie die Methode get
für die Ressource Message
aufruft.
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, werden mit der list
-Methode keine bisherigen Mitgliedschaften mehr angezeigt. 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 Attribute eines Importmodusbereichs lesen, indem Sie die Methode get
für die 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 von der Quell-Messaging-Plattform übereinstimmt, können Chat-Apps die Chat API aufrufen, um die importierte Chatressource zu ändern. Wenn ein Nutzer beispielsweise eine Nachricht in der Quell-Messaging-Plattform bearbeitet, nachdem sie in Google Chat erstellt wurde, können Chat-Apps die importierte Nachricht so aktualisieren, dass sie den aktuellen Inhalt der ursprünglichen Nachricht widerspiegelt.
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 beim Erstellen der Nachricht die Nutzeridentität verwendet haben, müssen Sie dieselbe Identität 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, wenn sie ihre eigene Zertifizierungsstelle verwenden. 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 Authentifizierungstypen, die in Gruppenbereichen im Importmodus unterstützt werden, 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
.
Verwenden Sie zum Löschen eines Importmodusbereichs die Methode delete
für die Ressource spaces
.
Informationen zu den Ressourcenmethoden und Authentifizierungstypen, die in Gruppenbereichen im Importmodus unterstützt werden, finden Sie unter Chat-Apps autorisieren.
Importmodus abschließen
Bevor Sie die Methode completeImport
aufrufen, sollten Sie prüfen, ob die Validierung und der Abgleich der Ressourcenunterschiede abgeschlossen sind. Wenn Sie den Importmodus für einen Gruppenbereich beenden, kann dies nicht rückgängig gemacht werden. Der Gruppenbereich wird in einen normalen Gruppenbereich umgewandelt. 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, schlägt der Aufruf fehl, da der Gruppenbereich im Importmodus gelöscht wird und nicht mehr für die Chat-App zugänglich ist.
Der imitierte Nutzer in der Methode completeImport
muss nicht der Ersteller des Gruppenbereichs sein.
Das folgende Beispiel zeigt, wie der Importmodus ausgeführt wird:
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
: der 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 Google Chat-Gruppenbereiche für bestimmte Nutzer in einer Google Workspace-Organisation sichtbar machen.
Um diese Methoden mit dem Bereich chat.import
verwenden zu können, muss der Nutzer, dessen Identität gestohlen wurde, ein 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 Gruppenbereichen Probleme auftreten, finden Sie in den folgenden Abschnitten Informationen zur Fehlerbehebung. 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 mit der Antwort an, die Sie von CompleteImportSpace
erhalten haben. Dort finden Sie eine Erklärung und eine Lösung für das Problem.
Antwort erhalten | Schritte zur Untersuchung | 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 ist der importierte Gruppenbereich weder im Tool zum Verwalten von Gruppenbereichen noch im Audit-Log aufgeführt. | 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. |