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 Gruppenbereichsentitäten von Ihren anderen Messaging-Plattformen in die entsprechenden Chat API-Ressourcen importieren. Sie können diese Daten importieren, indem Sie Chat-Gruppenbereiche im Importmodus erstellen und Daten in diese Gruppenbereiche importieren. Nach Abschluss des Vorgangs werden diese Gruppenbereiche 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
- Importierte Ressourcendifferenzen mit 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 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.
- Erstellen Sie ein eigenständiges Apps Script-Projekt und aktivieren Sie den Advanced Chat Service.
- Der Chat-App muss in allen Domains, in die die App Inhalte importiert, die domainweite Autorisierung delegiert werden. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Python
- Ein Google Workspace-Konto für Unternehmen 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
- Das Paketverwaltungstool pip
- Der Chat-App muss in allen Domains, in die die App Inhalte importiert, die domainweite Autorisierung delegiert werden. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Import planen
Planen Sie entsprechend, wie viele Daten importiert werden sollen, und informieren Sie sich darüber, wie sich die Nutzungslimits und Kontingente auf den Importvorgang auswirken können. Außerdem sollten Sie wissen, welche Arten von Chatbereichen beim Importieren in einen neuen Bereich unterstützt werden. Wenn Sie Administrator sind, lesen Sie den Hilfeartikel Nachrichtendaten aus einem anderen Dienst in Google Chat importieren und folgen Sie der Anleitung sorgfältig.
Limits für die API-Nutzung prüfen
Die Zeit, die für den Import von Daten in 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 aus der Quell-Messaging-Plattform importiert werden sollen, um einen geschätzten Zeitplan zu erstellen.
Wenn Sie Nachrichten in einen Bereich importieren, empfehlen wir, die Aufrufe der Methode messages.create()
auf verschiedene Nachrichten-Threads zu verteilen.
Unterstützte Bereiche für den Import identifizieren
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
Wenn Sie einen Bereich im Importmodus erstellen möchten, rufen Sie die Methode create
für die Ressource Space
auf und legen Sie importMode
auf true
fest.
Beachten Sie beim Erstellen des Bereichs im Importmodus Folgendes:
- Datum und Uhrzeit: Der Importmodus muss innerhalb von 90 Tagen abgeschlossen werden. Wenn sich der Bereich nach 90 Tagen ab dem Zeitpunkt, zu dem die
spaces.create()
-Methode aufgerufen wurde, immer noch im Importmodus befindet, wird er automatisch gelöscht und ist dann nicht mehr zugänglich und kann nicht wiederhergestellt werden.- Verwenden Sie den Wert des Felds
importModeExpireTime
, um den Ablauf des 90‑Tage-Zeitraums zu verfolgen. - Verwenden Sie den Wert des Felds
createTime
nicht, um den Ablauf des 90‑Tage-Zeitraums zu verfolgen. Das ist nicht immer dasselbe wie beim Aufrufen derspaces.create()
-Methode. Wenn Sie den Importmodus verwenden, kann das FeldcreateTime
auf den historischen Zeitstempel gesetzt werden, zu dem der Bereich in der Quelle erstellt wurde, um die ursprüngliche Erstellungszeit beizubehalten.
- Verwenden Sie den Wert des Felds
- Der Ressourcenname des Gruppenbereichs (
name
): Die eindeutige Kennung, die verwendet wird, um Informationen zum jeweiligen Gruppenbereich abzurufen. Sie wird in späteren Schritten beim Importieren von Inhalten in den Gruppenbereich referenziert.
Wenn Sie den Erstellungszeitpunkt der entsprechenden Space-Einheit aus der Quell-Messaging-Plattform beibehalten möchten, können Sie den createTime
des Space festlegen. createTime
muss auf einen Wert zwischen dem 1. Januar 2000 und dem aktuellen Datum festgelegt werden.
Wenn Sie einen externen Bereich im Importmodus erstellen möchten, legen Sie externalUserAllowed
auf true
fest.
Nachdem der Import abgeschlossen ist, können Sie externe Nutzer hinzufügen.
Das folgende Beispiel zeigt, wie Sie einen Bereich 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 Autorisierung imitieren.DISPLAY_NAME
: Der Name des im Importmodus erstellten Bereichs. Dies muss ein eindeutiger Name für den Bereich sein, der Chat-Nutzern angezeigt wird. Wir empfehlen, 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 für den Importmodus. Wenn Sie eine Ressource im Bereich erstellen, geben Sie Daten aus der zugehörigen Ressource der Messaging-Plattform an, von der Sie migrieren.
Nachrichten
Ihre Chat-Apps können Nachrichten mit ihrer eigenen Berechtigung oder im Namen eines Nutzers durch Identitätswechsel importieren. Der Autor der Nachricht ist das imitierte Nutzerkonto. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Wenn Sie eine Nachricht in einen Importmodusbereich importieren möchten, rufen Sie die Methode create
für die Ressource Message
auf.
Um die Erstellungszeit der ursprünglichen Nachricht aus der Quell-Messaging-Plattform beizubehalten, können Sie die createTime
der Nachricht festlegen. createTime
muss auf einen Wert zwischen der von Ihnen zuvor festgelegten Erstellungszeit des Bereichs und der aktuellen Zeit festgelegt werden.
Nachrichten im selben Gruppenbereich dürfen nicht dieselbe createTime
enthalten, auch wenn vorherige Nachrichten mit dieser Zeit gelöscht wurden.
Bei Nachrichten mit Drittanbieter-URLs in Gruppenbereichen im Importmodus können keine Linkvorschauen in Google Chat gerendert werden.
Wenn Sie die Nachrichten im Importmodus erstellen, werden Nutzer in Gruppenbereichen nicht benachrichtigt und erhalten keine E-Mails, auch wenn die Nachrichten Nutzererwähnungen enthalten.
Das folgende Beispiel zeigt, wie Sie eine Nachricht in einem Importmodusbereich erstellen:
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, das Sie mit domainweiter Autorisierung imitieren.SPACE_NAME
: Der Name des im Importmodus erstellten Bereichs.
Reaktionen
Ihre Chat-App kann mit der Chat API Reaktionen auf Nachrichten importieren. Informationen zu den Ressourcenmethoden und den Arten der Authentifizierungsunterstützung in Gruppenbereichen im Importmodus finden Sie unter Chat-Apps autorisieren.
Anhänge
Ihre Chat-App kann mit der Chat API Anhänge hochladen. Informationen zu den Ressourcenmethoden und den Arten der Authentifizierungsunterstützung in Gruppenbereichen im Importmodus finden Sie unter Chat-Apps autorisieren. Wir empfehlen 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 Importmodusbereichen zu verknüpfen, um Anhänge von anderen Messaging-Plattformen zu importieren und das interne Limit von Google Chat für den Upload von Anhängen zu vermeiden.
Bisherige Mitgliedschaften
Verlauf der Mitgliedschaften: Mitgliedschaften, die für Nutzer erstellt wurden, die die ursprüngliche Bereichsentität auf der Quellplattform für Messaging bereits verlassen haben, deren Daten Sie aber in Chat behalten möchten. Informationen zum Hinzufügen neuer Mitglieder, nachdem der Gruppenbereich nicht mehr im Importmodus ist, finden Sie unter Mitgliedschaftsressource erstellen.
In vielen Fällen unterliegen diese ehemaligen Mitglieder einer Richtlinie zur Datenspeicherung bei Google. Daher sollten Sie die Daten (z. B. Nachrichten und Reaktionen), die durch ehemalige Mitgliedschaften in einem Gruppenbereich erstellt wurden, beibehalten, bevor Sie sie in Chat importieren.
Während sich der Bereich im Importmodus befindet, können Sie diese bisherigen Mitgliedschaften in den Bereich importieren. Verwenden Sie dazu die Methode create
Membership
.
Damit die verbleibende Zeit der bisherigen Mitgliedschaft beibehalten wird, musst du die deleteTime
der Mitgliedschaft festlegen. Diese Zeit muss korrekt sein, da sie sich darauf auswirkt, welche Daten für diese Mitgliedschaften aufbewahrt werden. Außerdem muss dieser deleteTime
nach dem Zeitstempel für die Erstellung des Bereichs liegen und darf kein zukünftiger Zeitstempel sein.
Zusätzlich zu deleteTime
können Sie auch createTime
festlegen, um die ursprüngliche Beitrittszeit der Mitgliedschaft beizubehalten. Im Gegensatz zu deleteTime
ist createTime
optional. Wenn der Wert nicht festgelegt ist, wird createTime
automatisch berechnet, indem 1 Mikrosekunde von deleteTime
subtrahiert wird. Falls festgelegt, muss createTime
vor deleteTime
liegen und nach oder zum Zeitpunkt der Erstellung des Bereichs sein. Diese createTime
-Informationen werden nicht zur Bestimmung der Datenaufbewahrung verwendet und sind nicht in Verwaltungstools wie der Google Admin-Konsole und Google Vault sichtbar.
Es gibt möglicherweise mehrere Möglichkeiten, wie ein Nutzer einem Bereich auf der Quellplattform für Messaging beitreten und ihn verlassen kann (durch Einladungen, durch selbstständiges Beitreten, durch Hinzufügen durch einen anderen Nutzer). In Chat werden diese Aktionen jedoch alle durch die Felder createTime
und deleteTime
für die Mitgliedschaft im Zeitverlauf als hinzugefügt oder entfernt dargestellt.
Das folgende Beispiel zeigt, wie Sie eine Mitgliedschaft aus der Vergangenheit 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, das Sie mit domainweiter Autorisierung imitieren.SPACE_NAME
: Der Name des im Importmodus erstellten Bereichs.USER_ID
: die eindeutige ID für den Nutzer.
Ressourcen in einem externen Gruppenbereich importieren
Sie können einen externen Bereich im Importmodus nur mit Anmeldedaten von Nutzern innerhalb Ihrer Workspace-Organisation erstellen. Das gilt nur, wenn sich der Gruppenbereich im Importmodus befindet. Sobald der Gruppenbereich den Importmodus abgeschlossen hat, können externe Nutzer eingeladen werden, den importierten Gruppenbereichen beizutreten (siehe Abschnitt „Zugriff“). Ihre Anmeldedaten können verwendet werden, um die Chat API aufzurufen.
Importierte Ressourcen validieren
Ihre Chat-App kann den Inhalt eines Gruppenbereichs im Importmodus lesen und validieren, indem sie die Methode list
für die Ressource Message
aufruft.
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 über die Identitätsübernahme aufrufen. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Ihre Chat-App kann auch einzelne Nachrichten zur Validierung lesen, indem sie die Methode get
Message
aufruft.
Chat-Apps können diese Methode nur aufrufen, um ihre eigenen Nachrichten mit ihrer eigenen Berechtigung zu lesen. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Chat-Apps können auch frühere Mitgliedschaften auflisten, indem sie die Methode list
für die Ressource Membership
aufrufen.
Nachdem der Bereich den Importmodus verlassen hat, werden mit der Methode list
keine früheren Mitgliedschaften mehr angezeigt. Chat-Apps können diese Methode nur im Namen eines Nutzers über die Identitätsübernahme aufrufen. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Sie können die Attribute eines Importmodusbereichs lesen, indem Sie die Methode get
Space
aufrufen. Die Antwort enthält auch importModeExpireTime
, damit Sie den Zeitraum für den Importvorgang richtig nachvollziehen können.
Chat-Apps können diese Methode nur mit ihrer eigenen Berechtigung aufrufen.
Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Importierte Ressourcendifferenzen mit Quelldaten abstimmen
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 der Quell-Messaging-Plattform übereinstimmt, können Chatanwendungen die Chat API aufrufen, um die importierte Chatressource zu ändern. Wenn ein Nutzer beispielsweise eine Nachricht auf der Quellplattform bearbeitet, nachdem sie in Chat erstellt wurde, können Chat-Apps die importierte Nachricht aktualisieren, sodass sie den aktuellen Inhalt der ursprünglichen Nachricht widerspiegelt.
Nachrichten
Wenn Sie unterstützte Felder für eine Nachricht in einem Importmodusbereich aktualisieren möchten, rufen Sie die Methode update
für die Ressource Message
auf.
Chat-Apps können diese Methode nur mit derselben Autorität aufrufen, die bei der Erstellung der ursprünglichen Nachricht verwendet wurde. Wenn Sie bei der ursprünglichen Nachrichtenerstellung die Nutzeridentitätsübernahme verwendet haben, müssen Sie denselben übernommenen Nutzer verwenden, um die Nachricht zu aktualisieren.
Wenn Sie eine Nachricht in einem Bereich 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 der Nachricht gelöscht werden, sondern können durch die Identitätsübernahme eines beliebigen Nutzers in der Domain gelöscht werden.
Chat-Apps können nur ihre eigenen Nachrichten löschen. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Reaktionen
Wenn Sie eine Reaktion für eine Nachricht in einem Importmodusbereich löschen möchten, verwenden Sie die delete
-Methode für die reactions
-Ressource. Informationen zu den Ressourcenmethoden und den Arten der Authentifizierungsunterstützung in Gruppenbereichen im Importmodus finden Sie unter Chat-Apps autorisieren.
Anhänge
Wenn Sie Anhänge für eine Nachricht in einem Importmodusbereich aktualisieren möchten, verwenden Sie die Methode upload
für die media
-Ressource. Informationen zu den Ressourcenmethoden und den Arten der Authentifizierung, die in Gruppenbereichen im Importmodus unterstützt werden, finden Sie unter Chat-Apps autorisieren.
Bisherige Mitgliedschaften
Wenn Sie eine frühere Mitgliedschaft in einem Bereich im Importmodus löschen möchten, verwenden Sie die Methode delete
für die Ressource Membership
. Nachdem ein Bereich den Importmodus verlassen hat, können Sie mit der Methode delete
keine alten Mitgliedschaften mehr löschen.
Sie können eine frühere Mitgliedschaft in einem Gruppenbereich im Importmodus nicht aktualisieren. Wenn du eine falsch importierte Mitgliedschaft korrigieren möchtest, musst du sie zuerst löschen und dann neu erstellen, während sich der Bereich noch im Importmodus befindet.
Gruppenbereiche
Verwenden Sie die Methode patch
für die spaces
-Ressource, um unterstützte Felder in einem Importmodusbereich zu aktualisieren.
Wenn Sie einen Arbeitsbereich im Importmodus löschen möchten, verwenden Sie die Methode delete
für die spaces
-Ressource.
Informationen zu den Ressourcenmethoden und den Arten der Authentifizierungsunterstützung in Importmodusbereichen finden Sie unter Chat-Apps autorisieren.
Vollständiger Importmodus
Bevor Sie die Methode completeImport
aufrufen, sollten Sie sicherstellen, dass die Validierung und der Abgleich von Ressourcendifferenzen abgeschlossen sind. Das Beenden des Importmodus für einen Gruppenbereich kann nicht rückgängig gemacht werden. Der Gruppenbereich im Importmodus wird dann in einen regulären Gruppenbereich umgewandelt. In Chat gibt es keinen Hinweis darauf, dass diese Bereiche auf einen Datenimport zurückzuführen sind.
Notieren Sie sich das Datum und die Uhrzeit, zu der Sie completeImport
aufrufen, den Ressourcennamen des Nutzers, der den Aufruf vorgenommen hat, und die zurückgegebene Antwort. Das kann hilfreich sein, wenn Probleme auftreten und Sie diese untersuchen müssen.
Damit der Importmodus abgeschlossen und der Gruppenbereich für Nutzer zugänglich gemacht wird, kann die Chat-App die Methode completeImport
für die Ressource Space
aufrufen.
Chat-Apps können diese Methode nur im Namen eines Nutzers über die Identitätsübernahme aufrufen. Weitere Informationen finden Sie unter Chat-Apps autorisieren.
Der imitierte Nutzer wird dem Gruppenbereich als Administrator des Gruppenbereichs hinzugefügt, sobald diese Methode abgeschlossen ist. Diese Methode muss innerhalb von 90 Tagen nach dem ersten Aufruf der Methode create.space
aufgerufen werden. Wenn Sie versuchen, diese Methode nach Ablauf des 90‑Tage-Zeitraums aufzurufen, schlägt der Aufruf fehl, da der Importmodusbereich gelöscht wurde 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 Bereichs sein.
Rufen Sie completeImport
nicht zu kurz vor importModeExpireTime
auf, da wir nicht garantieren können, dass die Anfrage vor importModeExpireTime
eingeht. Außerdem kann es zu Konflikten mit der Datenverarbeitung in Systemen kommen, die zum Ablaufzeitpunkt ausgelöst werden.
Wir empfehlen, completeImport
mindestens 30 Minuten vor importModeExpireTime
anzurufen.
Das folgende Beispiel zeigt, wie der Importmodus abgeschlossen 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, das Sie mit domainweiter Autorisierung imitieren.SPACE_NAME
: Der Name des im Importmodus erstellten Bereichs.
Zugriff auf den Gruppenbereich nach dem Importmodus gewähren
Damit Chat-Nutzer auf den kürzlich importierten Gruppenbereich zugreifen können, dürfen Chat-Apps innerhalb von 90 Tagen nach dem ersten create.space()
-Methodenaufruf weiterhin den chat.import
-Bereich und die Nutzeridentitätsübernahme verwenden, um Folgendes zu tun:
- Mitglieder dem Gruppenbereich hinzufügen: Rufen Sie die
create()
-Methode für dieMembership
-Ressource auf. Wir empfehlen, dass Chat-AppsMembership
-Ressourcen sofort nach Abschluss des Gruppenbereich-Imports erstellen, damit Chat-Apps weiterhin denchat.import
-Bereich verwenden können und alle importierten Mitglieder Zugriff auf den Gruppenbereich haben. Sie sollten vorrangig Mitglieder hinzufügen, die der Vault-Hold-Richtlinie unterliegen, da importierte Nachrichten dadurch auch dann aufbewahrt werden können, wenn sie nicht mehr unter die Aufbewahrungsrichtlinie fallen. - Zielgruppe festlegen: Rufen Sie die
update()
-Methode für die RessourceSpace
auf. Informationen zum Erstellen und Hinzufügen von Zielgruppen
Wenn Sie diese Methoden mit dem Bereich chat.import
verwenden möchten, muss der imitierte Nutzer ein Bereichsmanager sein.
Bei externen Projektbereichen können Nutzer außerhalb Ihrer Workspace-Organisation auch über die create()
-Methode eingeladen werden. Machen Sie sich mit allen bekannten Einschränkungen für externe Nutzer vertraut.
Fehlerbehebung
Wenn beim Importieren von Chatbereichen Probleme auftreten, finden Sie unten Informationen zur Fehlerbehebung. Wenn Sie eine Fehlermeldung erhalten, notieren Sie sie (kopieren Sie den Text in ein Dokument oder speichern Sie einen Screenshot) zur späteren Referenz und Fehlerbehebung.
Wenn ein Bereich erfolgreich importiert wurde, wird CompleteImportSpace
mit dem Status OK
abgeschlossen.
Der Import wurde nicht abgeschlossen, bevor das 90‑Tage-Zeitfenster abgelaufen ist.
Wie bereits unter Gruppenbereich im Importmodus erstellen beschrieben, wird ein Gruppenbereich, der 90 Tage nach dem Aufruf der Methode „create“ immer noch im Importmodus ist, automatisch gelöscht und ist dann nicht mehr zugänglich und kann nicht wiederhergestellt werden.
Leider ist der gelöschte Gruppenbereich nicht mehr verfügbar und kann nicht wiederhergestellt werden. Der Importvorgang muss noch einmal gestartet werden.
Wenn der Bereich nicht importiert wurde, weil zu viele Daten innerhalb des 90‑Tage-Zeitraums mit den aktuellen Nutzungslimits importiert werden müssen, teilen Sie den Bereich zu Archivierungszwecken in zwei oder mehr kleinere Bereiche auf und starten Sie den Importvorgang noch einmal.
Fehlende Gruppenbereiche finden
Wenn Sie den neuen Chatbereich nicht finden können, sehen Sie in der folgenden Tabelle nach, welche Antwort Sie von CompleteImportSpace
erhalten haben. Dort finden Sie eine Erklärung und Informationen zur Fehlerbehebung.
Antwort erhalten | Untersuchungsschritte | Erklärung | Auflösung |
---|---|---|---|
CompleteImportSpace löst eine Ausnahme aus und der Aufruf von GetSpace gibt PERMISSION_DENIED zurück. |
Prüfen Sie, wann der Bereich erstellt wurde. Wenn er älter als 90 Tage ist, wurde er automatisch gelöscht. Außerdem ist der importierte Gruppenbereich nicht im Tool zur Verwaltung von Gruppenbereichen oder im Audit-Log aufgeführt. | Der Importvorgang wurde vor mehr als 90 Tagen gestartet und der Bereich konnte die Migration nicht erfolgreich beenden. | Erstellen Sie einen neuen Space und führen Sie den Importvorgang noch einmal aus. |
CompleteImportSpace gibt OK zurück und der Aufruf von
GetSpace gibt PERMISSION_DENIED zurück. |
Der importierte Bereich ist nicht im Tool zur Bereichsverwaltung zu finden, aber im Audit-Log wird angezeigt, dass der Bereich gelöscht wurde. | Der Gruppenbereich wurde erfolgreich importiert, aber anschließend gelöscht. | Erstellen Sie einen neuen Space und führen Sie den Importvorgang noch einmal aus. |