Einen benannten Gruppenbereich in Google Chat erstellen (original) (raw)

In diesem Leitfaden wird beschrieben, wie Sie mit der Methode create() für die Ressource Space der Google Chat API einen benannten Gruppenbereich erstellen.

Ein benannter Gruppenbereich (in dem spaceType gleich SPACE ist) ist ein Ort, an dem Nutzer Nachrichten senden, Dateien teilen und zusammenarbeiten können. Benannte Gruppenbereiche können Chat-Apps enthalten. Benannte Gruppenbereiche haben Administratoren, die Verwaltungseinstellungen und Beschreibungen anwenden sowie Personen und Apps hinzufügen oder entfernen können.

Wenn Sie verschiedene Arten von Google Chat-Gruppenbereichen erstellen möchten, z. B. Direktnachrichten oder Gruppennachrichten, verwenden Sie die Methode setUp() für die Ressource Space, um den Gruppenbereich zu erstellen und gleichzeitig Mitglieder hinzuzufügen. Weitere Informationen finden Sie unter Projektbereich einrichten.

Nachdem Sie einen benannten Gruppenbereich erstellt haben, ist das einzige Mitglied des Gruppenbereichs der authentifizierte Nutzer. Wenn Sie dem Gruppenbereich Mitglieder hinzufügen möchten, rufen Sie die Methode create() für die Ressource Membership für jede Person oder App auf, die Sie hinzufügen möchten. Alternativ können Sie mit der Methode setUp() einen benannten Gruppenbereich erstellen und gleichzeitig Mitglieder hinzufügen.

Vorbereitung

Node.js

Python

Java

Apps Script

Benannten Space als Nutzer erstellen

Wenn Sie einen benannten Bereich mit Nutzerauthentifizierung erstellen möchten, übergeben Sie Folgendes in Ihrer Anfrage:

So erstellen Sie einen benannten Bereich:

Node.js

Python

Java

Apps Script

Benannten Bereich als Chat-App erstellen

Für die App-Authentifizierung ist eine einmalige Administratorgenehmigung erforderlich.

Wenn Sie einen Nutzer in einen Bereich mit App-Authentifizierung einladen oder hinzufügen möchten, übergeben Sie Folgendes in Ihrer Anfrage:

Skript schreiben, das die Chat API aufruft

So erstellen Sie einen benannten Bereich:

Python

  1. Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen chat_space_create_named_app.py.
  2. Fügen Sie den folgenden Code in chat_space_create_named_app.py ein:
from google.oauth2 import service_account  
from apiclient.discovery import build  
# Define your app's authorization scopes.  
# When modifying these scopes, delete the file token.json, if it exists.  
SCOPES = ["https://www.googleapis.com/auth/chat.app.spaces.create"]  
def main():  
    '''  
    Authenticates with Chat API using app authentication,  
    then creates a Chat space.  
    '''  
    # Specify service account details.  
    creds = (  
        service_account.Credentials.from_service_account_file('credentials.json')  
        .with_scopes(SCOPES)  
    )  
    # Build a service endpoint for Chat API.  
    chat = build('chat', 'v1', credentials=creds)  
    # Use the service endpoint to call Chat API.  
    result = chat.spaces().create(  
      # Details about the space to create.  
      body = {  
        # To create a named space, set spaceType to SPACE.  
        'spaceType': 'SPACE',  
        # The user-visible name of the space.  
        'displayName': 'API-made',  
        # The customer ID of the Workspace domain.  
        'customer': 'CUSTOMER'  
      }  
      ).execute()  
    # Prints details about the created space.  
    print(result)  
if __name__ == '__main__':  
    main()
  1. Ersetzen Sie im Code Folgendes:
    • CUSTOMER: Die Kunden-ID der Domain des Bereichs im Format customer/{customer}, wobei {customer} die ID aus der Admin SDK-Kundenressource ist. Wenn Sie einen Gruppenbereich in derselben Google Workspace-Organisation wie die Chat-App erstellen möchten, verwenden Sie customers/my_customer.
  2. Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:
python3 chat_space_create_named_app.py

Projektbereich in Google Chat öffnen

Um zum Gruppenbereich zu gelangen, verwenden Sie die Ressourcen-ID des Gruppenbereichs, um die URL des Gruppenbereichs zu erstellen. Sie finden die Ressourcen-ID des Bereichs name im Antworttext von Google Chat. Wenn der name Ihres Gruppenbereichs beispielsweise spaces/1234567 ist, können Sie über die folgende URL auf den Gruppenbereich zugreifen: https://mail.google.com/chat/u/0/#chat/space/1234567.

Einschränkungen und Überlegungen