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 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
- 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, 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. Wenn Sie Administrator sind, lesen Sie den Hilfeartikel Nachrichtendaten aus einem anderen Dienst in Google Chat importieren und folgen Sie der Anleitung.
Limits für die API-Nutzung überprüfen
Die Zeit, die für den Import von Daten in Google Chat benötigt wird, kann je nach Anzahl der zu importierenden Chatressourcen 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
.
Beachten Sie beim Erstellen des Gruppenbereichs im Importmodus Folgendes:
- Datum und Uhrzeit: Denken Sie daran, dass der Importmodus innerhalb von 90 Tagen abgeschlossen werden muss. Wenn sich der Gruppenbereich nach 90 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
importModeExpireTime
, um den Ablauf des 90-tägigen Zeitraums zu verfolgen. - Verwenden Sie den Wert des Felds
createTime
nicht, um das Ablaufen des 90-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. Auf sie 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
.
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, 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. 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. Dieser createTime
-Wert muss zwischen der von Ihnen zuvor festgelegten Zeit der Gruppenbereichserstellung und der aktuellen Zeit liegen.
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, 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 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 Gruppenbereichen im Importmodus zu verknüpfen, um Anhänge von anderen Messaging-Plattformen zu importieren und das interne Limit für den Anhängeupload in Google Chat zu vermeiden.
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, in vielen Fällen aufbewahren, bevor Sie sie in Google Chat importieren.
Solange sich der Gruppenbereich im Importmodus befindet, können Sie diese bisherigen Mitgliedschaften mithilfe der Methode create
auf der 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 den ursprünglichen Beitrittszeitpunkt 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. Falls festgelegt, muss createTime
vor deleteTime
liegen und muss am oder nach dem Datum der Gruppenbereichserstellung liegen. Diese createTime
Informationen werden nicht zur Bestimmung der Datenaufbewahrung verwendet und 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.
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, 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 Eigenschaften eines Gruppenbereichs im Importmodus lesen, indem Sie die Methode get
auf der Ressource Space
aufrufen. In der Antwort wird auch importModeExpireTime
ausgefüllt, damit Sie den Zeitrahmen für den Abschluss des Importvorgangs im Blick behalten können.
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
für die 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 mit ihrer eigenen Autorisierung 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 Authentifizierungstypen, die in Gruppenbereichen im Importmodus unterstützt werden, finden Sie unter Chat-Apps autorisieren.
Bisherige Mitgliedschaften
Wenn Sie eine frühere Mitgliedschaft in einem Gruppenbereich im Importmodus löschen möchten, verwenden Sie 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
Wenn Sie unterstützte Felder in einem Gruppenbereich im Importmodus aktualisieren möchten, verwenden Sie die Methode patch
auf der spaces
-Ressource.
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. 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ätsdiebstahl 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 90 Tagen nach dem ersten Aufruf der create.space
-Methode aufgerufen werden. Wenn Sie versuchen, diese Methode nach Ablauf der 90 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 Nutzer, der in der completeImport
-Methode imitiert wird, muss nicht der Ersteller des Gruppenbereichs sein.
Rufe completeImport
nicht zu nah am Ablaufdatum 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.importModeExpireTime
Wir empfehlen, mindestens 30 Minuten vor importModeExpireTime
completeImport
anzurufen.
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 90 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.chat.import
Sie sollten vorrangig Mitglieder hinzufügen, die der Vault-Hold-Richtlinie unterliegen. Dadurch können importierte Nachrichten auch dann aufbewahrt werden, wenn die Aufbewahrungsdauer abgelaufen ist. - 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.
Wenn Sie diese Methoden mit dem Umfang chat.import
verwenden möchten, muss der Nutzer, für den Sie sich ausgeben, 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 90-tägigen Zeitraums abgeschlossen.
Wie bereits im Abschnitt Gruppenbereich im Importmodus erstellen beschrieben, wird der Gruppenbereich nach 90 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 in der folgenden Tabelle die 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 90 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 90 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. |