In diesem Leitfaden wird beschrieben, wie Sie mit der Methode create für die Ressource Section der Google Chat API einen neuen benutzerdefinierten Bereich in Google Chat erstellen.
Mit Bereichen können Nutzer ihre Unterhaltungen gruppieren und die Liste der Bereiche anpassen, die im Navigationsbereich von Google Chat angezeigt werden. Weitere Informationen finden Sie unter Abschnitte in Google Chat erstellen und organisieren.
Vorbereitung
Python
- Ein Google Workspace-Konto für Unternehmen mit Zugriff auf Google Chat.
- Umgebung einrichten:
- Google Cloud-Projekt erstellen
- OAuth-Zustimmungsbildschirm konfigurieren
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, einem Symbol und einer Beschreibung für Ihre Chat-App.
- Installieren Sie die Cloud-Clientbibliothek für Python.
-
OAuth-Client-ID-Anmeldedaten für eine Desktopanwendung erstellen Wenn Sie das Beispiel in dieser Anleitung ausführen möchten, speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
credentials.jsonin Ihrem lokalen Verzeichnis.
- Wählen Sie einen Autorisierungsbereich aus, der die Nutzerauthentifizierung unterstützt.
Abschnitte erstellen
Wenn Sie einen Bereich mit Nutzerauthentifizierung erstellen möchten, übergeben Sie Folgendes in Ihrer Anfrage:
- Geben Sie den
chat.users.sections-Autorisierungsbereich an. - Rufen Sie die Methode
CreateSectionauf. - Geben Sie im Anfragetext eine
Section-Ressource an:- Setzen Sie
displayNameauf einen Namen für den Abschnitt (maximal 80 Zeichen). - Setzen Sie
typeaufCUSTOM_SECTION.
- Setzen Sie
Im folgenden Beispiel wird ein Abschnitt erstellt:
Python
from google.cloud import chat_v1
def create_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.CreateSectionRequest(
parent="users/me",
section=chat_v1.Section(
display_name="SECTION_DISPLAY_NAME",
type=chat_v1.Section.SectionType.CUSTOM_SECTION
)
)
# Make the request
response = client.create_section(request=request)
print(response)
Wenn Sie dieses Beispiel ausführen möchten, ersetzen Sie Folgendes:
SECTION_DISPLAY_NAME: Der Name des neuen Abschnitts.
Die Chat API gibt eine Instanz von Section zurück, in der der erstellte Abschnitt beschrieben wird.
Weitere Informationen
- Abschnitt aktualisieren
- Abschnitt löschen
- Position eines Abschnitts ändern
- Abschnitte auflisten
- Gruppenbereiche in einem Abschnitt auflisten
- Bereich in einen anderen Abschnitt verschieben